> ## 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

> Encuentra activadores, sintaxis del payload, parámetros y ejemplos para cada evento de webhook de YCloud.

Busca un evento por su `type` exacto. Cada referencia incluye **Activadores**, **Sintaxis**, **Parámetros** y **Ejemplo**. Esta referencia cubre los 47 tipos de eventos del contrato de webhook de YCloud.

YCloud entrega su propio sobre (envelope) de eventos. Utiliza los nombres de eventos y los campos en estas páginas cuando te integres con YCloud.

Antes de recibir eventos, [configura un endpoint de webhook](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md), suscríbete a los tipos de eventos que necesites y valida el encabezado `YCloud-Signature`.

Utiliza los payloads de ejemplo en cada página de evento para probar tu receptor.

## Sobre común

Cada evento incluye `id`, `type`, `apiVersion` y `createTime`. Enruta por `type` y deduplica por el `id` del evento. Los campos del payload específicos varían según el evento y el escenario.

Verifica la firma y acepta el evento de forma duradera antes de devolver una respuesta `2xx`. Para reintentos y configuración del receptor, consulta [Configurar webhooks](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md).

## Messenger

| Tipo de evento | Activador |
| - | - |
| [`messenger.inbound_message.received`](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-inbound-message-received) | Ocurre cuando se recibe un mensaje de texto ordinario de Messenger procedente de un cliente. |
| [`messenger.inbound_message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-inbound-message-updated) | Ocurre cuando un cliente edita un mensaje de texto entrante guardado de Messenger. |
| [`messenger.message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-message-updated) | Ocurre cuando está disponible una instantánea guardada de un mensaje saliente ordinario de Messenger, incluidos los resultados del envío y los recibos asociados. |
| [`messenger.message_reaction.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/messenger-message-reaction-updated) | Ocurre cuando un cliente reacciona a un mensaje de Messenger o elimina una reacción. |

## Mensajes de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.inbound_message.received`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-inbound-message-received) | Ocurre cuando se recibe un mensaje entrante de WhatsApp. |
| [`whatsapp.message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-message-updated) | Ocurre cuando se actualiza el estado de un mensaje saliente de WhatsApp y el estado cambia a `sent`, `failed`, `delivered` o `read`. |
| [`whatsapp.user.preferences`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-user-preferences) | Ocurre cuando un usuario de WhatsApp detiene los mensajes de marketing o reanuda los mensajes de marketing. |

## Plantillas de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.template.category_updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-category-updated) | Ocurre cuando se actualiza la categoría de una plantilla de WhatsApp. |
| [`whatsapp.template.correct_category_detection`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-correct-category-detection) | Ocurre cuando Meta detecta contenido que no es de utilidad en Utility Direct Send. Suscríbete mediante la API de endpoints de webhook. |
| [`whatsapp.template.quality_updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-quality-updated) | Ocurre cuando se actualiza la calificación de calidad de una plantilla de WhatsApp. |
| [`whatsapp.template.reviewed`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-template-reviewed) | Ocurre cuando una plantilla de WhatsApp recibe una actualización de revisión o ciclo de vida, incluyendo aprobación, rechazo, pausa, desactivación, archivado y desarchivado. |

## Cuentas de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.business_account.deleted`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-deleted) | Ocurre cuando se elimina una cuenta de WhatsApp Business. |
| [`whatsapp.business_account.reviewed`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-reviewed) | Ocurre cuando se ha revisado una cuenta de WhatsApp Business. |
| [`whatsapp.business_account.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-business-account-updated) | Ocurre cuando se produce una infracción de políticas, se suspende una cuenta de WhatsApp Business y más. |

## Números de teléfono de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.phone_number.deleted`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-deleted) | Ocurre cuando se elimina un número de teléfono comercial de WhatsApp. |
| [`whatsapp.phone_number.name_updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-name-updated) | Ocurre cuando el nombre de un número de teléfono comercial de WhatsApp ha sido aprobado o rechazado. |
| [`whatsapp.phone_number.quality_updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-quality-updated) | Ocurre cuando se actualiza la calidad, el límite de mensajería o el estado de conexión de la cuenta de un número de teléfono comercial de WhatsApp. |
| [`whatsapp.phone_number.business_username_updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-phone-number-business-username-updated) | Ocurre cuando se actualiza el Business Username de un número de teléfono comercial de WhatsApp. |

## WhatsApp Business App

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.smb.history`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-history) | Ocurre cuando se sincroniza el historial de mensajes de WhatsApp Business App. |
| [`whatsapp.smb.message.created`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-message-created) | Ocurre cuando se envía un mensaje desde WhatsApp Business App. |
| [`whatsapp.smb.message.echoes`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-smb-message-echoes) | Se produce cuando un mensaje enviado desde WhatsApp Business App se sincroniza como un eco. |

