> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-la-plataforma/webhooks.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*](/anunzi-ia-documentation/api-de-la-plataforma/agents.md)*.)*

## Suscribirse

```bash
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

```json
{ "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).