Conectar WhatsApp para avisos y campañas
Conecta tu número de WhatsApp Business con un clic (conservando tu app y tus chats) o manualmente con Meta Cloud API o Twilio, y empieza a enviar desde Xtarly.
WhatsApp en Xtarly usa tu propio número de WhatsApp Business: los mensajes salen a nombre de tu negocio, no del nuestro. Hay dos caminos para conectarlo:
- Conexión de un clic (recomendada) — autorizas desde una ventana de Meta y confirmas en tu celular. Conservas tu número, tus chats y tu app de WhatsApp Business.
- Conexión manual (avanzada) — para quien ya trae su propia app de Meta, o usa Twilio.
Todo se hace en WhatsApp → pestaña Conexión.
Requisito previo: WhatsApp debe estar disponible en tu plan. Viene incluido en Shared, Branded y Premium, y en Wallet se contrata como add-on de pago (+$99 MXN/mes o +$5 USD/mes, según la moneda de tu cuenta). En Wallet, si no lo tienes activo, el panel te muestra el botón para activarlo; antes de ir al cobro confirmas que ya tienes (o sabes cómo obtener) tu cuenta de Meta o Twilio.
Opción A — Conexión de un clic (recomendada)
Es lo primero que ves en la pestaña Conexión. Toca Conectar mi WhatsApp Business: se abre una ventana de Meta donde eliges tu negocio y tu número, y la confirmación ocurre en tu propio celular — Meta te envía un mensaje por WhatsApp. Nunca tienes que copiar un token ni pegar una URL.
Qué conservas y qué cambia
- ✅ No cambias de número ni pierdes tus chats. Sigues atendiendo desde tu app de WhatsApp Business como siempre.
- ✅ Los dos lados quedan sincronizados: lo que escribas desde tu celular aparece en las conversaciones de Xtarly, y lo que envíes desde Xtarly llega a tu teléfono.
- ✅ Tu historial se puede traer: si aceptas compartirlo desde tu app, Meta entrega una sola vez tus conversaciones de hasta 180 días y se ven en el panel.
- ⚠️ Se cierran tus sesiones de WhatsApp Web y tendrás que volver a vincularlas.
- ⚠️ Se desactivan las listas de difusión, los mensajes temporales y la ubicación en tiempo real.
- ⚠️ Meta te cobra a ti las conversaciones, con tu propio método de pago.
Debajo del botón hay una salida secundaria: "No uso WhatsApp Business: dar de alta un número nuevo". Ese camino da de alta un número dedicado en la nube y saca el número de la app de WhatsApp Business, así que úsalo solo si no atiendes desde el celular.
Qué hace Xtarly al terminar
Sin que tengas que tocar nada más:
- valida contra Meta que el número responde y te muestra su calidad y tu tier de mensajería;
- deja configurada la recepción de mensajes entrantes y estados de entrega (el webhook, con su token, se genera solo);
- importa las plantillas que ya vivían en esa cuenta de WhatsApp, con su estado real.
Si algo del alta quedó a medias, la pantalla te lo dice en ese momento en vez de dejarte descubrirlo cuando un envío falle.
Opción B — Conexión manual (avanzada)
En la misma pestaña, más abajo, está Conexión manual (avanzada), colapsada: ábrela con la flecha. Úsala solo si ya tienes tu propia app de Meta o si trabajas con Twilio. Elige uno de los dos proveedores.
Meta Cloud API
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 WhatsApp → Conexión → Conexión manual (avanzada), elige el proveedor Meta Cloud API 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 y validar.
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.
Twilio
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 la conexión manual, 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 y validar.
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.
Tus credenciales se cifran en reposo y nunca se te muestran de vuelta: el panel solo enseña los últimos 4 caracteres.
Qué ves cuando ya está conectado
La pestaña Conexión deja de pedir datos y muestra la ficha del número:
| Dato | Para qué sirve |
|---|---|
| Proveedor y estado | Meta Cloud API o Twilio, con la etiqueta Activa o Inválida. |
| ID del número y cuenta de WhatsApp (WABA) | Con qué número estás conectado, no solo que "hay" conexión. En Twilio, el número emisor. |
| Credencial | Los últimos 4 caracteres, para distinguir una cuenta de otra. |
| Calidad | El semáforo de Meta: verde, amarillo o rojo. |
| Tier de mensajería | Cuántas conversaciones nuevas puedes iniciar al día. |
Ahí mismo tienes Probar conexión (vuelve a preguntarle a Meta) y Desconectar. La tarjeta con la URL de webhook solo aparece si conectaste manualmente: quien conectó con un clic no la necesita, porque Xtarly ya suscribió su cuenta al terminar el alta.
Si cambias de cuenta o de número
Las aprobaciones de plantillas viven en la cuenta de WhatsApp (WABA), no en Xtarly. Por eso:
- Al conectar una cuenta distinta, las plantillas que estaban aprobadas vuelven a borrador y hay que reenviarlas a revisión. El panel te avisa cuántas fueron, para que no lo descubras cuando falle un envío.
- Las plantillas que ya existían en la cuenta que conectas se importan con su estado real, y si vuelves a la cuenta original recuperan su aprobación sin tener que someterlas de nuevo.
Solución de problemas
| Problema | Causa probable | Solución |
|---|---|---|
| El botón de conexión de un clic se queda en "Cargando…" | Un bloqueador de anuncios o una extensión de privacidad está bloqueando el conector de Meta | Desactívala para este sitio y recarga la página. |
| Conectaste, pero no entra ningún mensaje | El número quedó conectado sin activar la recepción (la pantalla te lo advierte al terminar) | Regístralo desde WhatsApp Manager o vuelve a conectar. |
| Tus plantillas aparecen en borrador | Conectaste otra cuenta de WhatsApp y las aprobaciones no viajan con ella | Reenvíalas a revisión desde la pestaña Plantillas. |
| El token deja de funcionar a las 24 h | Usaste el token temporal de "API Setup" en la conexión manual | Genera un System User Access Token permanente (Opción B · 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. |
| Tus avisos automáticos se pausan solos y dicen que WhatsApp no puede cobrar | Tu cuenta de WhatsApp Business en Meta no tiene moneda o forma de pago configurada (error 131042). No es una falla de Xtarly y mientras siga así no sale ningún aviso | Configúralo en business.facebook.com/billing_hub, y luego usa Revisar estado en Meta en la pestaña de Avisos automáticos: reactiva de golpe los avisos que se habían detenido por el cobro. |
| 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. |
¿Ya conectaste? El siguiente paso son los avisos automáticos a tus clientes: 11 mensajes de la casa que salen solos cuando tu cliente gana un sello, completa su tarjeta o cumple años.
Conectar tu correo (Resend) para campañas
Guía paso a paso para conectar tu cuenta de Resend y enviar campañas de correo a tus clientes desde Xtarly.
Conectar tu asistente de IA (Claude o ChatGPT)
Conecta Claude o ChatGPT a tu cuenta de Xtarly Rewards para configurar tu programa de lealtad y tus premios conversando.