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

# Eventos

> Lista completa de eventos disponibles para webhooks

# Eventos Disponibles

Puedes suscribirte a cualquiera de estos eventos al crear o actualizar tu webhook.

***

## Mensajes

Eventos relacionados con el envío y recepción de mensajes.

| Evento              | Descripción                              |
| ------------------- | ---------------------------------------- |
| `message.received`  | Un cliente envió un mensaje              |
| `message.sent`      | Un mensaje fue enviado (manual o por IA) |
| `message.delivered` | WhatsApp confirmó la entrega             |
| `message.read`      | El cliente leyó el mensaje               |
| `message.failed`    | El mensaje no se pudo enviar             |

<Tip>
  El evento `message.received` incluye el mensaje en formato Meta original. Ver [Payloads](/api-reference/webhooks/payloads) para detalles.
</Tip>

***

## Conversaciones

Eventos relacionados con la gestión de conversaciones.

| Evento                    | Descripción                       |
| ------------------------- | --------------------------------- |
| `conversation.created`    | Nueva conversación iniciada       |
| `conversation.assigned`   | Conversación asignada a un agente |
| `conversation.unassigned` | Conversación desasignada          |
| `conversation.closed`     | Conversación cerrada              |

***

## Contactos

Eventos relacionados con la gestión de contactos.

| Evento            | Descripción           |
| ----------------- | --------------------- |
| `contact.created` | Nuevo contacto creado |
| `contact.updated` | Contacto actualizado  |
| `contact.deleted` | Contacto eliminado    |

***

## Broadcasts (Remarketing)

Eventos relacionados con envíos masivos.

| Evento                | Descripción          |
| --------------------- | -------------------- |
| `broadcast.sent`      | Broadcast iniciado   |
| `broadcast.completed` | Broadcast completado |
| `broadcast.failed`    | Broadcast falló      |

***

## Wildcard

Para suscribirte a **todos** los eventos, usa el wildcard:

| Evento | Descripción              |
| ------ | ------------------------ |
| `*`    | Recibe todos los eventos |

<Warning>
  El wildcard puede generar un alto volumen de requests. Úsalo con precaución.
</Warning>

***

## Ejemplo de Suscripción

```bash theme={null}
curl -X POST https://api.whaapy.com/user-webhooks \
  -H "Authorization: Bearer wha_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Todos los mensajes",
    "url": "https://mi-servidor.com/webhooks",
    "events": ["message.received", "message.sent", "message.delivered", "message.read"]
  }'
```

***

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Estructura de Payloads" icon="code" href="/api-reference/webhooks/payloads">
    Ver qué datos recibes en cada evento
  </Card>

  <Card title="Gestión de Webhooks" icon="gear" href="/api-reference/webhooks/management">
    Actualizar eventos suscritos
  </Card>
</CardGroup>