Está tardando más de lo normal. Tu conexión parece débil.
KelluDesarrolladores
Referencia interactivaOpenAPIManual UTCP

Guías

  • Inicio
  • Inicio rápido
  • Autenticación
  • Permisos
  • Paginación y errores
  • Recursos y operaciones
  • Webhooks
  • WhatsApp por webhook
  • Agentes de IA, OpenAPI y UTCP
  • Conector de IA (Claude y ChatGPT)
  • Guía: usar Kellu desde Claude y ChatGPT
  • Kellu AI connector: user guide (English)

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

  1. Crea un endpoint de webhook activo suscrito a whatsapp.message_requested.
  2. 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:

CampoDescripción
idId del mensaje (wamsg_…). Es el mismo en reintentos y reenvíos: deduplica por él.
kindTipo de mensaje (tabla abajo).
automatictrue si es un recordatorio automático; false si alguien lo envió desde Kellu.
to.phoneTelé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.nameNombre del destinatario.
textMensaje 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.
variablesLos valores crudos con que se armó el texto, por si prefieres tu propia plantilla.
attachment{ url, filename, expiresAt } con el PDF, o null.
actionUrlEnlace a la página de pago o al portal de clientes, o null.
workOrderId, visitId, documentId, documentVersionIdIds relacionados (null si no aplican).

kind

ValorMensaje
booking_confirmationConfirmación de la visita.
visit_reminderRecordatorio de la visita.
on_my_wayAviso de «en camino».
quoteCotización.
quote_reminderRecordatorio de cotización.
sale_noteNota de venta.
sale_note_reminderRecordatorio de nota de venta.
job_reportInforme 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.