Conecta el número de WhatsApp de tu negocio para que tu agente conteste los mensajes.
WhatsApp es el canal por el que tus clientes ya te escriben, y normalmente el que peor se atiende: mensajes de la noche, del fin de semana, de todos al mismo tiempo. Conectarlo hace que tu agente conteste cada uno en segundos, con el mismo criterio que le diste para las llamadas.Usa la Cloud API de Meta con tu propia app, así que no dependes de ningún proveedor intermedio: Ryvo habla directo con WhatsApp y el número sigue siendo tuyo.
WhatsApp es la única integración del catálogo que no se conecta con un clic. Las otras doce abren una pantalla de autorización y ya; esta pide cinco datos de Meta que tienes que ir a buscar. Es el precio de que el número sea tuyo y no de un intermediario.
Los cinco datos se reúnen en los pasos 1 a 4 y se pegan en Ryvo en el paso 5:
Dato
Dónde sale
ID de la app de Meta
Paso 1
App secret
Paso 4
WABA ID (WhatsApp Business Account ID)
Paso 2
Phone number ID
Paso 2
Token permanente
Paso 3
Meta cambia su interfaz con frecuencia. Si tu pantalla no se ve igual que las capturas, busca la sección de configuración de la API de WhatsApp de tu app: los IDs siempre aparecen junto al número seleccionado.
Una cuenta de Meta Business (portafolio de negocio). Para pasar de pruebas a producción, Meta pide verificarla.
Un número de teléfono que no esté ligado a otra cuenta de WhatsApp, ni a la app de WhatsApp normal ni a la de WhatsApp Business. Si tu número está activo en la app del celular, no lo registres por este flujo: escríbenos a team@ryvo.so para ver la mejor forma de migrarlo.
Un agente publicado en tu cuenta de Ryvo. WhatsApp siempre contesta con la versión publicada, nunca con el borrador.
El Engine activo y saldo en tu cuenta. Si el saldo se agota, el agente deja de contestar igual que en voz o chat.
En el menú de la app, entra a Casos de uso, busca Conectar con clientes a través de WhatsApp y da Personalizar.
Casos de uso, después Personalizar.
En la interfaz nueva de Meta, ve a Configuración básica › Paso 2. Configuración de producción y abre Registra tu número de WhatsApp. En apps más viejas, la misma pantalla está en WhatsApp › Configuración de la API.
Configuración de producción: aquí se registra el número.
2
Agrega o elige tu número
Elige un número existente en el selector, o da Agregar número. Si es nuevo, escribe el nombre que verán tus clientes, el número, elige verificación por SMS o llamada y captura el código que te manda Meta.
Alta de un número nuevo con verificación por SMS o llamada.
3
Copia el WABA ID y el Phone number ID
Con el número seleccionado, la pantalla muestra el WhatsApp Business Account ID (el WABA ID) y el Phone Number ID. Copia los dos.
Arriba, el WABA ID; abajo, junto al número, el Phone number ID.
El token que Meta muestra por omisión caduca en 24 horas. Para que la conexión no se caiga, genera uno sin expiración desde un usuario del sistema.
1
Abre los usuarios del sistema
En business.facebook.com/settings elige el portafolio dueño de tu WABA y ve a Usuarios › Usuarios del sistema. Si ya tienes uno, selecciónalo; si no, da Agregar.
Configuración del negocio, Usuarios, Usuarios del sistema.
2
Crea el usuario del sistema
Ponle un nombre (por ejemplo, “Ryvo WhatsApp”), elige el rol Administrador y da Crear usuario del sistema.
Nombre y rol de administrador para el usuario del sistema.
3
Asígnale la app y la WABA
Con el usuario seleccionado, da Asignar activos: agrega tu app de Meta y tu cuenta de WhatsApp Business con control total. Después da Generar token.
Asignar activos y luego Generar token.
4
Elige la app
Selecciona la app que creaste en el paso 1 y da Siguiente.
La app para la que se genera el token.
5
Sin expiración
En la caducidad del token elige Nunca y da Siguiente.
El token debe ser permanente.
6
Permisos
Marca whatsapp_business_messaging y whatsapp_business_management, y genera el token.
Los dos permisos de WhatsApp que Ryvo necesita.
7
Copia el token
Da Copiar y guárdalo en un lugar seguro: Meta no lo vuelve a mostrar.
Copia el token en cuanto aparece.
Quien tenga ese token puede mandar mensajes desde tu número. No lo compartas por chat ni por correo; pégalo sólo en el formulario de Ryvo, donde se guarda cifrado.
En tu app de Meta, ve a Configuración de la app › Básica y da Mostrar junto a Clave secreta de la app (Meta puede pedirte tu contraseña). Cópiala. Ryvo la usa para verificar que cada mensaje que llega al webhook viene de Meta y no de alguien más.
En Ryvo, ve a Configuración › Integraciones, busca la tarjeta WhatsApp Business y da clic en Configurar. Se abre una página con los pasos a la izquierda y el formulario a la derecha:
1
Conectar tu cuenta
Pega los cinco datos: ID de la app de Meta (paso 1), App secret (paso 4), WABA ID y Phone number ID (paso 2) y Token permanente (paso 3). Al dar Crear canal de WhatsApp, Ryvo valida las credenciales contra Meta antes de guardar nada. Si algo está mal, el error aparece debajo del campo que hay que corregir.
2
Elegir agente
Selecciona el agente que va a contestar (sólo aparecen los publicados) y da Asignar agente. Puedes dejarlo para después, pero mientras no haya agente el número recibe mensajes sin contestar.
3
Listo
Ryvo intenta configurar el webhook de tu app y suscribir tu WABA automáticamente. Si lo logra, no tienes que tocar nada más en Meta. Si no, la misma pantalla te da la URL de callback y el verify token para hacerlo a mano.
La pantalla de WhatsApp Business (Configuración › Integraciones › Configurar) te muestra la URL de callback y el verify token. Completa estos pasos en tu app de Meta:
1
Pega la URL y el verify token
En tu app, ve a WhatsApp › Configuración. En la sección Webhook, pega la URL de callback y el verify token y da Verificar y guardar.
Webhook: URL de callback, verify token y el botón Verificar y guardar.
2
Suscríbete al campo messages
En la lista de campos del webhook, activa messages. Sin este campo, Ryvo no recibe los mensajes de tus clientes.
El campo messages debe quedar suscrito.
3
Suscribe la WABA a la app
En la pantalla del paso 2 (configuración de producción), activa Suscribir webhooks junto a tu cuenta de WhatsApp Business. Si no ves el interruptor, escríbenos y lo hacemos por ti.
A diferencia de las apps que se conectan por Composio, WhatsApp no trae una lista de acciones que se prenden en el constructor. Lo que hace es abrir un canal: el agente que le asignes contesta los mensajes de ese número con todo lo que ya sabe hacer, incluidas las acciones de las otras integraciones que le hayas encendido.Para probarlo, manda un “hola” desde tu celular al número que conectaste. Si todo quedó bien, el agente contesta en unos segundos y la conversación aparece en Conversaciones como cualquier otra.Estados de la conexión
Estado
Qué significa
Esperando el primer mensaje
La conexión quedó lista; todavía no llega ningún mensaje.
Activo
Ya hay conversación entrando y saliendo.
Pausado
La pausaste tú; el número deja de contestar hasta que la reanudes.
Token inválido
Meta rechazó el token (por ejemplo, lo revocaste). Da Reconectar y genera uno nuevo desde el paso 3.
Límites de hoy
Sólo texto. Si un cliente manda audio, imagen o documento, recibe un aviso de que el agente todavía no los procesa.
Un número por cuenta. Para varios números, escríbenos a team@ryvo.so.
El agente contesta con su versión publicada; los cambios en el borrador no aplican hasta que publiques.
Aplica la ventana de 24 horas de Meta: el agente sólo responde a mensajes de tus clientes; no inicia conversaciones ni manda plantillas.
