Documentación
API de la plataforma.md

Webhooks

Recibí eventos de tu cuenta en tu propia URL, en tiempo real. Base: https://panel.anunzi.net/api/v1/webhooks/.

Método Ruta Descripción
GET list.php Lista tus webhooks y los eventos disponibles.
POST set.php Crea o actualiza un webhook.
POST delete.php Elimina un webhook.

Eventos disponibles

  • lead.created — se creó un contacto.
  • lead.updated — se actualizó un contacto.
  • ticket.created — se creó un ticket de soporte.
  • call.finished — finalizó una llamada. (También podés recibirlo por agente con webhook_url en Agentes.)

Suscribirse

curl -X POST "https://panel.anunzi.net/api/v1/webhooks/set.php" \
  -H "Authorization: Bearer anz_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url":"https://tu.app/anunzi-webhook", "events":["lead.created","ticket.created"] }'

Al crear, se devuelve un secret una sola vez. Podés suscribirte a todo con "events":["*"].

Verificar la firma

Cada entrega incluye estos encabezados:

X-Anunzi-Event: lead.created
X-Anunzi-Signature: sha256=<hmac>

La firma es HMAC-SHA256 del cuerpo crudo usando tu secret. Verificala así (pseudocódigo):

firma_esperada = hmac_sha256(cuerpo_crudo, secret)
válida = ("sha256=" + firma_esperada) == header["X-Anunzi-Signature"]

Cuerpo del evento

{ "event": "lead.created", "data": { "id": 123, "name": "Ana", "phone": "+54911…" }, "sent_at": "2026-09-17T12:00:00Z" }

Respondé con 2xx. Las entregas son best-effort (sin reintentos garantizados en esta versión).

Esc