Tutorial
Cómo integrar una IA con memoria en WhatsApp Business
AgentXIA · 24 de marzo, 2026 · 12 min de lectura
WhatsApp Business tiene 200 millones de usuarios empresariales. Si tus clientes ya están en WhatsApp, tiene sentido poner tu IA ahí. En esta guía te muestro cómo conectar una Persona AgentXIA con WhatsApp Business API para tener un agente con memoria respondiendo mensajes de forma autónoma.
Arquitectura de la integración
El flujo completo es:
- Cliente envía mensaje a tu número WhatsApp Business
- Meta WhatsApp Cloud API → envía webhook a tu servidor
- Tu servidor → llama AgentXIA API con el mensaje + user_id del cliente
- AgentXIA → recupera memoria del cliente, genera respuesta con la Persona configurada
- Tu servidor → envía la respuesta de vuelta a WhatsApp
Paso 1: Configurar WhatsApp Business Cloud API
- Crear cuenta en Meta for Developers (developers.facebook.com)
- Crear una App de tipo "Business"
- Agregar el producto "WhatsApp"
- Obtener un número de prueba (Meta proporciona uno gratis) o vincular tu número
- Generar Access Token permanente en Settings → System Users
Variables que necesitarás: WHATSAPP_TOKEN, PHONE_NUMBER_ID, VERIFY_TOKEN (lo defines tú para el webhook)
Paso 2: Crear tu Persona en AgentXIA
Desde el dashboard de AgentXIA, crea una Persona con:
- Nombre e instrucciones de sistema (tono, restricciones)
- Base de conocimiento (sube PDFs, URLs de tu web, FAQs)
- Capacidades: solo responder, o también ejecutar acciones
Obtén tu AGENTXIA_API_KEY y el PERSONA_ID desde la sección API del dashboard.
Paso 3: Servidor webhook (Node.js)
// webhook.js — Conecta WhatsApp ↔ AgentXIA
const express = require('express');
const app = express();
app.use(express.json());
// Verificación del webhook con Meta
app.get('/webhook', (req, res) => {
const {'hub.challenge': challenge, 'hub.verify_token': token} = req.query;
if (token === process.env.VERIFY_TOKEN) res.send(challenge);
else res.sendStatus(403);
});
// Recibir mensajes de WhatsApp
app.post('/webhook', async (req, res) => {
const message = req.body.entry?.[0]?.changes?.[0]?.value?.messages?.[0];
if (!message || message.type !== 'text') return res.sendStatus(200);
const userPhone = message.from; // Usado como user_id
const text = message.text.body;
// Llamar AgentXIA
const agentResponse = await fetch('https://gateway.agentxia.org/chat', {
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.AGENTXIA_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ persona_id: process.env.PERSONA_ID, user_id: userPhone, message: text })
});
const { reply } = await agentResponse.json();
// Enviar respuesta a WhatsApp
await sendWhatsAppMessage(userPhone, reply);
res.sendStatus(200);
});
async function sendWhatsAppMessage(to, text) {
await fetch(`https://graph.facebook.com/v19.0/${process.env.PHONE_NUMBER_ID}/messages`, {
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.WHATSAPP_TOKEN}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ messaging_product: 'whatsapp', to, type: 'text', text: { body: text } })
});
}
app.listen(3000);
const express = require('express');
const app = express();
app.use(express.json());
// Verificación del webhook con Meta
app.get('/webhook', (req, res) => {
const {'hub.challenge': challenge, 'hub.verify_token': token} = req.query;
if (token === process.env.VERIFY_TOKEN) res.send(challenge);
else res.sendStatus(403);
});
// Recibir mensajes de WhatsApp
app.post('/webhook', async (req, res) => {
const message = req.body.entry?.[0]?.changes?.[0]?.value?.messages?.[0];
if (!message || message.type !== 'text') return res.sendStatus(200);
const userPhone = message.from; // Usado como user_id
const text = message.text.body;
// Llamar AgentXIA
const agentResponse = await fetch('https://gateway.agentxia.org/chat', {
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.AGENTXIA_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ persona_id: process.env.PERSONA_ID, user_id: userPhone, message: text })
});
const { reply } = await agentResponse.json();
// Enviar respuesta a WhatsApp
await sendWhatsAppMessage(userPhone, reply);
res.sendStatus(200);
});
async function sendWhatsAppMessage(to, text) {
await fetch(`https://graph.facebook.com/v19.0/${process.env.PHONE_NUMBER_ID}/messages`, {
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.WHATSAPP_TOKEN}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ messaging_product: 'whatsapp', to, type: 'text', text: { body: text } })
});
}
app.listen(3000);
Paso 4: Deploy del webhook
El webhook necesita HTTPS público. Opciones:
- Cloudflare Workers: Ideal para producción. Gratis hasta 100K requests/día.
- Railway / Render: Para Node.js servers. Plan gratis disponible.
- ngrok: Solo para desarrollo/testing local.
Recomendamos Cloudflare Workers por latencia mínima, escalabilidad automática y costo cero en la mayoría de casos de uso.
Paso 5: Registrar el webhook en Meta
- En Meta for Developers → tu App → WhatsApp → Configuration
- Callback URL:
https://tu-servidor.com/webhook - Verify Token: el que definiste en VERIFY_TOKEN
- Suscribir a: messages
Resultado final
Con esta integración tu Persona AgentXIA:
- Responde automáticamente 24/7 en WhatsApp
- Recuerda a cada cliente por su número de teléfono
- Usa el conocimiento de tu empresa (productos, FAQs, políticas)
- Responde en el tono y estilo que configuraste
- Puede escalar a humano cuando detecta que la consulta lo requiere
¿Quieres que te lo configuremos?
El plan Growth de AgentXIA incluye soporte de integración: configuramos la Persona, el webhook y la integración WhatsApp por ti. Listo en 48 horas.
Ver planes AgentXIA →
El plan Growth de AgentXIA incluye soporte de integración: configuramos la Persona, el webhook y la integración WhatsApp por ti. Listo en 48 horas.
Ver planes AgentXIA →