Webhook de WhatsApp para recibir mensajes en tu sistema
Configura una URL y cada mensaje entrante llega por POST en JSON. Si respondes con un mensaje, se envía al cliente.
{
"message": "hola, quiero el catalogo",
"text": "Hola, quiero el catálogo",
"bufferImage": null,
"from": "51987654321",
"lid": null,
"id": "3EB0C431F3A1B2C4D5E6",
"pushName": "Ana Torres",
"participant": null
}Lo que necesitas saber
-
Al instante
Llega a tu URL apenas el mensaje entra al número.
-
Responde en la misma petición
Devuelve un JSON con text y el mensaje sale. {name} se cambia por el nombre del contacto.
-
Con imágenes
Si el cliente envía una imagen, llega en base64 en bufferImage.
Cómo contestar desde tu webhook
Responde la petición con un JSON como este y el mensaje le llega al cliente. Si no quieres contestar, responde vacío.
{
"text": "Hola {name}, aquí tienes nuestro catálogo.",
"quoted": true
}Todos los parámetros y los errores posibles están en la documentación de webhook.
¿Dónde configuro la URL del webhook?
En el panel, en Webhooks o en la ficha del dispositivo. Ahí mismo puedes probarla.
¿Cómo evito responder dos veces el mismo mensaje?
Guarda el campo id: es el identificador del mensaje en WhatsApp y no se repite.
¿Llegan también los mensajes de grupos?
Sí. En grupos llega además participant, el número de quien escribió.
Casos de uso con esta función
-
Notificaciones de pedidos por WhatsApp
El cliente compra y recibe la confirmación en su WhatsApp. Cuando sale a reparto, otro aviso. Menos llamadas preguntando "¿dónde está mi pedido?". -
Recordatorios de citas por WhatsApp
Un día antes, tu agenda envía el recordatorio con la fecha y la hora. El paciente confirma con un toque en la encuesta. -
Recordatorios de pago por WhatsApp
El correo se ignora; el WhatsApp se lee. Recordatorios con el monto y la fecha de cada cliente, enviados desde tu sistema. -
Formulario web conectado a WhatsApp
El interesado deja sus datos y en segundos recibe tu WhatsApp. Respondes mientras todavía está pensando en ti.
Funciones relacionadas
-
Chatbot de WhatsApp con inteligencia artificial
Pega tu clave de Anthropic, OpenAI o Google, escribe las instrucciones de tu negocio y la IA contesta los chats de ese número. API Pro -
Respuestas automáticas de WhatsApp por palabra clave
Tu cliente escribe "precios" y recibe la respuesta al instante. Lo que no coincide con ninguna palabra sigue a tu webhook. API Pro -
Resolver el LID de WhatsApp a número de teléfono
WhatsApp a veces identifica un chat con un LID (un id interno) en vez del número. Esta consulta te devuelve el número real si ya está disponible.
Envía tu primer mensaje hoy
Escríbenos por WhatsApp, conectamos tu número con un QR y te damos tu API key para que pruebes desde tu sistema.