Configuración

Conectar WhatsApp con la Meta Cloud API

Envía y recibe WhatsApp directo por Meta (Cloud API), con tu propio número y app, como alternativa a Twilio. Modelo BYO: el número, la WhatsApp Business Account y la app son tuyos.

Plantillas de mensaje

Tras 24 horas sin respuesta del cliente, WhatsApp ya no permite enviar texto libre: para retomar la conversación hace falta una plantilla aprobada. Las creas y gestionas dentro del CRM, en la tarjeta de WhatsApp en Configuración → Integraciones — no hace falta ir al Business Manager de Meta.

Haz clic en Nueva plantilla y di para qué sirve. El nombre técnico se completa solo (Meta solo acepta minúsculas, dígitos y guion bajo).
Elige el idioma y la categoría. Utilidad es para un mensaje que el cliente espera, como un pedido o una cita; Marketing es para una oferta. Meta también revisa la categoría, y equivocarse es motivo frecuente de rechazo.
Escribe el mensaje. Usa {{1}}, {{2}} para lo que cambia en cada persona, numerado en orden y sin saltos.
Completa un ejemplo para cada variable. Meta lo exige y rechaza la plantilla sin ellos — nadie recibe esos valores, solo sirven para la revisión.
Envía a revisión. La plantilla entra como pendiente y Meta suele aprobarla en minutos; el estado aparece en la lista.

💡 El CRM revisa el nombre, la numeración de las variables y los ejemplos que faltan antes de enviar nada a Meta. Son los tres rechazos más comunes, y el mensaje de Meta para ellos no dice qué corregir.

Conectar en un clic

Si aparece el botón "Conectar WhatsApp" en la parte superior de la tarjeta, úsalo: es el camino corto. Se abre una ventana de Meta, eliges (o creas) la cuenta de WhatsApp Business y el número, y listo. No hay app que crear, ni token que generar, ni nada que pegar. Funciona porque SellioCRM es un Tech Provider aprobado por Meta, así que la conexión ocurre bajo nuestra app en lugar de una que tú tendrías que construir.

El número y la cuenta siguen siendo tuyos. Puedes desconectar desde Meta cuando quieras y perdemos el acceso al instante.
Nunca vemos tu contraseña de Facebook, y ningún secreto nuestro llega a tu navegador.
Meta sigue cobrando los mensajes en tu propia cuenta.

💡 Si el botón no aparece, el camino de un clic no está habilitado para tu espacio y la configuración manual de abajo es el camino. Ambos terminan en el mismo lugar: mismo envío, misma bandeja, mismas plantillas.

Configuración manual (app propia en Meta)

Además de Twilio, puedes enviar y recibir WhatsApp directo por Meta, usando la Cloud API oficial. Es una alternativa: cuando esta integración está activa, el WhatsApp sale por Meta; el SMS sigue por Twilio. Modelo BYO (trae tu propia cuenta): el número, la WhatsApp Business Account (WABA) y la app de Meta son tuyos, y los mensajes se cobran en tu cuenta de Meta, sin costo, margen ni intermediación nuestra.

La integración nace inerte: no se envía nada hasta que completes los campos y actives. El access token y el app secret quedan cifrados en el CRM y nunca se muestran de vuelta.

Requisitos previos

Una app en Meta (developers.facebook.com) con el producto WhatsApp agregado y una WhatsApp Business Account (WABA).
Un número de WhatsApp registrado en tu WABA y su Phone Number ID (en WhatsApp > API Setup).
Un access token permanente (recomendado: un System User en el Business Manager) y el App secret de la app (en Configuración > Básico).
En Sellio, ser administrador para guardar las credenciales y activar la integración en Configuración → Integraciones.

Lo que debes completar

Phone Number ID: el identificador de tu número de WhatsApp en Meta (es un ID, no el número en sí).
WABA ID (opcional): el ID de tu WhatsApp Business Account, útil para la gestión y las plantillas.
Graph version: la versión de la Graph API a llamar (ej.: v21.0). En blanco usa la predeterminada.
Verify token: una cadena que eliges. Debe ser la misma en el CRM y en el panel de Meta al suscribir el webhook.
Access token: el token permanente que autoriza el envío (queda cifrado en el CRM).
App secret: el secreto de la app, usado para verificar la firma de los webhooks recibidos (queda cifrado en el CRM).

Cómo configurar

