> ## Documentation Index
> Fetch the complete documentation index at: https://developer.omni.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks de canal

> Recibe los eventos de un canal concreto mediante webhooks

export const projectName = 'Omni Z-API';

## ¿Qué son los webhooks de canal?

Los webhooks de canal se asocian a un canal concreto mediante el `channelId` y reciben los eventos de ese canal: mensajes entrantes, estados de entrega y cambios de conexión.

Un mismo canal puede tener **varios webhooks** con configuraciones distintas; por ejemplo, uno para mensajes y otro para eventos de conexión.

<Note>
  Los conceptos comunes a los dos tipos de webhook (rol **ENTERPRISE**, autenticación, firma HMAC y formatos de payload) están en la [Introducción](/es/webhooks/introduction).
</Note>

## Eventos disponibles

| Evento                  | Cuándo se dispara                                             |
| ----------------------- | ------------------------------------------------------------- |
| `MESSAGE_RECEIVED`      | Se ha recibido un mensaje en el canal                         |
| `MESSAGE_DELIVERY`      | Confirmación de entrega de un mensaje enviado                 |
| `MESSAGE_STATUS`        | Actualización del estado de un mensaje (leído, fallido, etc.) |
| `RECEIVED_STATUS`       | Combinación de recepción y estado                             |
| `RECEIVED_AND_DELIVERY` | Combinación de recepción y entrega                            |
| `CONNECTED`             | El canal se ha conectado                                      |
| `DISCONNECTED`          | El canal se ha desconectado                                   |
| `PRESENCE_CHAT`         | Indicador de presencia o de escritura de un contacto          |
| `INITIAL_DATA`          | Sincronización inicial de datos al conectar el canal          |
| `BLOCK`                 | Evento de bloqueo de un contacto                              |

<Note>
  Los webhooks de canal **no** pueden suscribirse a eventos de plantilla (`422`). Para recibir los eventos de plantilla de WhatsApp, usa los [Webhooks de plantilla](/es/webhooks/template-webhooks).
</Note>

## Gestión

<CardGroup cols={2}>
  <Card title="Crear webhook" icon="plus" href="/es/webhooks/create-webhook">
    Registra un nuevo endpoint de webhook en un canal.
  </Card>

  <Card title="Listar webhooks" icon="list" href="/es/webhooks/list-webhooks">
    Consulta todos los webhooks de un canal.
  </Card>

  <Card title="Consultar webhook" icon="magnifying-glass" href="/es/webhooks/get-webhook">
    Busca un webhook concreto.
  </Card>

  <Card title="Actualizar webhook" icon="pen" href="/es/webhooks/update-webhook">
    Actualiza la URL, los eventos, la autenticación o el estado.
  </Card>

  <Card title="Eliminar webhook" icon="trash" href="/es/webhooks/delete-webhook">
    Elimina un webhook de un canal.
  </Card>

  <Card title="Estructura de los payloads" icon="brackets-curly" href="/es/webhooks/payloads">
    Ejemplos reales de los payloads que se reciben para cada tipo de mensaje.
  </Card>
</CardGroup>