Whatsable
Webhook personalizado
Crea el endpoint, activa los mensajes salientes y la respuesta llega a tu servidor como un POST normal. https://whatsable.app/integrations/webhook
WebhooksGuía práctica
¿Una respuesta en la app de WhatsApp Business dispara un webhook?
Sí. Una respuesta que escribes en la app de WhatsApp Business igual envía un POST a tu webhook. Conservas la app en el teléfono. El número sigue siendo el mismo.
Los mensajes salientes deben estar activados para ese destino. Si están desactivados, el contacto recibe la respuesta igual, pero tu webhook nunca la ve.
¿Cómo activo los mensajes salientes?
Elige adónde debe llegar la respuesta: un webhook que creaste, n8n, Zapier o Make.
- 1Elige adónde debe llegar la respuesta: un webhook que creaste, n8n, Zapier o Make.
- 2Abre el panel de Whatsable. Ve a Desarrollador, agrega un endpoint y activa los mensajes salientes. Un webhook personalizado necesita
outgoing: true. - 3Escribe una respuesta de prueba en la app de WhatsApp Business. Luego busca el POST en el destino. Si no llega nada, lo más probable es que los mensajes salientes sigan desactivados en ese endpoint.
n8n
El nodo disparador de Whatsable se activa solo con mensajes entrantes. Para capturar una respuesta desde la app del teléfono, agrega un nodo Webhook de n8n y pega su URL en un webhook de Whatsable con los mensajes salientes activados. El artículo relacionado tiene los clics de n8n. https://whatsable.app/blog/trigger-n8n-scenarios-from-whatsapp-business-app https://whatsable.app/integrations/n8n
Zapier
Usa un catch hook de Webhooks by Zapier como webhook de Whatsable con los mensajes salientes activados. https://whatsable.app/integrations/zapier
Make
Usa un webhook personalizado de Make como webhook de Whatsable con los mensajes salientes activados. https://whatsable.app/integrations/make
Agent Skill
Una respuesta desde la app del teléfono solo llega a una Agent Skill si esa Skill está en un webhook que creaste con los mensajes salientes activados. Instalar una Skill no entrega el evento por sí solo. https://whatsable.app/vibe-code
¿Qué llega en el payload?
Cuando llega una respuesta desde la app del teléfono, tres campos coinciden. incoming_message es false. send_by es "WhatsApp App". was_message_by_human es true.
El mismo POST también incluye el resto de los campos oficiales del mensaje. Los significados de abajo coinciden con la página de campos del payload.
Revisa message_type (text, image, audio, video, document, location). En los audios, la transcripción aparece en los campos de texto cuando está disponible.
Notifyer es el valor de sistema de los mensajes enviados a través de Whatsable.
| Campo | Qué es |
|---|---|
phone_number | Número de WhatsApp del contacto de esta conversación (dígitos, a menudo sin +). En los eventos salientes, es la persona a la que escribió tu empresa. Puede llegar como número o como cadena. |
message_type | El tipo del último mensaje (text, image, audio, video, document o location). En los audios, la transcripción aparece en los campos de texto cuando está disponible. |
last_message_of_user | El último mensaje enviado por el usuario. |
last_message_of_bot | El último envío de la empresa, incluida una persona en el teléfono o en la bandeja. No solo un bot. |
last_messages | Mensajes recientes de la conversación (aproximadamente los últimos 20). En las entregas de webhook suele llegar como una cadena JSON: analízala antes de recorrerla. Cada elemento es de tipo user (el contacto) o bot (el último envío de la empresa, incluida una persona en el teléfono o en la bandeja). Incluye mensajes de la app de WhatsApp Business, la bandeja de Whatsable, las automatizaciones y las plantillas. |
last_messages.type | Tipo de remitente (user o bot). user es el contacto. bot es el último envío de la empresa, incluida una persona en el teléfono o en la bandeja. |
last_messages.content | Contenido del mensaje (vacío en los mensajes multimedia). En los audios, la transcripción aparece en los campos de texto cuando está disponible. |
last_messages.timestamp | Marca de tiempo ISO 8601 del momento en que se envió el mensaje. |
last_messages.content_type | Tipo de contenido (text, image, audio, video, document o location). |
last_messages.media_url | URL del archivo multimedia, si corresponde (válida durante 24 horas). |
conversation_paragraph | Resumen legible de la conversación reciente. |
recipient_name | El nombre del destinatario, si está disponible. |
user_id | Identificador único del usuario en tu sistema. |
user_last_message_time | Marca de tiempo Unix del último mensaje del usuario. |
bot_last_message_time | Marca de tiempo Unix del último mensaje de tu sistema. |
attachment_url | URL del archivo multimedia si el último mensaje contiene uno (null en los mensajes de texto). |
note | Campo de nota personalizado para agregar contexto. |
note_automation | Notas relacionadas con automatizaciones. |
labels | Etiquetas separadas por comas para clasificar la conversación. |
incoming_message | false en los mensajes salientes. Ausente en los mensajes entrantes del payload predeterminado. |
send_by | Qué sistema o persona envió un mensaje saliente. "WhatsApp App" cuando se escribió en la app de WhatsApp Business; "AI" cuando lo envió tu agente de IA; "Notifyer" en envíos desde la bandeja, la API, difusiones y automatizaciones. No aparece en los mensajes entrantes. |
was_message_by_human | was_message_by_human es false solo cuando tu agente de IA envió el mensaje (incluidos sus seguimientos); en todos los demás envíos es true. |
referral | Aparece en eventos entrantes de un anuncio o publicación de Click-to-WhatsApp, y se omite en chats normales y en la mayoría de los seguimientos. Consulta https://whatsable.app/click-to-whatsapp-ads. |
¿Cómo filtro una respuesta desde la app del teléfono?
Filtra para que incoming_message sea false, send_by sea "WhatsApp App" y was_message_by_human sea true.
¿Qué puedo construir con una respuesta desde la app del teléfono?
Un CRM que sabe que el dueño ya respondió.
Un registro de las respuestas del teléfono en una hoja de cálculo.
Una automatización posterior a una decisión humana.
¿Hay pruebas de que esto funciona?
Sí. YouTube: https://www.youtube.com/watch?v=njAxHZalMn4
Qué no es esto
Esto no es una verificación de la bandeja, una especificación de los campos de Click-to-WhatsApp ni un volcado del JSON de un cliente.
Fuentes
Fuentes
- Documentación de mensajes entrantes de Whatsable
- https://whatsable.app/integrations/webhook
- https://whatsable.app/integrations/n8n
- https://whatsable.app/integrations/zapier
- https://whatsable.app/integrations/make
- https://whatsable.app/vibe-code
- https://whatsable.app/blog/trigger-n8n-scenarios-from-whatsapp-business-app
- https://whatsable.app/click-to-whatsapp-ads