Conecta el número de WhatsApp de tu negocio para que tu agente conteste los mensajes.
Con esta integración, tu agente del Engine contesta los mensajes que lleguen al número de WhatsApp de tu negocio, usando la Cloud API de Meta con tu propia app. Meta aloja la API, así que no dependes de ningún proveedor intermedio: Ryvo habla directo con WhatsApp.Para conectarlo necesitas cinco datos de Meta, que reúnes en los pasos 1 a 4, y después los pegas 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 soporte@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.
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 → 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 (siguiente sección).
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.
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.
