Webhook por conversación
Configurá una URL HTTPS para que Agentify avise a un sistema externo en cada mensaje inbound nuevo
1
Abrir la conversación
En Inbox, seleccioná el chat 1:1 (o el que quieras cablear). El webhook es por conversación, no por tenant.
2
Completar URL y secreto
En el panel derecho (Info), expandí Webhook saliente. Pegá una URL https:// y un secreto. Para Cursor/Grok, el secreto es el valor del header Authorization del panel de la rutina (<code>crsr_…</code>), no la webhook key. Agentify nunca vuelve a mostrar el secreto ni inventa un token.
3
Elegir cómo viaja el secreto
Si hay secreto, Agentify siempre manda Authorization: Bearer. En hosts de Cursor (<code>api2.cursor.sh</code>) no se agrega sender_key ni X-Webhook-Key (eso devolvía HTTP 400). En sinks genéricos podés activar esos extras. Guardá.
4
Qué se dispara
Agentify hace POST de cada mensaje inbound nuevo del cliente (WhatsApp Evolution y WhatsApp Cloud / WABA; también Instagram y Facebook si el mensaje entra por el mismo insert). No se dispara en respuestas salientes, notas internas ni sincronización de historial.
5
Cuerpo del POST
JSON: <code>conversationId</code>, <code>contactId</code>, <code>phone</code>, <code>name</code>, <code>messageId</code>, <code>eventId</code> (igual a <code>messageId</code>), <code>text</code>, <code>timestamp</code>, <code>direction</code> (siempre <code>inbound</code>). Cursor recibe el mismo JSON con <code>Content-Type: application/json</code> y solo el header Bearer.
6
Cómo probar
Usá un sink HTTPS descartable (por ejemplo webhook.site). Guardalo en el chat, mandá un WhatsApp inbound de prueba y confirmá un solo POST. Una respuesta tuya o una nota interna no deben llegar al sink. No apuntes tests a URLs de producción de terceros.
Preguntas frecuentes
¿Puedo usar HTTP o localhost?
No. Solo HTTPS. Localhost e IPs privadas están bloqueadas (la misma validación SSRF que el nodo HTTP de automatizaciones).
¿Si el webhook falla se pierde el mensaje en Inbox?
No. El POST se agenda después de guardar el mensaje. Un timeout o error HTTP no bloquea el inbox. 429/5xx se reintentan en el mismo path de entrega.
¿Esto reemplaza las automatizaciones por palabra clave?
No. Las automatizaciones siguen siendo a nivel tenant (nueva conversación / keyword). Este webhook es por chat y se dispara en cada inbound nuevo, también en modo humano.