WhatsApp Business Webhook

WhatsApp Business Webhook pone en marcha un flujo cada vez que tu número de WhatsApp Business recibe un mensaje. Entrega el texto, el número y el nombre de quien escribe y, si el mensaje es una imagen, un documento, un vídeo o un audio, también el archivo.

WhatsApp avisa a NappAI en cuanto llega un mensaje. Para eso tienes que pegar en tu aplicación de Meta la dirección del webhook de tu flujo, como se explica más abajo.

Cuándo usarlo

Quieres un asistente de IA que atienda por WhatsApp las preguntas de tus clientes.
Quieres recibir por WhatsApp pedidos o reservas y registrarlos en tu sistema.
Quieres guardar las fotos o los documentos que te envían los clientes, por ejemplo justificantes o facturas.
Quieres avisar a tu equipo cuando un cliente escribe con una urgencia.

Configuración

Necesitas una credencial WhatsApp Business con la clave de la API de WhatsApp Business, el identificador de tu número y un token de verificación que tú eliges (Verification Token). Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial WhatsApp Business del número que recibe los mensajes.
Data	Campo de prueba. Te permite probar el flujo con un mensaje de ejemplo sin esperar a uno real. Déjalo vacío en el uso normal.

Los mensajes de texto recibidos se guardan en el historial de conversaciones del flujo.

Conectar WhatsApp con el flujo

Guarda el flujo y publica una versión. WhatsApp envía los mensajes a la versión publicada. Consulta Versiones y publicación.
En el editor pulsa Acceso a API y abre la pestaña de WhatsApp. Copia la Webhook URL.
En la configuración de WhatsApp de tu aplicación de Meta, pega esa dirección como webhook y escribe como token de verificación el mismo Verification Token de tu credencial.
Suscríbete en Meta a los mensajes (messages).

Resultado

El componente tiene tres salidas:

Data: los datos del mensaje: su identificador, el número de quien escribe, el nombre de su perfil, el tipo de mensaje (text, image, document, video o audio), la fecha y el texto o el archivo que trae.
Message: el texto recibido como mensaje de conversación, listo para conectarlo a un agente.
Media: el archivo que trae el mensaje, si lo hay, para guardarlo o analizarlo.

Cada número que escribe tiene su propia conversación en el flujo, así que un agente conectado a Message recuerda lo que ha hablado con cada cliente. Para responder, conecta la respuesta a Message, que en modo Basic contesta al mismo número que escribió.

Ejemplo

Una clínica dental atiende por WhatsApp las preguntas sobre horarios y tratamientos.

Añade WhatsApp Business Webhook y elige la credencial WhatsApp Business de la clínica.
Conecta la salida Message a un agente con la información de la clínica.
Conecta la respuesta del agente a Message Body de un componente Message con la operación Send Message y Type Operation en Basic.
Publica el flujo, copia la Webhook URL en Acceso a API y pégala en tu aplicación de Meta.

Buenas prácticas

Si cambias el Verification Token de la credencial, cámbialo también en la aplicación de Meta.
Prueba el flujo con Data antes de conectarlo a WhatsApp, para no responder a clientes reales mientras lo montas.

Componentes relacionados

Message: enviar mensajes, plantillas y archivos por WhatsApp Business.