> ## 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. # whatsapp.meta_business_agent.handover.updated > Ocurre cuando una devolución de llamada de traspaso admitida transfiere el control fuera de un Agent de la REST API pública. No confirma la asignación en Inbox. Usa `whatsapp.meta_business_agent.handover.updated` para gestionar este evento en tu endpoint de webhook. ## Desencadenadores Ocurre cuando una devolución de llamada de traspaso admitida transfiere el control fuera de un Agent de la REST API pública. No confirma la asignación en Inbox. Suscríbete a `whatsapp.meta_business_agent.handover.updated` cuando [configures tu endpoint de webhook](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md). Este evento está limitado a los Agents incorporados mediante la REST API pública. Informa de que el control se transfirió fuera del Agent. No confirma la asignación en Inbox. ## Sintaxis YCloud envía una solicitud HTTP `POST` a tu URL de webhook configurada. La siguiente estructura muestra una variante de carga útil. Los valores entre corchetes angulares son marcadores de posición; sus tipos se indican en **Parámetros**. Los campos opcionales y otras variantes se describen a continuación. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "", "type": "whatsapp.meta_business_agent.handover.updated", "apiVersion": "", "createTime": "", "whatsappMetaBusinessAgent": { "agentId": "", "metaAgentId": "", "phoneNumberId": "", "wabaId": "", "consumerPhoneNumber": "", "controlState": "", "actor": "", "reason": "", "timestamp": "" } } ``` ## Parámetros Valida el encabezado HTTP `YCloud-Signature` antes de procesar el cuerpo JSON. Consulta [validación de firmas](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md). ### Envoltorio del evento | Parámetro | Tipo | Obligatorio | Descripción | | - | - | - | - | | `id` | string | Sí | ID único para el evento. Longitud mínima: `6`. Longitud máxima: `128`. | | `type` | string | Sí | Siempre `whatsapp.meta_business_agent.handover.updated`. | | `apiVersion` | string | Sí | La versión de la API utilizada para generar este evento. | | `createTime` | string (date-time) | Sí | La hora a la que se creó este evento, formateada en [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). Por ejemplo, `2022-06-01T12:00:00.000Z`. | ### Carga útil del evento | Parámetro | Tipo | Obligatorio | Descripción | | - | - | - | - | | `whatsappMetaBusinessAgent` | object | Sí | Carga útil de `whatsappMetaBusinessAgent` específica del evento. | Los cuatro campos comunes del envoltorio son obligatorios. Los campos de la carga útil dependen de la variante del evento. En cada tabla de objetos, **Obligatorio** se aplica cuando su objeto padre está presente. Los campos opcionales se pueden omitir; una muestra no hace que un campo sea obligatorio. #### whatsappMetaBusinessAgent | Parámetro | Tipo | Obligatorio | Descripción | | - | - | - | - | | `agentId` | string | No | ID de Agent de YCloud. No es un ID de Agent de Meta ni un ID de cesionario de Inbox. | | `metaAgentId` | string | No | ID de Agent de Meta, cuando esté disponible. | | `phoneNumberId` | string | No | ID de número de teléfono comercial de Meta. No es un número de teléfono en formato E.164. | | `wabaId` | string | No | ID de cuenta de WhatsApp Business procedente de la devolución de llamada de origen, cuando esté disponible. | | `consumerPhoneNumber` | string | No | Número de teléfono del consumidor de la devolución de llamada de traspaso, normalizado a E.164 cuando esté disponible. No es el número comercial ni phoneNumberId.Patrón: `^+[1-9][0-9]{7,14}$`. | | `controlState` | string | No | Presente para eventos de traspaso. Actualmente APP\_CONTROL\_TAKEN para devoluciones de llamada de traspaso de la REST API pública. No confirma una asignación en Inbox ni la entrega del mensaje. | | `actor` | string | No | Actor de origen de traspaso opcional. Para una transferencia de tipo control\_passed, este es el ID de la aplicación propietaria anterior, no el empleado que recibe la conversación. | | `reason` | string | No | Motivo o metadatos de traspaso opcionales del proveedor, por ejemplo customer\_request. No es un enum cerrado. | | `timestamp` | integer (int64) | No | Hora del evento de origen en milisegundos Unix, o tiempo de procesamiento si no está disponible. | ## Ejemplo El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos. APP\_CONTROL\_TAKEN informa de la transferencia de control, no de la asignación de un empleado de Inbox ni de la entrega de un mensaje de transferencia personalizado. actor es el ID de la aplicación propietaria anterior en este ejemplo. ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "id": "evt_example_agent_handover", "type": "whatsapp.meta_business_agent.handover.updated", "apiVersion": "v2", "createTime": "2026-09-09T02:00:04.000Z", "whatsappMetaBusinessAgent": { "agentId": "00000000-0000-4000-8000-000000000001", "metaAgentId": "META_AGENT_ID", "phoneNumberId": "PHONE_NUMBER_ID", "wabaId": "WABA_ID", "consumerPhoneNumber": "+12025550124", "controlState": "APP_CONTROL_TAKEN", "actor": "PREVIOUS_OWNER_APP_ID", "reason": "customer_request", "timestamp": 1788919204000 } } ``` Tras verificar la firma y aceptar de forma duradera el evento, devuelve una respuesta `2xx`. Procesa el trabajo lento de forma asíncrona. ```http theme={"theme":{"light":"github-light","dark":"github-dark"}} HTTP/1.1 200 OK ``` Para consultar tutoriales paso a paso de situaciones, consulta los [ejemplos anotados](https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.