Integración con WhatsApp

Conecta tu agent a WhatsApp Business para la comunicación con clientes.

Descripción General

La integración con WhatsApp ofrece:

• Capacidades de mensajería empresarial
• Soporte de contenido multimedia
• Respuestas automatizadas
• Alcance global
• Cumplimiento de la ventana de mensajería de 24 horas

Requisitos Previos

• Un AI agent activo (creado en la sección Agents)
• Una WhatsApp Business Account (WABA)
• Un número de teléfono verificado en WhatsApp Business
• Acceso al Meta Developer Portal

Pasos de Configuración

1. Conectar con Embedded Signup (Recomendado)

La forma más sencilla de conectar WhatsApp es a través del flujo embebido de signup de Meta:

1. Ve a Agents → Selecciona tu agent
2. Navega a la pestaña Integrations
3. Haz clic en WhatsApp
4. Haz clic en Connect with Facebook para abrir el popup de signup de Meta
5. Inicia sesión con tu cuenta de Facebook/Meta
6. Selecciona o crea una WhatsApp Business Account
7. Elige el número de teléfono a conectar
8. El popup se cierra y tu conexión queda establecida

2. Verificación de Teléfono (Si Es Necesario)

Tras completar el signup de Meta, es posible que debas verificar tu número de teléfono:

1. Elige cómo recibir tu código de verificación: SMS o Voice Call
2. Haz clic en Send Code
3. Ingresa el código de 6 dígitos que recibas
4. Haz clic en Verify

Si no recibiste el código, haz clic en “Didn’t receive the code? Send again” para reintentar.

3. Verificación en Dos Pasos (Si Está Habilitada)

Si tu cuenta de WhatsApp Business tiene activada la verificación en dos pasos:

1. Ingresa tu PIN de 6 dígitos cuando se te solicite
2. Haz clic en Complete Registration

4. Configurar el Webhook (Si Es Necesario)

Tras la configuración, es posible que debas configurar tu webhook en Meta Business Suite:

1. Copia la webhook URL proporcionada después de la conexión
2. En Meta Developer Portal, ve a WhatsApp → Configuration
3. Agrega la webhook URL
4. Suscríbete al campo de webhook messages

Usar el Bot

Mensajes de Clientes

Cuando los clientes envían mensajes a tu número de WhatsApp:

1. El mensaje llega vía WhatsApp
2. Cuneiform Chat procesa la solicitud
3. El agent genera una respuesta a partir del contenido
4. La respuesta se envía de vuelta al cliente

Flujo de Conversación

Cliente → WhatsApp → Cuneiform Chat → Agent → Respuesta → Cliente

Funcionalidades

Ventana de Mensajería de 24 Horas

Reglas de la WhatsApp Business API:

• Puedes responder a mensajes iniciados por el cliente durante 24 horas
• Después de 24 horas, la ventana se cierra hasta que el cliente vuelva a escribir
• Cada nuevo mensaje del cliente reabre la ventana

Contenido Multimedia

Las respuestas pueden incluir:

• Mensajes de texto
• Enlaces
• Texto formateado

Multi-Idioma

Tu agent detecta automáticamente el idioma del cliente y responde en el mismo — 176 idiomas soportados, sin configuración necesaria.

Gestionar Números Conectados

Cada número de WhatsApp conectado muestra:

• Business name o número de teléfono mostrado
• Status badge - Active, Inactive o Error
• Phone number
• Marca temporal de Last activity

Acciones Disponibles

Accede a estas opciones desde el menú de tres puntos en la tarjeta de la integración.

Solución de Problemas

Falló la Conexión

1. Asegúrate de tener una WhatsApp Business Account válida
2. Comprueba que tu número de teléfono esté verificado
3. Intenta el flujo de embedded signup de nuevo

La Verificación de Teléfono No Funciona

1. Asegúrate de tener acceso al número de teléfono para SMS/Voz
2. Espera unos minutos antes de solicitar un nuevo código
3. Comprueba que el número de teléfono no esté ya conectado en otro lugar

Error de Verificación en Dos Pasos

1. Ingresa el PIN configurado en WhatsApp Business Manager → Security Center
2. Es diferente del código de verificación por SMS
3. Contacta al admin de tu WhatsApp Business si no conoces el PIN

Los Mensajes No Llegan

1. Verifica que el webhook esté configurado correctamente en Meta Business Suite
2. Comprueba que la suscripción del webhook incluya messages
3. Confirma que el estado de la integración sea “Active”

Fallos en las Respuestas

1. Verifica que tu agent funcione en el Playground
2. Comprueba que la ventana de 24 horas esté activa (el cliente escribió recientemente)
3. Revisa el estado de la integración en el panel de administración

Seguridad

• Los access tokens están cifrados y almacenados de forma segura
• Los mensajes se procesan a través de conexiones seguras

Cumplimiento

WhatsApp Business tiene políticas de uso:

• Responde solo a conversaciones iniciadas por el cliente
• Proporciona opciones de exclusión
• Sigue las políticas de Commerce y Business de Meta

Desconectar

Para eliminar la integración con WhatsApp:

1. Ve a Agents → Selecciona el agent → Integrations
2. Haz clic en el menú de tres puntos en tu integración con WhatsApp
3. Selecciona Disconnect

Esto detiene las respuestas del agent. Para eliminar por completo:

• Borra el webhook en Meta Developer Portal
• Opcionalmente, quita el producto WhatsApp de tu app de Meta

Preguntas Frecuentes

P: ¿Cómo conecto WhatsApp? R: Usa el embedded signup haciendo clic en “WhatsApp” en la pestaña Integrations y luego en “Connect with Facebook”. Esto te guía automáticamente por el proceso de signup de Meta.

P: ¿Por qué se me pide un código de verificación? R: WhatsApp requiere verificación de teléfono para nuevas conexiones. Elige SMS o Voice Call para recibir un código de 6 dígitos y luego ingrésalo para completar la configuración.

P: ¿Qué es el PIN de verificación en dos pasos? R: Si activaste la verificación en dos pasos en WhatsApp Business Manager, deberás ingresar ese PIN de 6 dígitos durante la configuración. Es diferente del código de verificación por SMS.

P: ¿Puedo conectar varios números de WhatsApp? R: Sí, puedes conectar varios números de WhatsApp Business. Cada número puede conectarse a un AI agent diferente (o al mismo).