Abre Configuración → Integraciones y localiza la tarjeta "WhatsApp (Meta Cloud API)".
Completa el Phone Number ID, el Verify token (elige una cadena), el Access token y el App secret; el WABA ID y la Graph version son opcionales. Haz clic en "Guardar credenciales".
Copia la "URL del webhook (Meta)" que aparece. En el panel de Meta, en WhatsApp → Configuration → Webhooks, pega esa URL en Callback URL y el mismo Verify token en el campo Verify token.
Aún en Meta, suscríbete (Subscribe) al campo "messages" para recibir mensajes y estados.
Vuelve al CRM y haz clic en "Activar". A partir de ahí, los envíos de WhatsApp usan Meta.

Cómo enviar un mensaje

Abre un Contacto o Lead que tenga teléfono (campo Teléfono o Celular).
En el panel "Mensajes (SMS/WhatsApp)", haz clic en "Enviar SMS/WhatsApp" y elige el canal WhatsApp.
Verifica el número, escribe el mensaje y haz clic en "Enviar".
El mensaje queda registrado en el historial del registro. Las respuestas del cliente llegan por el webhook y aparecen en el mismo historial.

💡 Ventana de 24h y plantillas: fuera de la ventana de 24 horas desde el último mensaje del cliente, Meta solo acepta mensajes de PLANTILLA aprobada. Dentro de la ventana, el texto libre funciona. Crea y aprueba tus plantillas en el panel de Meta.

Seguridad: el CRM verifica la firma X-Hub-Signature-256 de cada webhook recibido usando tu App secret (una llamada sin firmar o con firma inválida es rechazada). Trata el access token y el app secret como secretos: quedan cifrados y nunca se muestran de vuelta.

Varios números en la misma app

Puedes tener más de un número de WhatsApp en la misma integración (p. ej., un número de EE. UU. como predeterminado y un número de Brasil para conversaciones locales). En la tarjeta de la integración, agrégalos en "Números adicionales" (Phone Number ID, WABA ID opcional y una etiqueta) y guarda. Al iniciar una conversación, elige el remitente en "Enviar desde"; las respuestas del Inbox salen automáticamente por el número en que llegó cada conversación. El número principal sigue siendo el predeterminado.

Cómo probar

Abre un Contacto o Lead con teléfono y envía un mensaje corto de WhatsApp a uno de tus números.
Confirma que el mensaje llegó al teléfono y que quedó registrado en el historial del registro.
Responde desde el teléfono y verifica que la respuesta aparece en el mismo historial (esto valida el webhook de entrada).

Solución de problemas

La verificación del webhook falla en Meta: el Verify token del CRM y el del panel de Meta deben ser idénticos. Verifica que la Callback URL sea la "URL del webhook (Meta)" mostrada en la tarjeta.
Error al enviar: verifica el Phone Number ID y el Access token. Un token vencido o sin permiso de WhatsApp hace que Meta rechace el envío.
WhatsApp no envía fuera de la ventana: usa una plantilla aprobada. Texto libre solo dentro de la ventana de 24h.
No recibo las respuestas: en el panel de Meta, suscríbete (Subscribe) al campo "messages" y confirma la Callback URL + Verify token.
Webhook rechazado (403): la firma X-Hub-Signature-256 no coincide. Vuelve a indicar el mismo App secret en el CRM (no vuelve del servidor).
Sigue saliendo por Twilio: la integración de Meta debe estar "Activada". Sin activar, el WhatsApp sigue usando Twilio.

Usar el MISMO número que ya está en la app WhatsApp Business

Puedes mantener el número activo en la app del móvil y conectado al CRM al mismo tiempo — Meta lo llama coexistencia. El vendedor sigue respondiendo desde el móvil como siempre, y cada mensaje que envía aparece en la conversación del CRM automáticamente. Se importan hasta seis meses de conversaciones anteriores.

No lo activas tú en el Business Manager: ocurre por el asistente de conexión del CRM y se confirma con un código que llega a tu WhatsApp.
La app sigue funcionando normalmente: lo que cambia es que la conversación también queda registrada aquí, en el contacto correcto.
La importación del historial tiene plazo: Meta da 24 horas tras la activación. Deja la app abierta mientras ocurre — la pantalla muestra el progreso.
Si cambias de móvil o registras el número de nuevo, la conexión se cae y hay que rehacerla. El CRM te avisa cuando pasa.

💡 Lo que deja de funcionar en la app con la coexistencia activa: grupos, llamadas de voz y vídeo, catálogo y pedidos, mensajes de marketing y respuestas rápidas de la app. Las listas de difusión existentes quedan de solo lectura. Si algo de eso es esencial para ti, usa un número dedicado en el CRM y deja la app intacta.

Abrir este artículo dentro del sistema →