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

# Ejemplos de Webhook

> Explore guías paso a paso de webhooks específicos para cada evento, requisitos previos y ejemplos de payload.

<Note>Para consultar el catálogo exhaustivo derivado del esquema, consulte [todos los ejemplos](/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Qué es

Explore guías paso a paso de webhooks específicos para cada evento, requisitos previos y ejemplos de payload.

## Antes de comenzar

* Cree un endpoint HTTPS público en su aplicación.
* Configure un endpoint de webhook de YCloud para los tipos de eventos que necesite.
* Guarde el secreto de firma del endpoint de forma segura.
* Haga que el procesamiento de eventos sea idempotente.

## Cómo funciona

YCloud envía una solicitud HTTP `POST` cuando ocurre el evento. Verifique la firma, registre el evento de forma duradera, devuelva una respuesta `2xx` y procese las tareas lentas de forma asíncrona.

## Solicitud

Los escenarios a continuación muestran las solicitudes entregadas a su URL de webhook. Trate el `id` del evento como el identificador de entrega y use `type` para enrutar el payload.

## Respuesta

Devuelva un estado `2xx` tras aceptar el evento.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Para la configuración de endpoints, la validación de firmas y el comportamiento de reintentos, consulte [Configurar webhooks](/es/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

## Eventos de mensajes y plantillas

<CardGroup cols={2}>
  <Card title="Revisión de plantillas" icon="rectangle-list" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-template-reviewed-webhook-examples">
    Gestione estados de plantilla aprobados, rechazados, pausados, deshabilitados y archivados.
  </Card>

  <Card title="Estado del mensaje" icon="message-check" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-message-updated-webhook-examples">
    Gestione mensajes salientes enviados, entregados, leídos y fallidos.
  </Card>

  <Card title="Mensajes entrantes" icon="inbox" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-inbound-message-webhook-examples">
    Analice mensajes de texto, multimedia, ubicación, contacto, interactivos, de comercio y del sistema.
  </Card>

  <Card title="Actualizaciones de pagos" icon="credit-card" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-payment-updated-webhook-examples">
    Procese cambios en las transacciones de pago de WhatsApp.
  </Card>
</CardGroup>

## Eventos de eco y transferencia de agentes

Para los agentes incorporados a través de la API REST pública, utilice estas guías específicas para cada evento.
Los agentes creados desde la consola utilizan un flujo de sincronización de bandeja de entrada independiente.

<CardGroup cols={2}>
  <Card title="Mensaje de eco creado" icon="clone" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-created">
    Almacene ecos salientes de texto y multimedia.
  </Card>

  <Card title="Mensaje de eco actualizado" icon="message-check" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-updated">
    Gestione actualizaciones de estado de entregado, leído, enviado tarde y fallido.
  </Card>

  <Card title="Transferencia de agente actualizada" icon="arrow-right-arrow-left" href="/en/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated">
    Observe la transferencia de control y comprenda sus límites de correlación.
  </Card>
</CardGroup>

## Eventos de cuenta, aplicación y Flow

<CardGroup cols={2}>
  <Card title="Actualizaciones de cuenta comercial" icon="building" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-business-account-updated-webhook-examples">
    Gestione cambios de elegibilidad, ubicación, infracciones, restricciones y estado de la cuenta.
  </Card>

  <Card title="Historial de Business App" icon="clock-rotate-left" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-business-app-history-message-webhook-examples">
    Sincronice el historial de mensajes entrantes y salientes.
  </Card>

  <Card title="Ecos de mensajes de Business App" icon="clone" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-business-app-sent-message-sync-webhook-examples">
    Sincronice los mensajes enviados desde la aplicación WhatsApp Business.
  </Card>

  <Card title="Estado de Flow" icon="diagram-project" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-flow-webhook-examples">
    Procese cambios de estado en el ciclo de vida de Flow.
  </Card>
</CardGroup>

## Eventos de llamadas y grupos

<CardGroup cols={2}>
  <Card title="Conexión de llamada" icon="phone" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-connect-webhook-examples">
    Gestione ofertas y respuestas SDP para llamadas de WhatsApp.
  </Card>

  <Card title="Estado de llamada" icon="phone-volume" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-status-update-webhook-examples">
    Gestione estados de llamada sonando, aceptada y rechazada.
  </Card>

  <Card title="Finalización de llamada" icon="phone-slash" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-calling-terminate-webhook-examples">
    Gestione la finalización de llamadas completadas y fallidas.
  </Card>

  <Card title="Ciclo de vida del grupo" icon="users" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-group-lifecycle-update-webhook-examples">
    Gestione la creación y eliminación de grupos.
  </Card>

  <Card title="Participantes del grupo" icon="user-plus" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-group-participants-update-webhook-examples">
    Gestione cambios de participantes y solicitudes de unión.
  </Card>

  <Card title="Configuración del grupo" icon="users-gear" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-group-settings-update-webhook-examples">
    Gestione cambios en el asunto y la descripción del grupo.
  </Card>

  <Card title="Estado del grupo" icon="circle-exclamation" href="/es/api-reference/guides/examples/webhook-examples/whatsapp-group-status-update-webhook-examples">
    Gestione la suspensión y el restablecimiento de grupos.
  </Card>
</CardGroup>

## Eventos de contacto

<CardGroup cols={2}>
  <Card title="Contacto creado" icon="user-plus" href="/es/api-reference/guides/examples/webhook-examples/contact-created-webhook-examples">
    Procese contactos recién creados.
  </Card>

  <Card title="Contacto eliminado" icon="user-minus" href="/es/api-reference/guides/examples/webhook-examples/contact-deleted-webhook-examples">
    Elimine o concilie contactos eliminados.
  </Card>

  <Card title="Atributos de contacto modificados" icon="pen-to-square" href="/es/api-reference/guides/examples/webhook-examples/contact-attributes-changed-webhook-examples">
    Procese cambios de perfil, atributos personalizados y etiquetas.
  </Card>

  <Card title="Contacto dado de baja" icon="user-slash" href="/es/api-reference/guides/examples/webhook-examples/contact-unsubscribe-created-webhook-examples">
    Gestione registros de exclusión voluntaria recién creados.
  </Card>

  <Card title="Contacto suscrito de nuevo" icon="user-check" href="/es/api-reference/guides/examples/webhook-examples/contact-unsubscribe-deleted-webhook-examples">
    Gestione registros de exclusión voluntaria eliminados.
  </Card>
</CardGroup>

<Card title="Abrir el catálogo completo de payloads" icon="brackets-curly" href="/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples">
  Explore cada tipo de evento y todos los ejemplos de payload nombrados de la especificación OpenAPI.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.