> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos de webhooks

> Recibe un POST cuando cambia un mensaje, conversación o miembro del chat in-app.

<Tip>
  La API **pregunta**; el webhook **avisa**. Sirve para CRM, Inbox y métricas sin polling.
</Tip>

Los eventos `chat.*` son **solo chat in-app**. `instanceId` va **vacío**. Activa los eventos en el webhook: el Chat **siempre** dispara si el webhook está inscrito. Configuración: [Webhooks](/es/guides/webhooks/index). HMAC: [Seguridad de webhooks](/es/guides/webhooks/seguranca).

```json theme={null}
{
  "event": "chat.received",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-09-05T14:30:00.000Z",
  "data": {
    "chatAppId": "clxxapp...",
    "conversationId": "clxxconv...",
    "messageId": "clxxmsg...",
    "message": { "id": "clxxmsg...", "type": "TEXT", "body": "Hola" }
  }
}
```

Headers: `X-Notifique-Signature`, `X-Notifique-Timestamp`, `X-Workspace-Id`, `X-Webhook-Event`.

**2xx** en \~10 s entrega; **4xx / 5xx / timeout** reintenta (5 min, 30 min, 2 h).

| Evento                                              | Cuándo                   |
| --------------------------------------------------- | ------------------------ |
| `chat.received`                                     | Mensaje de un `USER`     |
| `chat.sent`                                         | Mensaje de un `AGENT`    |
| `chat.message.deleted`                              | Mensaje borrado          |
| `chat.conversation.created` / `updated` / `deleted` | Ciclo de la conversación |
| `chat.member.added` / `chat.member.removed`         | Miembros                 |
| `chat.user.blocked` / `chat.user.unblocked`         | Bloqueo entre usuarios   |

## Próximos pasos

* [Introducción](/es/chat-api/como-funciona/introducao)
* [Quick Start](/es/chat-api/como-funciona/quick-start)