WhatsApp por webhook
Por defecto, Kellu envía los WhatsApp a tus clientes. Con WhatsApp por webhook activo, Kellu deja
de enviarlos: cada mensaje llega a tu webhook como un evento
whatsapp.message_requested, con el teléfono, el texto listo y el enlace al PDF, y tú lo envías
(por ejemplo, desde tu propio proveedor de WhatsApp).
Activarlo
- Crea un endpoint de webhook activo suscrito a
whatsapp.message_requested. - En Configuración → API → WhatsApp, activa Enviar WhatsApp por webhook (dueño o Administrador). Sin un endpoint activo suscrito al evento no se puede activar.
Mientras esté activo, no puedes desactivar, eliminar ni quitarle el evento al último endpoint activo suscrito: primero apaga WhatsApp por webhook.
Qué cambia
Pasan por tu webhook los mensajes de tu negocio a tus clientes:
- confirmación de la visita, recordatorio de la visita y aviso de «en camino»;
- cotización y nota de venta;
- informe del trabajo (con el PDF, o con el enlace al portal de clientes cuando son varios informes);
- los recordatorios automáticos.
Siguen saliendo por Kellu los avisos internos: alertas de tickets a tu equipo, novedades de Kellu y respuestas automáticas a mensajes entrantes.
Sin respaldo: si tu webhook falla después de todos los reintentos, el mensaje no se envía por otro camino. Recibes el aviso de entrega fallida (campana y correo) y en el historial del trabajo el mensaje queda como fallido. Si después usas Reenviar en el registro de entregas y tu endpoint responde 2xx, vuelve a quedar como Enviado por webhook.
Si al enviar no hay ningún endpoint activo suscrito (por ejemplo, porque se desactivó solo por fallas), los envíos manuales responden con error y no se registran, y los recordatorios automáticos se omiten.
Para Kellu, un mensaje entregado a tu webhook cuenta como enviado: activa los recordatorios siguientes del documento o de la visita, y el informe queda visible en el portal, igual que con un envío de Kellu. En el historial del trabajo aparece como Enviado por webhook, sin estados de «entregado» o «leído»: esos dependen de tu proveedor.
Si el equipo de Kellu deshabilita el acceso a la API de tu negocio, los WhatsApp vuelven a salir por Kellu. Tu preferencia queda guardada: si el acceso se habilita de nuevo, WhatsApp por webhook vuelve a funcionar de inmediato.
El evento whatsapp.message_requested
Es el único evento con un data completo, y lleva datos personales de tu cliente.
{
"id": "evt_8e2f4b6a1c3d4e5f9a0b1c2d3e4f5a6b",
"type": "whatsapp.message_requested",
"occurredAt": "2026-03-10T15:42:07.123Z",
"apiVersion": "v1",
"source": { "type": "app" },
"data": {
"object": "whatsapp_message",
"id": "wamsg_3c9a7e1f5b2d4a6c8e0f1a2b3c4d5e6f",
"kind": "on_my_way",
"automatic": false,
"to": { "phone": "+56912345678", "name": "María González" },
"text": "¡Hola, María González!\n\nSomos Climatización Sur.\n\nEl técnico Juan Pérez, está en camino a Av. Providencia 1234, Providencia.\n\nLlegaremos en aproximadamente 20 minutos.\n\n¡Nos vemos pronto!",
"variables": {
"client_name": "María González",
"business_name": "Climatización Sur",
"assignee_name": "Juan Pérez",
"client_address": "Av. Providencia 1234, Providencia",
"arrival_time": "20",
"assignee_title": "Técnico"
},
"attachment": null,
"actionUrl": null,
"workOrderId": "cm…",
"visitId": "cm…",
"documentId": null,
"documentVersionId": null
}
}
source (fuera de data) es { "type": "connector", "clientId": "…" } cuando el envío lo pidió un
asistente con el conector de IA, y { "type": "app" } en los demás casos
(incluidos los recordatorios automáticos). Puede faltar en eventos generados antes de que existiera
el campo, también en sus reintentos y reenvíos. Detalle en Webhooks.
Campos de data:
| Campo | Descripción |
|---|---|
id | Id del mensaje (wamsg_…). Es el mismo en reintentos y reenvíos: deduplica por él. |
kind | Tipo de mensaje (tabla abajo). |
automatic | true si es un recordatorio automático; false si alguien lo envió desde Kellu. |
to.phone | Teléfono con + y solo dígitos. Un número chileno sin código de país se completa como +569…; cualquier otro se envía tal como se ingresó. |
to.name | Nombre del destinatario. |
text | Mensaje listo para enviar, en español. Si lleva un enlace de pago o del portal, va escrito dentro del texto y también en actionUrl. No incluye el pie de la plantilla. |
variables | Los valores crudos con que se armó el texto, por si prefieres tu propia plantilla. |
attachment | { url, filename, expiresAt } con el PDF, o null. |
actionUrl | Enlace a la página de pago o al portal de clientes, o null. |
workOrderId, visitId, documentId, documentVersionId | Ids relacionados (null si no aplican). |
kind
| Valor | Mensaje |
|---|---|
booking_confirmation | Confirmación de la visita. |
visit_reminder | Recordatorio de la visita. |
on_my_way | Aviso de «en camino». |
quote | Cotización. |
quote_reminder | Recordatorio de cotización. |
sale_note | Nota de venta. |
sale_note_reminder | Recordatorio de nota de venta. |
job_report | Informe del trabajo. |
Adjunto
attachment.url es un enlace firmado de descarga del PDF, válido por 72 horas (expiresAt), más
que todo el ciclo de reintentos. Descárgalo o envíalo antes de que venza; no lo guardes como enlace
permanente.
Recomendaciones
- Verifica la firma antes de enviar nada.
- Deduplica por
data.id: el mismo mensaje puede llegar más de una vez. - Responde 2xx apenas recibas el evento y envía el WhatsApp después; si tu proveedor falla, reintenta de tu lado.
- Trata el payload como dato personal: los eventos quedan guardados 30 días en Kellu y el registro de entregas nunca muestra su contenido.