## WhatsApp Agents

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.echo_message.created`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-echo-message-created) | Se produce cuando se registra un mensaje de eco saliente para un Public REST API Agent. |
| [`whatsapp.echo_message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-echo-message-updated) | Se produce cuando se recibe un estado de eco saliente para un Public REST API Agent; también se pueden entregar estados tardíos de menor prioridad. |
| [`whatsapp.meta_business_agent.handover.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-meta-business-agent-handover-updated) | Se produce cuando una devolución de llamada de transferencia compatible transfiere el control fuera de un Public REST API Agent. No confirma la asignación en Inbox. |

## Llamadas de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.call.connect`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-connect) | Se produce cuando una llamada entrante proporciona una oferta SDP o una llamada iniciada por la empresa proporciona una respuesta SDP. |
| [`whatsapp.call.terminate`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-terminate) | Se produce cuando finaliza una llamada de WhatsApp. |
| [`whatsapp.call.status.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-status-updated) | Se produce cuando se actualiza el estado de una llamada de WhatsApp. |
| [`whatsapp.call.recording.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-recording-updated) | Se produce cuando la grabación de una llamada de WhatsApp procedente de la API pasa a estar disponible o falla permanentemente. |
| [`whatsapp.call.transcription.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-call-transcription-updated) | Se produce cuando la transcripción de una llamada de WhatsApp procedente de la API pasa a estar disponible o falla permanentemente. |

## Grupos de WhatsApp

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.group.lifecycle_update`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-lifecycle-update) | Se produce cuando se crea o elimina un grupo de WhatsApp, incluidos los resultados correctos y fallidos. |
| [`whatsapp.group.participants_update`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-participants-update) | Se produce cuando se actualizan los participantes o las solicitudes de unión de un grupo de WhatsApp. |
| [`whatsapp.group.settings_update`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-settings-update) | Se produce cuando se actualiza la configuración de un grupo de WhatsApp, incluidos los resultados correctos y fallidos. |
| [`whatsapp.group.status_update`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-group-status-update) | Se produce cuando se actualiza el estado de suspensión de un grupo de WhatsApp. |

## WhatsApp Flows y pagos

| Tipo de evento | Activador |
| - | - |
| [`whatsapp.flow.status_change`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-flow-status-change) | Se produce cuando se actualiza el estado de un flow de WhatsApp. |
| [`whatsapp.payment.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/whatsapp-payment-updated) | Se produce cuando cambia una transacción de pago de WhatsApp. |

## Contactos

| Tipo de evento | Activador |
| - | - |
| [`contact.attributes_changed`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-attributes-changed) | Se produce cuando se modifican los atributos de un contacto. |
| [`contact.created`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-created) | Se produce cuando se crea un contacto. |
| [`contact.deleted`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-deleted) | Se produce cuando se elimina un contacto. |
| [`contact.unsubscribe.created`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-unsubscribe-created) | Se produce cuando un contacto cancela su suscripción a los mensajes. |
| [`contact.unsubscribe.deleted`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-unsubscribe-deleted) | Se produce cuando un contacto reanuda su suscripción a los mensajes. |
| [`contact.note.created`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-created) | Se produce cuando se crea una nota de contacto. |
| [`contact.note.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-updated) | Se produce cuando se actualiza una nota de contacto. |
| [`contact.note.deleted`](https://docs.ycloud.com/es/api-reference/webhook-reference/contact-note-deleted) | Se produce cuando una nota de contacto se elimina de forma independiente. La eliminación del contacto no emite este evento para las notas en cascada. |

## Email, SMS y Voice

| Tipo de evento | Activador |
| - | - |
| [`email.delivery.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/email-delivery-updated) | Se produce cuando se actualiza el estado de entrega de un correo electrónico y el estado cambia a `delivered` o `failed`. |
| [`sms.message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/sms-message-updated) | Se produce cuando se actualiza el estado de un mensaje SMS y el estado cambia a `delivered` o `undelivered`. |
| [`sms.inbound.received`](https://docs.ycloud.com/es/api-reference/webhook-reference/sms-inbound-received) | Se produce cuando se recibe un mensaje SMS entrante, lo que significa que un usuario responde a tu mensaje. |
| [`voice.message.updated`](https://docs.ycloud.com/es/api-reference/webhook-reference/voice-message-updated) | Se produce cuando se actualiza el estado de un mensaje de voz y el estado cambia a `delivered` o `undelivered`. |


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