Agentify
Agentify
  • Bandeja Unificada
  • Responder mensajes
  • Transcripción de audios
  • Intervenir al agente
  • Archivar conversaciones
  • Sincronizar mensajes
  • Webhook por conversación
  • Chats internos
Volver al inicio
Docs/Inbox/Webhook por conversación

Webhook por conversación

Configurá una URL HTTPS para que Agentify avise a un sistema externo en cada mensaje inbound nuevo

  1. 01Abrir 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. 02Completar 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. 03Elegir 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. 04Qué 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. 05Cuerpo 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. 06Có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.

Artículos relacionados

  • Bandeja Unificadaen Inbox
  • Responder mensajesen Inbox
AnteriorSincronizar mensajesSiguienteChats internos

En esta guía

  1. Abrir la conversación
  2. Completar URL y secreto
  3. Elegir cómo viaja el secreto
  4. Qué se dispara
  5. Cuerpo del POST
  6. Cómo probar