Conectar WhatsApp (Meta o Twilio) para campañas
Guía paso a paso para conectar tu número de WhatsApp con Meta Cloud API o Twilio y enviar campañas y atender conversaciones desde Xtarly.
Las campañas de WhatsApp de Xtarly usan tu propio número de WhatsApp Business. Puedes conectarlo de dos formas:
- Meta Cloud API — directo con Meta. Recomendada si quieres tu marca propia y el menor costo por mensaje.
- Twilio — si ya usas Twilio o prefieres su panel.
Elige una de las dos. Todo se configura en Campañas de WhatsApp → pestaña Conexión.
Requisito previo: WhatsApp debe estar disponible en tu plan. Viene incluido en Branded y Premium, y está disponible como add-on (+$19/mes) en Shared. Si no lo tienes activo, el panel te mostrará el botón para activarlo.
Opción A — Meta Cloud API (recomendada)
Lo que vas a necesitar
- Una cuenta en Meta for Developers.
- Un número de teléfono para tu WhatsApp Business (que no esté ya registrado en la app de WhatsApp normal).
Paso a paso
Crea una app en Meta for Developers
Entra a developers.facebook.com → My Apps → Create App → tipo Business.
Agrega el producto WhatsApp
Dentro de tu app, agrega el producto WhatsApp. En WhatsApp → API Setup vas a ver dos datos que necesitas copiar:
- Phone Number ID — el identificador de tu número.
- WhatsApp Business Account ID (WABA ID) — la cuenta de negocio.
Ahí mismo registra y verifica el número de teléfono de tu negocio.
Genera un token permanente (System User Access Token)
El token que Meta muestra en "API Setup" es temporal (dura 24 h). Para producción necesitas uno permanente:
- Ve a Business Settings → Users → System Users.
- Crea un System User (rol Admin).
- Genera un token con los permisos
whatsapp_business_messagingywhatsapp_business_management. - Copia ese token (empieza con
EAAB...).
Conéctalo en Xtarly
En Campañas de WhatsApp → Conexión, elige el proveedor Meta y llena:
- System User Access Token — el token
EAAB.... - Phone Number ID — del Paso 2.
- WhatsApp Business Account ID — del Paso 2.
Haz clic en Conectar.
Configura el webhook (recomendado)
El webhook permite recibir estados de entrega y mensajes entrantes (para el Inbox de conversaciones).
- En Xtarly (misma pestaña) inventa un texto para el Webhook Verify Token (cualquier cadena, por ejemplo
xtarly-mi-negocio-2026) y ponlo en ese campo. - Copia también, desde Meta → App Settings → Basic, el App Secret, y pégalo en el campo App Secret de Xtarly. Guarda.
- En Xtarly, copia la URL de webhook que se muestra (termina en
/api/webhooks/whatsapp/meta/...). - En Meta → WhatsApp → Configuration → Webhooks, pega esa URL, pega el mismo Verify Token del punto 1, y suscríbete al campo
messages.
Prueba la conexión
Haz clic en Probar conexión. Xtarly consulta a Meta y te muestra la calidad del número (verde/amarillo/rojo) y tu tier de mensajería. Si sale verde, ya puedes enviar.
Opción B — Twilio
Lo que vas a necesitar
- Una cuenta en Twilio.
- Un sender de WhatsApp: el Sandbox de Twilio para pruebas, o un número de WhatsApp aprobado para producción.
Paso a paso
Copia tus credenciales de Twilio
En la consola de Twilio, en la página principal, copia:
- Account SID — empieza con
AC.... - Auth Token — el token de autenticación.
Identifica tu número emisor
Anota tu número de WhatsApp en formato internacional, con el código de país. Por ejemplo: +5213321017080. (El del Sandbox de Twilio sirve para pruebas.)
Conéctalo en Xtarly
En Campañas de WhatsApp → Conexión, elige el proveedor Twilio y llena:
- Account SID — el
AC.... - Auth Token — tu token.
- Número de WhatsApp — solo el número, por ejemplo
+5213321017080(del Paso 2).
Haz clic en Conectar.
Configura el webhook
En Xtarly copia la URL de webhook (termina en /api/webhooks/whatsapp/twilio/...) y pégala en la configuración de mensajes de tu sender de WhatsApp en Twilio. Twilio verifica la firma automáticamente con tu Auth Token, así que no hay que pegar ningún secreto extra.
Prueba la conexión
Haz clic en Probar conexión en Xtarly para confirmar que las credenciales funcionan.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| El token deja de funcionar a las 24 h | Usaste el token temporal de "API Setup" | Genera un System User Access Token permanente (Meta, Opción A · Paso 3). |
| "Número no registrado" | El número no completó el registro en Meta | Termina el registro/verificación del número en WhatsApp → API Setup. |
| Calidad en amarillo o rojo | Muchos bloqueos/reportes de usuarios | Envía solo a quien dio consentimiento, con plantillas útiles; la calidad se recupera con el tiempo. |
| No puedo enviar campañas | Las plantillas no están aprobadas | Crea plantillas en la pestaña Plantillas y espera la aprobación de Meta. |