Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.
Qué es
Suscríbete a whatsapp.meta_business_agent.handover.updated.Recibes este evento cuando YCloud procesa una devolución de llamada (callback) de traspaso/control admitida para un Meta Business Agent creado mediante API. Informa de la transferencia de control, no del resultado de una asignación en Inbox ni de un mensaje personalizado de traspaso.A diferencia de los dos eventos Echo, este evento conserva intencionadamente el objeto
whatsappMetaBusinessAgent porque los metadatos del agente y del control forman parte
del contrato de traspaso.
Todos los ejemplos utilizan identificadores de marcadores de posición. Enruta mediante el type externo y lee
whatsappMetaBusinessAgent, no whatsappMessage, whatsappEchoMessage ni data.Desduplica las entregas repetidas con el id externo. El timestamp anidado
es un número entero en milisegundos Unix; createTime es una cadena RFC 3339.
controlState es actualmente APP_CONTROL_TAKEN para las devoluciones de llamada de traspaso de agentes de API admitidas.
consumerPhoneNumber procede del sender.phone_number de la devolución de llamada de traspaso y se normaliza a E.164 cuando es válido. No es el número del negocio ni phoneNumberId.
El contrato de traspaso actual no expone recipientUserId ni parentRecipientUserId. La identidad ausente del consumidor no se recupera a partir de una devolución de llamada de mensaje cercana.
Para el siguiente ejemplo control_passed, actor identifica la app propietaria anterior, no al empleado receptor.
reason son metadatos opcionales del proveedor. Trátalo como una cadena abierta, no como un enum fijo.
Esta no es una notificación para cada solicitud de take, release, Set Live o Set Draft. Las devoluciones de llamada de control procesadas mientras el agente está en Draft se ignoran.
La carga útil no inventa una identidad de consumidor. consumerPhoneNumber se omite cuando la devolución de llamada no proporciona un número de teléfono válido y no se infiere ningún BSUID a partir de mensajes adyacentes. phoneNumberId identifica el número de la empresa, que puede atender a muchos clientes.
No consideres este evento como prueba de que se haya asignado un empleado o de que se haya enviado o entregado un mensaje personalizado de traspaso.
Solicitud
YCloud envía estos cuerpos JSON en solicitudes HTTP POST a tu URL de webhook configurada.
Respuesta
Devuelve una respuesta 2xx tras aceptar el evento de forma duradera. Procesa las tareas lentas de forma asíncrona.
El agente traspasa el control a tu aplicación
Solicitud
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 traspaso personalizado. actor es el ID de la app propietaria anterior en este ejemplo.
Usa consumerPhoneNumber para correlacionar la transición de control con el consumidor cuando esté presente. No infieras una asignación de Inbox ni la entrega de un mensaje a partir de este evento.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"YCloud Docs","description":"YCloud product documentation, API reference, and webhook payload documentation.","colors":{"primary":"#602DED","light":"#FD4C7D","dark":"#1a1e22"},"logo":{"light":"https://mintcdn.com/lchnan/AXn0jsI-c5aPnOMW/logo/light.png?fit=max\u0026auto=format\u0026n=AXn0jsI-c5aPnOMW\u0026q=85\u0026s=0865e4207d765d07a769c29bc819adbe","dark":"https://mintcdn.com/lchnan/AXn0jsI-c5aPnOMW/logo/dark.png?fit=max\u0026auto=format\u0026n=AXn0jsI-c5aPnOMW\u0026q=85\u0026s=1bafffbe886c0ac13b0409dc90d446f8","href":"https://www.ycloud.com"},"favicon":"https://mintcdn.com/lchnan/AXn0jsI-c5aPnOMW/favicon.png?fit=max\u0026auto=format\u0026n=AXn0jsI-c5aPnOMW\u0026q=85\u0026s=1eed9e0b562f4b06368d2b8185b801b4","api":{"openapi":["openapi/endpoints/ycloud-api-v2.yaml","openapi/webhooks/testing-webhooks.yaml"],"params":{"expanded":"closed"},"playground":{"display":"interactive"},"examples":{"defaults":"required","prefill":true,"autogenerate":false},"url":"full"},"background":{"color":{"light":"#ffffff"}},"navbar":{"links":[{"href":"https://www.ycloud.com/customer-support","label":"Support"},{"href":"https://www.ycloud.com/pricing","label":"Pricing"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.ycloud.com/console"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"icons":{"library":"fontawesome"},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"navigation":{"languages":[{"language":"en","default":true,"href":"en/documentation/overview"},{"language":"zh","href":"zh/documentation/overview"},{"language":"es","href":"es/documentation/overview"},{"language":"pt","href":"pt/documentation/overview"},{"language":"ru","href":"ru/documentation/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lchnan","hasAudioNarration":false,"actualSubdomain":"lchnan","customDomains":["docs.ycloud.com"],"gitSource":{"type":"github","owner":"ycloud-developers","repo":"ycloud_docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afd4be1fb8413c882495e92","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"en","tag":"Documentation","count":245},{"language":"es","tag":"Documentación","count":244},{"language":"pt","tag":"Documentação","count":244},{"language":"ru","tag":"Документация","count":244},{"language":"zh","tag":"产品文档","count":244},{"language":"default","tag":"API Reference","count":168},{"language":"default","tag":"Endpoints","count":168},{"language":"en","tag":"API Reference","count":91},{"language":"es","tag":"Referencia de la API","count":91},{"language":"pt","tag":"Referência da API","count":91},{"language":"ru","tag":"Справочник API","count":91},{"language":"zh","tag":"API 参考","count":91},{"language":"default","tag":"Meta Business Agent","count":63},{"language":"en","tag":"Channels","count":60},{"language":"es","tag":"Gestión de cuentas de WhatsApp","count":54},{"language":"pt","tag":"Gerenciamento de contas do WhatsApp","count":54},{"language":"ru","tag":"Управление аккаунтами WhatsApp","count":54},{"language":"zh","tag":"WhatsApp 账号管理","count":54},{"language":"en","tag":"Webhook reference","count":47},{"language":"es","tag":"Webhook reference","count":47},{"language":"pt","tag":"Webhook reference","count":47},{"language":"ru","tag":"Webhook reference","count":47},{"language":"zh","tag":"Webhook reference","count":47},{"language":"en","tag":"Integrations","count":43},{"language":"es","tag":"Integraciones","count":43},{"language":"pt","tag":"Integrações","count":43},{"language":"ru","tag":"Интеграции","count":43},{"language":"zh","tag":"集成","count":43},{"language":"default","tag":"Configure","count":43},{"language":"en","tag":"WhatsApp Business Platform","count":41},{"language":"es","tag":"WhatsApp Business Platform","count":41},{"language":"pt","tag":"WhatsApp Business Platform","count":41},{"language":"ru","tag":"Платформа WhatsApp Business","count":41},{"language":"zh","tag":"WhatsApp 商业平台","count":41},{"language":"en","tag":"Guides","count":39},{"language":"es","tag":"Guías","count":39},{"language":"pt","tag":"Guias","count":39},{"language":"ru","tag":"Руководства","count":39},{"language":"zh","tag":"指南","count":39},{"language":"es","tag":"Canales","count":32},{"language":"pt","tag":"Canais","count":32},{"language":"ru","tag":"Каналы","count":32},{"language":"zh","tag":"渠道","count":32},{"language":"en","tag":"WhatsApp Accounts Management","count":28},{"language":"en","tag":"Agents","count":26},{"language":"es","tag":"Agentes","count":26},{"language":"pt","tag":"Agentes","count":26},{"language":"ru","tag":"Агенты","count":26},{"language":"zh","tag":"智能体","count":26},{"language":"en","tag":"Inbox","count":20},{"language":"es","tag":"Bandeja de entrada","count":20},{"language":"pt","tag":"Caixa de entrada","count":20},{"language":"ru","tag":"Входящие","count":20},{"language":"zh","tag":"收件箱","count":20},{"language":"default","tag":"WhatsApp Phone Numbers","count":16},{"language":"default","tag":"WhatsApp Groups","count":12},{"language":"default","tag":"Contacts","count":10},{"language":"default","tag":"Operate","count":10},{"language":"default","tag":"Connectors","count":10},{"language":"default","tag":"Onboard","count":9}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#page-title{font-size:2.25rem;font-weight:700;line-height:1.25;letter-spacing:-0.025em}#content.mdx-content{font-size:1rem;font-weight:400;line-height:1.625;color:var(--tw-prose-headings);margin-top:3rem}#content :where(h2,h3,h4):not(:where(.not-prose,.not-prose *)){font-weight:600;letter-spacing:-0.0125em}#content :where(h2):not(:where(.not-prose,.not-prose *)){font-size:1.875rem;line-height:1.2;margin-top:2.5rem;margin-bottom:1.25rem}#content>h2:first-child{margin-top:0}#content :where(h3):not(:where(.not-prose,.not-prose *)){font-size:1.5rem;line-height:1.333333;margin-top:2rem;margin-bottom:1rem}#content :where(h4):not(:where(.not-prose,.not-prose *)){font-size:1.125rem;line-height:1.5}#sidebar-content{border-right:1px solid color-mix(in srgb, currentColor 14%, transparent)}#sidebar .sidebar-group-header{font-size:0.75rem;line-height:1rem;letter-spacing:0.025em;text-transform:uppercase}#sidebar .sidebar-group{line-height:1.25rem}#sidebar a[aria-current=\"page\"]{border-radius:0;background:transparent;box-shadow:inset 2px 0 currentColor;font-weight:600;text-shadow:none}#table-of-contents h2 button{font-size:0.75rem;line-height:1rem;letter-spacing:0.025em;text-transform:uppercase}#table-of-contents-content{margin-top:0.75rem;border-left:1px solid color-mix(in srgb, currentColor 14%, transparent)}#table-of-contents-content a{padding:0.375rem 0 0.375rem calc(var(--toc-padding-left, 0rem) + 0.75rem);line-height:1.25rem;border-left:2px solid transparent;margin-left:-1px}#table-of-contents-content a[aria-current=\"location\"]{border-left-color:currentColor;text-shadow:none}#content:has(.direct-send-guide) :where(th,td){padding:0.5rem 0.75rem;font-size:0.875rem;line-height:1.5;vertical-align:top}#content:has(.direct-send-guide) th{background:color-mix(in srgb, var(--tw-prose-headings) 5%, transparent);font-weight:500;line-height:1.25rem}@media (min-width: 1280px){#content-container:has(#table-of-contents){padding-left:3rem}#content-container:has(#table-of-contents)>div:has(>#content-area){display:grid;grid-template-columns:minmax(0, 48rem) minmax(12rem, 1fr);gap:1rem;padding-top:2rem}#content-container:has(#table-of-contents) #content-area{grid-area:1 / 1;width:100%;min-width:0;margin:0;padding:0}#content-side-layout:has(#table-of-contents){grid-area:1 / 2;width:100%;max-width:none}#table-of-contents-layout{width:100%;padding-left:2rem}#table-of-contents{width:100%;margin-top:0}#table-of-contents>[data-component-part=\"scroll-area-viewport\"]{padding-top:0}}@media (max-width: 639px){#page-title{font-size:2rem}#content :where(h2):not(:where(.not-prose,.not-prose *)){font-size:1.625rem;line-height:1.3}#content :where(h3):not(:where(.not-prose,.not-prose *)){font-size:1.25rem;line-height:1.4}}"}],"page":{"pagePath":"es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated","slug":"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated","pageMetadata":{"title":"Traspaso de control de Meta Business Agent","sidebarTitle":"Traspaso de control","description":"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.","href":"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`qué-es`,children:`Qué es`}),`\n`,_jsxs(_components.p,{children:[`Suscríbete a `,_jsx(_components.code,{children:`whatsapp.meta_business_agent.handover.updated`}),`.`]}),`\n`,_jsx(_components.p,{children:`Recibes este evento cuando YCloud procesa una devolución de llamada (callback) de traspaso/control admitida para un Meta Business Agent creado mediante API. Informa de la transferencia de control, no del resultado de una asignación en Inbox ni de un mensaje personalizado de traspaso.`}),`\n`,_jsxs(_components.p,{children:[`A diferencia de los dos eventos Echo, este evento conserva intencionadamente el objeto\n`,_jsx(_components.code,{children:`whatsappMetaBusinessAgent`}),` porque los metadatos del agente y del control forman parte\ndel contrato de traspaso.`]}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-comenzar`,children:`Antes de comenzar`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Incorpora el agente mediante la `,_jsx(_components.a,{href:`/es/api-reference/meta-business-agents/onboard`,children:`Public REST API`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Suscribe un endpoint de webhook activo en la misma cuenta a `,_jsx(_components.code,{children:`whatsapp.meta_business_agent.handover.updated`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Verifica `,_jsx(_components.code,{children:`YCloud-Signature`}),` con el cuerpo sin procesar de la solicitud, acepta cada evento de forma duradera y procésalo de manera idempotente.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Los agentes creados desde la consola no emiten este webhook de cliente. La sincronización de su Inbox es un flujo independiente.`})}),`\n`,_jsxs(_components.p,{children:[`Consulta `,_jsx(_components.a,{href:`/es/api-reference/guides/api-fundamentals/configure-webhooks#subscribe-to-echo-and-handover-events`,children:`Configurar webhooks`}),` para la configuración del endpoint.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cómo-funciona`,children:`Cómo funciona`}),`\n`,_jsxs(_components.p,{children:[`Todos los ejemplos utilizan identificadores de marcadores de posición. Enruta mediante el `,_jsx(_components.code,{children:`type`}),` externo y lee\n`,_jsx(_components.code,{children:`whatsappMetaBusinessAgent`}),`, no `,_jsx(_components.code,{children:`whatsappMessage`}),`, `,_jsx(_components.code,{children:`whatsappEchoMessage`}),` ni `,_jsx(_components.code,{children:`data`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Desduplica las entregas repetidas con el `,_jsx(_components.code,{children:`id`}),` externo. El `,_jsx(_components.code,{children:`timestamp`}),` anidado\nes un número entero en milisegundos Unix; `,_jsx(_components.code,{children:`createTime`}),` es una cadena RFC 3339.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`controlState`}),` es actualmente `,_jsx(_components.code,{children:`APP_CONTROL_TAKEN`}),` para las devoluciones de llamada de traspaso de agentes de API admitidas.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`consumerPhoneNumber`}),` procede del `,_jsx(_components.code,{children:`sender.phone_number`}),` de la devolución de llamada de traspaso y se normaliza a E.164 cuando es válido. No es el número del negocio ni `,_jsx(_components.code,{children:`phoneNumberId`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`El contrato de traspaso actual no expone `,_jsx(_components.code,{children:`recipientUserId`}),` ni `,_jsx(_components.code,{children:`parentRecipientUserId`}),`. La identidad ausente del consumidor no se recupera a partir de una devolución de llamada de mensaje cercana.`]}),`\n`,_jsxs(_components.li,{children:[`Para el siguiente ejemplo `,_jsx(_components.code,{children:`control_passed`}),`, `,_jsx(_components.code,{children:`actor`}),` identifica la app propietaria anterior, no al empleado receptor.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`reason`}),` son metadatos opcionales del proveedor. Trátalo como una cadena abierta, no como un enum fijo.`]}),`\n`,_jsxs(_components.li,{children:[`Esta no es una notificación para cada solicitud de `,_jsx(_components.code,{children:`take`}),`, `,_jsx(_components.code,{children:`release`}),`, Set Live o Set Draft. Las devoluciones de llamada de control procesadas mientras el agente está en Draft se ignoran.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`La carga útil no inventa una identidad de consumidor. `,_jsx(_components.code,{children:`consumerPhoneNumber`}),` se omite cuando la devolución de llamada no proporciona un número de teléfono válido y no se infiere ningún BSUID a partir de mensajes adyacentes. `,_jsx(_components.code,{children:`phoneNumberId`}),` identifica el número de la empresa, que puede atender a muchos clientes.`]})}),`\n`,_jsx(_components.p,{children:`No consideres este evento como prueba de que se haya asignado un empleado o de que se haya enviado o entregado un mensaje personalizado de traspaso.`}),`\n`,_jsx(Heading,{level:`2`,id:`solicitud`,children:`Solicitud`}),`\n`,_jsxs(_components.p,{children:[`YCloud envía estos cuerpos JSON en solicitudes HTTP `,_jsx(_components.code,{children:`POST`}),` a tu URL de webhook configurada.`]}),`\n`,_jsx(Heading,{level:`2`,id:`respuesta`,children:`Respuesta`}),`\n`,_jsxs(_components.p,{children:[`Devuelve una respuesta `,_jsx(_components.code,{children:`2xx`}),` tras aceptar el evento de forma duradera. Procesa las tareas lentas de forma asíncrona.`]}),`\n`,_jsx(Heading,{level:`2`,id:`el-agente-traspasa-el-control-a-tu-aplicación`,children:`El agente traspasa el control a tu aplicación`}),`\n`,_jsx(Heading,{level:`3`,id:`solicitud-2`,children:`Solicitud`}),`\n`,_jsx(_components.p,{children:`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 traspaso personalizado. actor es el ID de la app propietaria anterior en este ejemplo.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"evt_example_agent_handover\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"whatsapp.meta_business_agent.handover.updated\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"apiVersion\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"v2\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"createTime\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"2026-09-09T02:00:04.000Z\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"whatsappMetaBusinessAgent\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"agentId\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"00000000-0000-4000-8000-000000000001\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"metaAgentId\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"META_AGENT_ID\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"phoneNumberId\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"PHONE_NUMBER_ID\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"wabaId\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"WABA_ID\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"consumerPhoneNumber\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"+12025550124\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"controlState\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"APP_CONTROL_TAKEN\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"actor\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"PREVIOUS_OWNER_APP_ID\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"reason\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:`\"customer_request\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` \"timestamp\"`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`: `}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`1788919204000`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`respuesta-2`,children:`Respuesta`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light github-dark`,style:{backgroundColor:`#fff`,\"--shiki-dark-bg\":`#24292e`,color:`#24292e`,\"--shiki-dark\":`#e1e4e8`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D73A49`,\"--shiki-dark\":`#F97583`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#24292E`,\"--shiki-dark\":`#E1E4E8`},children:`/`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:`1.1`}),_jsx(_components.span,{style:{color:`#005CC5`,\"--shiki-dark\":`#79B8FF`},children:` 200`}),_jsx(_components.span,{style:{color:`#032F62`,\"--shiki-dark\":`#9ECBFF`},children:` OK`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`explicación`,children:`Explicación`}),`\n`,_jsxs(_components.p,{children:[`Usa `,_jsx(_components.code,{children:`consumerPhoneNumber`}),` para correlacionar la transición de control con el consumidor cuando esté presente. No infieras una asignación de Inbox ni la entrega de un mensaje a partir de este evento.`]}),`\n`,_jsx(Heading,{level:`3`,id:`ejemplos-relacionados`,children:`Ejemplos relacionados`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/es/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-created`,children:`Mensaje de eco de WhatsApp creado`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/es/api-reference/guides/examples/webhook-examples/whatsapp-echo-message-updated`,children:`Mensaje de eco de WhatsApp actualizado`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/es/api-reference/webhook-reference/overview#echo-and-agent-handover-events`,children:`Ejemplos de eco y traspaso de agente`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/es/api-reference/guides/examples/webhook-examples/webhook-payload-examples`,children:`Catálogo completo de cargas útiles`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Traspaso de control de Meta Business Agent","sidebarTitle":"Traspaso de control","description":"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.","href":"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Qué es","slug":"qué-es","depth":2,"children":[]},{"title":"Antes de comenzar","slug":"antes-de-comenzar","depth":2,"children":[]},{"title":"Cómo funciona","slug":"cómo-funciona","depth":2,"children":[]},{"title":"Solicitud","slug":"solicitud","depth":2,"children":[]},{"title":"Respuesta","slug":"respuesta","depth":2,"children":[]},{"title":"El agente traspasa el control a tu aplicación","slug":"el-agente-traspasa-el-control-a-tu-aplicación","depth":2,"children":[{"title":"Solicitud","slug":"solicitud-2","depth":3,"children":[]},{"title":"Respuesta","slug":"respuesta-2","depth":3,"children":[]},{"title":"Explicación","slug":"explicación","depth":3,"children":[]},{"title":"Ejemplos relacionados","slug":"ejemplos-relacionados","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"lchnan","siteName":"YCloud Docs","title":"Traspaso de control de Meta Business Agent - YCloud Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated","matchLevel":0},"zh":{"href":"/zh/documentation/overview","matchLevel":4},"es":{"href":"/es/documentation/overview","matchLevel":4},"pt":{"href":"/pt/documentation/overview","matchLevel":4},"ru":{"href":"/ru/documentation/overview","matchLevel":4}}},"lastModified":"2026-11-16T08:55:48.691Z","originalFileLocation":"es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\">\u003cmeta data-mint-head name=\"application-name\" content=\"YCloud Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Traspaso de control de Meta Business Agent - YCloud Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"YCloud Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lchnan.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Traspaso+de+control+de+Meta+Business+Agent\u0026amp;description=Gestiona+los+eventos+de+traspaso+de+control+para+un+Meta+Business+Agent+incorporado+mediante+la+Public+REST+API.\u0026amp;theme=73a4e124bf0b360368afc7b1\u0026amp;signature=1208ba2d0a84443323dc81186c79728a6226da64b5cbfc4ba1f88d4830d47065\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Traspaso de control de Meta Business Agent - YCloud Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lchnan.mintlify.site/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Traspaso+de+control+de+Meta+Business+Agent\u0026amp;description=Gestiona+los+eventos+de+traspaso+de+control+para+un+Meta+Business+Agent+incorporado+mediante+la+Public+REST+API.\u0026amp;theme=73a4e124bf0b360368afc7b1\u0026amp;signature=1208ba2d0a84443323dc81186c79728a6226da64b5cbfc4ba1f88d4830d47065\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/lchnan/g_kuIVCsIE9hrH5P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"YCloud Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#602DED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ycloud.com/#organization\",\"name\":\"YCloud Docs\",\"url\":\"https://docs.ycloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lchnan/AXn0jsI-c5aPnOMW/logo/light.png?fit=max\u0026auto=format\u0026n=AXn0jsI-c5aPnOMW\u0026q=85\u0026s=0865e4207d765d07a769c29bc819adbe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ycloud.com#website\",\"name\":\"YCloud Docs\",\"url\":\"https://docs.ycloud.com\",\"publisher\":{\"@id\":\"https://docs.ycloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated#webpage\",\"url\":\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated\",\"name\":\"Traspaso de control de Meta Business Agent\",\"description\":\"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\",\"dateModified\":\"2026-11-16T08:55:48.691Z\",\"isPartOf\":{\"@id\":\"https://docs.ycloud.com#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated#article\",\"headline\":\"Traspaso de control de Meta Business Agent\",\"name\":\"Traspaso de control de Meta Business Agent\",\"description\":\"Gestiona los eventos de traspaso de control para un Meta Business Agent incorporado mediante la Public REST API.\",\"url\":\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ycloud.com/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated#webpage\"},\"dateModified\":\"2026-11-16T08:55:48.691Z\",\"publisher\":{\"@id\":\"https://docs.ycloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ycloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"YCloud Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"YCloud Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/api-reference/guides/examples/webhook-examples/whatsapp-meta-business-agent-handover-updated.md","siteName":"YCloud Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Overview","pages":[{"title":"Welcome to YCloud Docs","href":"/en/documentation/overview"},{"group":"Update Log","pages":[{"title":"Update Log","href":"/en/documentation/overview/update-log/index"},{"title":"WhatsApp pricing update and Message limit changes on Oct.","href":"/en/documentation/overview/update-log/whatsapp-pricing-update-and-message-limit-changes-on-oct"}]}]},{"group":"Quick Start","pages":[{"title":"Connect WhatsApp to YCloud","href":"/en/documentation/quick-start/connect-whatsapp-to-ycloud"},{"title":"Send verification codes via WhatsApp","href":"/en/documentation/quick-start/send-verification-codes-via-whatsapp"},{"title":"Send utility messages via WhatsApp","href":"/en/documentation/quick-start/send-utility-messages-via-whatsapp"},{"title":"Acquire customers with Click-to-WhatsApp ads","href":"/en/documentation/quick-start/acquire-customers-with-click-to-whatsapp-ads"},{"title":"Run marketing campaigns via WhatsApp","href":"/en/documentation/quick-start/run-marketing-campaigns-via-whatsapp"},{"title":"Set up customer support via WhatsApp","href":"/en/documentation/quick-start/set-up-customer-support-via-whatsapp"}]},{"group":"WhatsApp Business Platform","pages":[{"title":"Overview","href":"/en/documentation/whatsapp-business-platform/overview"},{"group":"Accounts and business identity","pages":[{"title":"Account structure and WhatsApp accounts","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/account-structure-and-wabas"},{"title":"Business phone numbers","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/business-phone-numbers"},{"title":"Business verification","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/business-verification"},{"title":"Business verification by Alipay","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/business-verification-by-alipay"},{"title":"Official Business Accounts","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/official-business-accounts"},{"title":"WhatsApp Business App coexistence","href":"/en/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence"}]},{"group":"Messaging","pages":[{"title":"How messaging works","href":"/en/documentation/whatsapp-business-platform/messaging/how-messaging-works"},{"group":"Message templates","pages":[{"title":"Template overview","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/index"},{"title":"Marketing templates","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates"},{"title":"Utility templates","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates"},{"title":"Authentication templates","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/index"},{"title":"Template components and formats","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats"},{"title":"Template review and lifecycle","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle"},{"group":"Authentication Message Templates","hidden":true,"pages":[{"title":"Copy-code authentication","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/copy-code-authentication"},{"title":"One-tap authentication","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/one-tap-authentication"},{"title":"Zero-tap authentication","href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/zero-tap-authentication"}]},{"title":"Catalog templates","hidden":true,"href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/catalog-templates"},{"title":"Carousel templates","hidden":true,"href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/carousel-templates"},{"title":"Coupon-code templates","hidden":true,"href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/coupon-code-templates"},{"title":"Limited-time offer templates","hidden":true,"href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/limited-time-offer-templates"},{"title":"Multi-product templates","hidden":true,"href":"/en/documentation/whatsapp-business-platform/messaging/message-templates/multi-product-templates"}]},{"title":"Service messages","href":"/en/documentation/whatsapp-business-platform/messaging/service-messages"},{"title":"Message delivery statuses","href":"/en/documentation/whatsapp-business-platform/messaging/message-delivery-statuses"}]},{"group":"Pricing, limits, and quality","pages":[{"title":"WhatsApp pricing","href":"/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing"},{"title":"Authentication-international rates","href":"/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/authentication-international-rates"},{"title":"Max Price for WhatsApp marketing messages","href":"/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/max-price-for-marketing-messages"},{"title":"Messaging limits and throughput","href":"/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput"},{"title":"Quality and delivery controls","href":"/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls"}]},{"group":"Consent, policies, and account health","pages":[{"title":"Customer opt-in","href":"/en/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-in"},{"title":"Customer opt-out","href":"/en/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out"},{"title":"Business and commerce policies","href":"/en/documentation/whatsapp-business-platform/consent-policies-and-account-health/business-and-commerce-policies"},{"title":"Account restrictions and appeals","href":"/en/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals"}]},{"group":"More WhatsApp Features","pages":[{"title":"WhatsApp Flows","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/index"},{"title":"WhatsApp Calling","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-calling"},{"title":"WhatsApp Groups","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-groups"},{"title":"Catalogs and commerce","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/catalogs-and-commerce"},{"title":"Click-to-WhatsApp ads","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/click-to-whatsapp-ads"}]},{"group":"WhatsApp Flows","hidden":true,"pages":[{"title":"Create a WhatsApp Flow","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/create-a-whatsapp-flow"},{"title":"Send a WhatsApp Flow","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/send-a-whatsapp-flow"},{"title":"Review WhatsApp Flow submissions","href":"/en/documentation/whatsapp-business-platform/more-whatsapp-features/whatsapp-flows/review-whatsapp-flow-submissions"}]}]},{"group":"Channels","pages":[{"group":"WhatsApp Accounts Management","pages":[{"group":"WhatsApp business platform","pages":[{"title":"Create WABA via Embedded Sign-up","href":"/en/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up"},{"title":"Add Numbers","href":"/en/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers"},{"title":"Number migration","href":"/en/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration"},{"title":"Remove WhatsApp business accounts","href":"/en/documentation/channels/whatsapp-accounts-management/business-accounts/remove-whatsapp-business-accounts"}]},{"group":"WhatsApp Business App Coexistence","pages":[{"title":"Onboard WhatsApp business app","href":"/en/documentation/channels/whatsapp-accounts-management/coexistence/onboard-whatsapp-business-app"},{"title":"Off-board WhatsApp Business App","href":"/en/documentation/channels/whatsapp-accounts-management/coexistence/off-board-whatsapp-business-app"},{"title":"Coexistence accounts migration","href":"/en/documentation/channels/whatsapp-accounts-management/coexistence/coexistence-accounts-migration"}]},{"group":"Template Management","pages":[{"group":"Create Template","pages":[{"title":"Create Template","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/create-template/index"},{"title":"Create WhatsApp Flows Template","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/create-template/create-whatsapp-flows-template"},{"title":"Create WhatsApp Pay Template","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/create-template/create-whatsapp-pay-template"},{"title":"AI generates marketing templates","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/create-template/ai-generates-marketing-templates"}]},{"title":"Template Library","sidebarTitle":"Template Library","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/template-library"},{"title":"Test a message","sidebarTitle":"Test a message","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/test-a-message"},{"title":"Copy Template","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/copy-template"},{"title":"Template Analytics","href":"/en/documentation/channels/whatsapp-accounts-management/template-management/template-analytics"}]},{"group":"Phone Number Management","pages":[{"title":"Phone Number Management","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/index"},{"title":"Edit Phone Number Display Name ","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/edit-phone-number-display-name"},{"title":"Edit Phone Number Remark Name","href":"/untitled-page"},{"title":"Claim a Business Username","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/claim-a-business-username"},{"title":"Phone Number Profile Settings","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings"},{"title":"Authority","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/authority"},{"title":"Conversation Assignment Rules","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/conversation-assignment-rules"},{"title":"Automation","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/automation"},{"title":"Chat Links","href":"/en/documentation/channels/whatsapp-accounts-management/phone-number-management/chat-links"}]},{"title":"Account Disabling and Handling","href":"/en/documentation/channels/whatsapp-accounts-management/account-disabling-and-handling"},{"group":"Data Analysis","pages":[{"title":"Message Overview","href":"/en/documentation/channels/whatsapp-accounts-management/data-analysis/message-overview"},{"title":"Message Logs","href":"/en/documentation/channels/whatsapp-accounts-management/data-analysis/message-logs"},{"title":"Calling Logs","href":"/en/documentation/channels/whatsapp-accounts-management/data-analysis/calling-logs"}]}]}]},{"group":"Inbox","pages":[{"group":"Getting Started","pages":[{"title":"Inbox Introduction","href":"/en/documentation/inbox/inbox-introduction"},{"title":"Quick start with Inbox","href":"/en/documentation/inbox/quick-start-with-inbox"},{"title":"Admin Guide","href":"/en/documentation/inbox/admin-guide"},{"title":"Customer Support Guide","href":"/en/documentation/inbox/customer-support-guide"},{"title":"Inbox Mobile App","href":"/en/documentation/inbox/inbox-mobile-app"}]},{"group":"Conversations","pages":[{"title":"Initiate New Chat","href":"/en/documentation/inbox/initiate-new-chat"},{"title":"Search contacts \u0026 chat history","href":"/en/documentation/inbox/search-contacts-and-chat-history"},{"title":"Unsupported messages in Inbox","href":"/en/documentation/inbox/unsupported-messages-in-inbox"},{"title":"Message Translation","href":"/en/documentation/inbox/message-translation"},{"title":"WhatsApp Calling in Inbox","href":"/en/documentation/inbox/whatsapp-calling-in-inbox"},{"title":"AI Copilot","href":"/en/documentation/inbox/ai-copilot"}]},{"group":"Personal configuration","pages":[{"title":"Canned Response","href":"/en/documentation/inbox/canned-response"},{"title":"Welcome Messages","href":"/en/documentation/inbox/welcome-messages"},{"title":"Keyboard shortcuts","href":"/en/documentation/inbox/keyboard-shortcuts"},{"title":"Conversation Tags","href":"/en/documentation/inbox/conversation-tags"}]},{"group":"Analytics","pages":[{"title":"Conversation Logs","href":"/en/documentation/inbox/conversation-logs"},{"title":"Inbox Analytics","href":"/en/documentation/inbox/inbox-analytics"}]},{"group":"Best Practices","pages":[{"title":"Best Practices","href":"/en/documentation/inbox/best-practices/index"},{"title":"How Sales Teams Use Inbox","href":"/en/documentation/inbox/best-practices/how-sales-teams-use-inbox"},{"title":"How Service Teams Use Inbox","href":"/en/documentation/inbox/best-practices/how-service-teams-use-inbox"}]}]},{"group":"Contact","pages":[{"title":"Contact Management","href":"/en/documentation/contact/contact-management"},{"title":"Create/Import Contacts","href":"/en/documentation/contact/create-import-contacts"},{"title":"Contact Segments","href":"/en/documentation/contact/contact-segments"},{"title":"Contact Merge Rules","href":"/en/documentation/contact/contact-merge-rules"},{"title":"Bulk Operations","href":"/en/documentation/contact/bulk-operations"},{"title":"Unsubscribe List","href":"/en/documentation/contact/unsubscribe-list"},{"group":"Contact Settings","pages":[{"title":"Contact Settings","href":"/en/documentation/contact/contact-settings/index"},{"title":"Contact Attribute Settings","href":"/en/documentation/contact/contact-settings/contact-attribute-settings"},{"title":"Contact Tag Settings","href":"/en/documentation/contact/contact-settings/contact-tag-settings"},{"title":"Contact Event","href":"/en/documentation/contact/contact-settings/contact-event"}]},{"title":"Owner Assignment Settings (Agent/Sales Assignment)","href":"/en/documentation/contact/owner-assignment-settings-agent-sales-assignment"}]},{"group":"Calling","pages":[{"group":"Getting Started","pages":[{"title":"Overview","href":"/en/documentation/calling/overview"},{"title":"Quick start with Calling","href":"/en/documentation/calling/quick-start-with-calling"},{"title":"Admin Guide","href":"/en/documentation/calling/admin-guide"},{"title":"Agent Guide","href":"/en/documentation/calling/agent-guide"},{"title":"Outbound Calling Guide","href":"/en/documentation/calling/outbound-calling-guide"}]},{"title":"Recording and Transcription","href":"/en/documentation/calling/recording-and-transcription"},{"title":"Calling Logs","href":"/en/documentation/calling/calling-logs"}]},{"group":"Campaign","pages":[{"title":"Create a WhatsApp Marketing Campaign","href":"/en/documentation/campaign/create-a-whatsapp-marketing-campaign"},{"title":"Track button clicks","href":"/en/documentation/campaign/track-button-clicks"},{"title":"Analyze Campaign data","href":"/en/documentation/campaign/analyze-campaign-data"}]},{"group":"Journey","pages":[{"title":"Journey introduction","href":"/en/documentation/journey/journey-introduction"},{"title":"Create a journey","href":"/en/documentation/journey/create-a-journey"},{"group":"Components and Features Introduction","pages":[{"title":"Journey components","href":"/en/documentation/journey/components-and-features-introduction/index"},{"title":"Trigger","href":"/en/documentation/journey/components-and-features-introduction/trigger"},{"title":"Send template","href":"/en/documentation/journey/components-and-features-introduction/send-template"},{"title":"Message status rule","href":"/en/documentation/journey/components-and-features-introduction/message-status-rule"},{"title":"Add tag","href":"/en/documentation/journey/components-and-features-introduction/add-tag"},{"title":"Wait","href":"/en/documentation/journey/components-and-features-introduction/wait"},{"title":"Goal and Exit Rule","href":"/en/documentation/journey/components-and-features-introduction/goal-and-exit-rule"}]},{"title":"Journey best practices","href":"/en/documentation/journey/journey-best-practices"}]},{"group":"Agents","pages":[{"title":"Create an agent","href":"/en/documentation/agents/create-an-agent"},{"group":"AI Agent","pages":[{"title":"What is AI Agent","sidebarTitle":"What is AI Agent","href":"/en/documentation/agents/ai-agent/what-is-ai-agent"},{"title":"How to Create and Configure an AI Agent","sidebarTitle":"Create and Configure an AI Agent","href":"/en/documentation/agents/ai-agent/how-to-create-and-configure-an-ai-agent"},{"title":"AI Profile","sidebarTitle":"AI Profile","href":"/en/documentation/agents/ai-agent/ai-profile"},{"group":"AI Knowledge Base","pages":[{"title":"AI Knowledge Base","href":"/en/documentation/agents/ai-agent/ai-knowledge-base"},{"title":"Connect external app content","href":"/en/documentation/agents/ai-agent/connect-external-app-content"}]},{"title":"AI Skills","sidebarTitle":"AI Skills","href":"/en/documentation/agents/ai-agent/ai-skills"},{"title":"AI Recommendations","sidebarTitle":"AI Recommendations","href":"/en/documentation/agents/ai-agent/ai-recommendations"},{"title":"AI Performance","sidebarTitle":"AI Performance","href":"/en/documentation/agents/ai-agent/ai-performance"},{"title":"Best Practices for YCloud AI Agent","sidebarTitle":"YCloud AI Agent Best Practices","href":"/en/documentation/agents/ai-agent/best-practices/best-practices-for-ycloud-ai-agent"},{"title":"AI Guidance Best Practice","href":"/en/documentation/agents/ai-agent/best-practices/ai-guidance-best-practice"}]},{"group":"Rule-based Agent","pages":[{"title":"Rule-based Agent","href":"/en/documentation/agents/rule-based-agent/rule-based-agent"},{"title":"Create a Flow","href":"/en/documentation/agents/rule-based-agent/create-a-flow"},{"group":"Flow Components","pages":[{"title":"Rule-based Agent Flow Components","href":"/en/documentation/agents/rule-based-agent/flow-components/index"},{"title":"Trigger","href":"/en/documentation/agents/rule-based-agent/flow-components/trigger"},{"title":"Ask a Question","href":"/en/documentation/agents/rule-based-agent/flow-components/ask-a-question"},{"title":"Send Messages","href":"/en/documentation/agents/rule-based-agent/flow-components/send-messages"},{"title":"Agent Takeover","href":"/en/documentation/agents/rule-based-agent/flow-components/agent-takeover"},{"title":"Unsubscribe","href":"/en/documentation/agents/rule-based-agent/flow-components/unsubscribe"},{"title":"Branch","href":"/en/documentation/agents/rule-based-agent/flow-components/branch"},{"title":"Send Shopify orders","href":"/en/documentation/agents/rule-based-agent/flow-components/send-shopify-orders"}]},{"title":"Rule-based Agent Analytics","sidebarTitle":"Rule-based Agent Analytics","href":"/en/documentation/agents/rule-based-agent/rule-based-agent-analytics"},{"title":"Automatically Add Customers to Unsubscribe List","href":"/en/documentation/agents/rule-based-agent/best-practices/automatically-add-customers-to-unsubscribe-list"}]},{"title":"External Agent","href":"/en/documentation/agents/external-agent"},{"title":"Data connectors","href":"/en/documentation/agents/data-connectors"},{"title":"Best Practices","href":"/en/documentation/agents/best-practices/index"}]},{"group":"CTWA (Click to WhatsApp Ad)","pages":[{"title":"CTWA Introduction","href":"/en/documentation/ctwa-click-to-whatsapp-ad/ctwa-introduction"},{"group":"Meta CTWA Ads","pages":[{"title":"Meta CTWA Ads","sidebarTitle":"Overview","icon":"meta","href":"/en/documentation/ctwa-click-to-whatsapp-ad/meta-ctwa-ads/index"},{"title":"Connect a Meta Ad Account","sidebarTitle":"Connect a Meta Ad Account","icon":"meta","href":"/en/documentation/ctwa-click-to-whatsapp-ad/meta-ctwa-ads/connect-a-meta-ad-account"},{"title":"Create a Click-to-WhatsApp Ad","sidebarTitle":"Create a Click-to-WhatsApp Ad","icon":"meta","href":"/en/documentation/ctwa-click-to-whatsapp-ad/meta-ctwa-ads/create-a-click-to-whatsapp-ad"},{"title":"Report CTWA Ad Results to Meta","icon":"meta","sidebarTitle":"Report Ad Results to Meta","href":"/en/documentation/ctwa-click-to-whatsapp-ad/meta-ctwa-ads/report-ctwa-ad-results-to-meta"}]},{"group":"TikTok Messaging Ad","pages":[{"title":"TikTok Messaging Ad","icon":"tiktok","href":"/en/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/index"},{"title":"Connect TikTok Ad Account","icon":"tiktok","href":"/en/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/connect-tiktok-ad-account"},{"title":"Create TikTok Instant Messaging Ad","icon":"tiktok","href":"/en/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/create-tiktok-instant-messaging-ad"},{"title":"Report Ad Results to TikTok","icon":"tiktok","sidebarTitle":"Report Ad Results to TikTok","href":"/en/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/report-ad-results-to-tiktok"}]},{"title":"Receive CTWA Visitors","href":"/en/documentation/ctwa-click-to-whatsapp-ad/receive-ctwa-visitors"},{"title":"CTWA Analysis","href":"/en/documentation/ctwa-click-to-whatsapp-ad/ctwa-analysis"}]},{"group":"Shop","pages":[{"title":"Shop Overview","href":"/en/documentation/shop/overview"},{"title":"Install Shop","href":"/en/documentation/shop/install-shop"},{"title":"Shipping Settings","href":"/en/documentation/shop/shipping-settings"},{"title":"Payment Settings","href":"/en/documentation/shop/payment-settings"},{"title":"Product","href":"/en/documentation/shop/product"},{"group":"Order","pages":[{"title":"Order","href":"/en/documentation/shop/orders/index"},{"title":"Shipping Import","href":"/en/documentation/shop/orders/shipping-import"}]}]},{"group":"WhatsApp pay","pages":[{"title":"Overview","href":"/en/documentation/whatsapp-pay/overview"},{"title":"Link Your Payment Account","href":"/en/documentation/whatsapp-pay/link-your-payment-account"},{"title":"Send order detail \u0026 checkout button message","href":"/en/documentation/whatsapp-pay/send-order-detail-and-checkout-button-message"},{"title":"Update order status","href":"/en/documentation/whatsapp-pay/update-order-status"}]},{"group":"Integrations","pages":[{"group":"Channels","pages":[{"title":"Channels","href":"/en/documentation/integrations/channels/index"},{"group":"Global SMS","pages":[{"title":"Global SMS","href":"/en/documentation/integrations/channels/global-sms/index"},{"title":"Getting Started","href":"/en/documentation/integrations/channels/global-sms/getting-started"},{"title":"SMS Basic Principles","href":"/en/documentation/integrations/channels/global-sms/sms-basic-principles"},{"group":"SMS Features","pages":[{"title":"SMS Features","href":"/en/documentation/integrations/channels/global-sms/sms-features/index"},{"title":"API Interface","href":"/en/documentation/integrations/channels/global-sms/sms-features/api-interface"},{"title":"SMPP","href":"/en/documentation/integrations/channels/global-sms/sms-features/smpp"},{"title":"Mass Messaging","href":"/en/documentation/integrations/channels/global-sms/sms-features/mass-messaging"},{"title":"Sender ID","href":"/en/documentation/integrations/channels/global-sms/sms-features/sender-id"}]}]},{"group":"Verify","pages":[{"title":"Verify","href":"/en/documentation/integrations/channels/verify/index"},{"title":"Getting Started","href":"/en/documentation/integrations/channels/verify/getting-started"},{"group":"Verification Features","pages":[{"title":"Verification Features","href":"/en/documentation/integrations/channels/verify/verification-features/index"},{"title":"Verification Message Templates","href":"/en/documentation/integrations/channels/verify/verification-features/verification-message-templates"},{"title":"Security Settings","href":"/en/documentation/integrations/channels/verify/verification-features/security-settings"},{"title":"Verification Analysis","href":"/en/documentation/integrations/channels/verify/verification-features/verification-analysis"},{"title":"Custom OTP","href":"/en/documentation/integrations/channels/verify/verification-features/custom-otp"}]},{"group":"Best Practices for Verification","pages":[{"title":"Best Practices for Verification","href":"/en/documentation/integrations/channels/verify/best-practices-for-verification/index"},{"title":"Best Practices","href":"/en/documentation/integrations/channels/verify/best-practices-for-verification/best-practices"},{"title":"Verification Channel Selection","href":"/en/documentation/integrations/channels/verify/best-practices-for-verification/verification-channel-selection"},{"title":"Verification via WhatsApp","href":"/en/documentation/integrations/channels/verify/best-practices-for-verification/verification-via-whatsapp"},{"title":"Preventing Fraud and Invalid Registrations","href":"/en/documentation/integrations/channels/verify/best-practices-for-verification/preventing-fraud-and-invalid-registrations"}]}]},{"group":"Email","pages":[{"title":"Email","href":"/en/documentation/integrations/channels/email/index"},{"title":"Getting Started","href":"/en/documentation/integrations/channels/email/getting-started"},{"title":"Basic Principles","href":"/en/documentation/integrations/channels/email/basic-principles"},{"group":"Email Features","pages":[{"title":"Email Features","href":"/en/documentation/integrations/channels/email/email-features/index"},{"title":"Domain Configuration","href":"/en/documentation/integrations/channels/email/email-features/domain-configuration"},{"title":"Send emails via API","href":"/en/documentation/integrations/channels/email/email-features/send-emails-via-api"},{"title":"Monitoring and Optimization","href":"/en/documentation/integrations/channels/email/email-features/monitoring-and-optimization"}]},{"group":"Best Practices for Email","pages":[{"title":"Best Practices for Email","href":"/en/documentation/integrations/channels/email/best-practices-for-email/index"},{"title":"Separate Marketing Subdomain","href":"/en/documentation/integrations/channels/email/best-practices-for-email/separate-marketing-subdomain"},{"title":"Warm-up Sending","href":"/en/documentation/integrations/channels/email/best-practices-for-email/warm-up-sending"}]},{"title":"Email Template Samples","href":"/en/documentation/integrations/channels/email/email-template-samples"}]}]},{"group":"Coupons","pages":[{"title":"Coupon Tool Usage","href":"/en/documentation/integrations/coupons/coupon-tool-usage"}]},{"group":"Shopify","pages":[{"title":"Connect your Shopify store","sidebarTitle":"Connect your Shopify store","icon":"shopify","href":"/en/documentation/integrations/e-commerce/shopify/index"},{"title":"Send Shopify products and manage orders in Inbox","sidebarTitle":"Shopify in Inbox","icon":"shopify","href":"/en/documentation/integrations/e-commerce/shopify/use-shopify-in-inbox"},{"group":"Automate Shopify notifications","pages":[{"title":"Recover abandoned checkouts","sidebarTitle":"Recover abandoned checkouts","href":"/en/documentation/integrations/e-commerce/shopify/recover-abandoned-checkouts"},{"title":"Confirm COD orders","sidebarTitle":"Confirm COD orders","href":"/en/documentation/integrations/e-commerce/shopify/confirm-cod-orders"},{"title":"Notify customers about canceled or fulfilled orders","sidebarTitle":"Notify customers about canceled or fulfilled orders","href":"/en/documentation/integrations/e-commerce/shopify/notify-customers-about-canceled-or-fulfilled-orders"}]},{"title":"Add a chat widget to your Shopify store","sidebarTitle":"Add a chat widget to your Shopify store","icon":"shopify","href":"/en/documentation/integrations/e-commerce/shopify/add-a-chat-widget-to-your-shopify-store"}]},{"title":"HubSpot","icon":"hubspot","href":"/en/documentation/integrations/hubspot"},{"title":"MM Lite API","href":"/en/documentation/integrations/mm-lite-api"},{"title":"Messenger marketing","href":"/en/documentation/integrations/messenger-marketing"},{"title":"Freshdesk","href":"/en/documentation/integrations/freshdesk"}]},{"group":"Developer","pages":[{"title":"Manage API keys","sidebarTitle":"API key management","href":"/en/documentation/developer/manage-api-keys"},{"title":"Configure an IP whitelist","sidebarTitle":"IP whitelist","href":"/en/documentation/developer/configure-an-ip-whitelist"},{"title":"Create and configure a custom app","href":"/en/documentation/developer/create-and-configure-a-custom-app"},{"title":"Webhooks","href":"/en/documentation/developer/webhooks"},{"group":"Integrate With n8n","pages":[{"title":"Integrate With n8n","href":"/en/documentation/developer/integrate-with-n8n/index"},{"title":"Best Practice: AI Auto-Reply","hidden":true,"href":"/en/documentation/developer/integrate-with-n8n/best-practice-ai-auto-reply"},{"title":"Example 1: AI auto-reply","hidden":true,"href":"/en/documentation/developer/integrate-with-n8n/example-1-ai-auto-reply"}]}]},{"group":"Account Management","pages":[{"title":"Company Info","sidebarTitle":"Company Info","href":"/en/documentation/account-management/company-info"},{"title":"Users and Teams","href":"/en/documentation/account-management/users-and-teams"},{"title":"Visual Agent","href":"/en/documentation/account-management/visual-agent"},{"title":"Personal Preferences Settings","href":"/en/documentation/account-management/personal-preferences-settings"},{"title":"My exports","href":"/en/documentation/account-management/export-center"},{"title":"Security and Privacy","href":"/en/documentation/account-management/security-and-privacy"},{"title":"Notification \u0026 Alert","href":"/en/documentation/account-management/notification-and-alert"}]},{"group":"Pricing and Billing","pages":[{"title":"Billing overview","href":"/en/documentation/pricing-and-billing/billing-overview"},{"title":"WhatsApp pricing and billing","href":"/en/documentation/pricing-and-billing/whatsapp-pricing-and-billing"},{"title":"Manage subscriptions and add-ons","href":"/en/documentation/pricing-and-billing/manage-subscriptions-and-add-ons"},{"title":"Billing and Recharge","href":"/en/documentation/pricing-and-billing/billing-and-recharge"},{"title":"Set up billing notifications","href":"/en/documentation/pricing-and-billing/set-up-billing-notifications"},{"title":"Invoices","href":"/en/documentation/pricing-and-billing/invoices"},{"title":"Payment methods and cards","href":"/en/documentation/pricing-and-billing/payment-methods-and-cards"}]},{"group":"Partnership","pages":[{"title":"Partner Documentation","href":"/en/documentation/partnership/partner-documentation"}]},{"group":"Support","pages":[{"title":"YCloud Support Team","href":"/en/documentation/support/ycloud-support-team"},{"title":"Meta Support","href":"/en/documentation/support/meta-support"},{"title":"Frequently Asked Questions","icon":"circle-question","href":"/en/documentation/support/frequently-asked-questions"}]}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Getting Started","pages":[{"title":"YCloud API","href":"/en/api-reference/getting-started/ycloud-api"},{"title":"Quickstart","href":"/en/api-reference/getting-started/quickstart"},{"title":"API changelog","href":"/en/api-reference/getting-started/changelog"},{"title":"YCloud Developer Kit","href":"/en/api-reference/getting-started/ycloud-developer-kit"}]},{"group":"Guides","pages":[{"title":"Guides","href":"/en/api-reference/guides/overview"},{"group":"API fundamentals","pages":[{"title":"Authentication","href":"/en/api-reference/guides/api-fundamentals/authentication"},{"title":"Handle errors","href":"/en/api-reference/guides/api-fundamentals/handle-errors"},{"title":"Rate limits","href":"/en/api-reference/guides/api-fundamentals/rate-limits"},{"title":"Pagination","href":"/en/api-reference/guides/api-fundamentals/pagination"},{"title":"API versioning and compatibility","href":"/en/api-reference/guides/api-fundamentals/versioning"},{"title":"Configure webhooks","href":"/en/api-reference/guides/api-fundamentals/configure-webhooks"},{"title":"Implement a webhook receiver","href":"/en/api-reference/guides/api-fundamentals/implement-a-webhook-receiver"}]},{"group":"WhatsApp platform","pages":[{"group":"Send and receive","pages":[{"title":"Send a WhatsApp message","href":"/en/api-reference/guides/whatsapp-platform/send-whatsapp-message"},{"title":"WhatsApp error code","href":"/en/api-reference/guides/whatsapp-platform/whatsapp-error-code"},{"title":"Handle WhatsApp inbound messages","href":"/en/api-reference/guides/whatsapp-platform/handle-whatsapp-inbound-messages"},{"title":"Upload WhatsApp media","href":"/en/api-reference/guides/whatsapp-platform/upload-whatsapp-media"},{"title":"WhatsApp Message Pricing Integration Guide","href":"/en/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide"},{"title":"Max Price integration guide","href":"/en/api-reference/guides/whatsapp-platform/max-price-integration-guide"}]},{"group":"Best practices","pages":[{"title":"WhatsApp Messages API best practices","href":"/en/api-reference/guides/whatsapp-platform/whatsapp-messages-api-best-practices"},{"title":"Direct Send","sidebarTitle":"Direct Send best practices","href":"/en/api-reference/guides/whatsapp-platform/best-practices/direct-send"}]},{"group":"Business accounts","pages":[{"title":"Manage WhatsApp Business Accounts","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-business-accounts"},{"title":"Manage WhatsApp phone numbers","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers"},{"title":"Use business-scoped user IDs","href":"/en/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids"}]},{"group":"Templates and flows","pages":[{"title":"Manage WhatsApp templates","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-templates"},{"title":"Supported WhatsApp template languages","href":"/en/api-reference/guides/whatsapp-platform/supported-whatsapp-template-languages"},{"title":"Manage WhatsApp Flows","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-flows"},{"title":"Implement a WhatsApp Flow endpoint","href":"/en/api-reference/guides/whatsapp-platform/implement-a-whatsapp-flow-endpoint"}]},{"group":"Calling and groups","pages":[{"title":"Manage WhatsApp calls","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-calls"},{"title":"Manage WhatsApp groups","href":"/en/api-reference/guides/whatsapp-platform/manage-whatsapp-groups"}]}]},{"group":"Meta Business Agent","pages":[{"title":"Meta Business Agent overview","href":"/en/documentation/meta-business-agent/overview"},{"title":"Prepare and check eligibility","href":"/en/documentation/meta-business-agent/prepare-and-check-eligibility"},{"title":"Onboard and configure","href":"/en/documentation/meta-business-agent/onboard-and-configure"},{"title":"Test and evaluate","href":"/en/documentation/meta-business-agent/test-and-evaluate"},{"title":"Roll out safely","href":"/en/documentation/meta-business-agent/roll-out-safely"},{"title":"Operate and troubleshoot","href":"/en/documentation/meta-business-agent/operate-and-troubleshoot"}]},{"group":"Customer data and operations","pages":[{"title":"Check account balance","href":"/en/api-reference/guides/customer-data-and-operations/check-account-balance"},{"title":"Manage contacts","href":"/en/api-reference/guides/customer-data-and-operations/manage-contacts"},{"title":"Track custom events","href":"/en/api-reference/guides/customer-data-and-operations/track-custom-events"},{"title":"Manage unsubscribers","href":"/en/api-reference/guides/customer-data-and-operations/manage-unsubscribers"}]},{"group":"Examples","pages":[{"title":"Example overview","href":"/en/api-reference/guides/examples/overview"},{"group":"API examples","pages":[{"title":"WhatsApp Template Creation Examples","href":"/en/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples"},{"title":"WhatsApp Messaging Examples","href":"/en/api-reference/guides/examples/api-examples/whatsapp-messaging-examples"}]},{"title":"Webhook examples","href":"/en/api-reference/webhook-reference/overview"}]}]},{"group":"Endpoints","pages":[{"group":"WhatsApp Business Accounts","pages":[{"title":"List WABAs","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/businessAccounts","href":"/api-reference/whatsapp-business-accounts/list-wabas"},{"title":"Retrieve a WABA","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/businessAccounts/{id}","href":"/api-reference/whatsapp-business-accounts/retrieve-a-waba"},{"title":"Retrieve WABA automatic creative optimizations","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations","href":"/api-reference/whatsapp-business-accounts/retrieve-waba-automatic-creative-optimizations"},{"title":"Update WABA automatic creative optimizations","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/businessAccounts/{wabaId}/automatic-creative-optimizations","href":"/api-reference/whatsapp-business-accounts/update-waba-automatic-creative-optimizations"}]},{"group":"WhatsApp Inbound Messages","pages":[{"title":"Mark message as read","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/inboundMessages/{id}/markAsRead","href":"/api-reference/whatsapp-inbound-messages/mark-message-as-read"},{"title":"Mark message as read and display a typing indicator with a JSON response","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/inboundMessages/{id}/typing","href":"/api-reference/whatsapp-inbound-messages/mark-message-as-read-and-display-a-typing-indicator-with-a-json-response"}]},{"group":"WhatsApp Media","pages":[{"title":"Upload media","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/media/{phoneNumber}/upload","href":"/api-reference/whatsapp-media/upload-media"}]},{"group":"WhatsApp Messages","pages":[{"title":"Send a message directly","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/messages/sendDirectly","href":"/api-reference/whatsapp-messages/send-a-message-directly"},{"title":"Enqueue a message","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/messages","href":"/api-reference/whatsapp-messages/enqueue-a-message"},{"title":"Retrieve a message","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/messages/{id}","href":"/api-reference/whatsapp-messages/retrieve-a-message"},{"title":"Submit a Direct Send message sample","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/messages/{wabaId}/messageSamples","href":"/api-reference/whatsapp-messages/submit-a-direct-send-message-sample"}]},{"group":"Messenger Messages","pages":[{"title":"Send a Messenger text reply directly","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /messenger/messages/sendDirectly","href":"/api-reference/messenger-messages/send-a-messenger-text-reply-directly"},{"title":"Retrieve an outbound message by its YCloud ID","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /messenger/messages/{id}","href":"/api-reference/messenger-messages/retrieve-an-outbound-message-by-its-ycloud-id"},{"title":"Retrieve an outbound message by its Meta message ID","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /messenger/messages/retrieveByMetaMessageId","href":"/api-reference/messenger-messages/retrieve-an-outbound-message-by-its-meta-message-id"}]},{"group":"WhatsApp Blocked Users","pages":[{"title":"Block users","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/blockUsers","href":"/api-reference/whatsapp-blocked-users/block-users"},{"title":"Unblock users","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/unblockUsers","href":"/api-reference/whatsapp-blocked-users/unblock-users"},{"title":"List blocked users","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/{businessPhoneNumber}/blockedUsers","href":"/api-reference/whatsapp-blocked-users/list-blocked-users"}]},{"group":"WhatsApp Groups","pages":[{"title":"Create a group","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/groups","href":"/api-reference/whatsapp-groups/create-a-group"},{"title":"List groups","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/{businessPhoneNumber}/groups","href":"/api-reference/whatsapp-groups/list-groups"},{"title":"Retrieve a group","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/{businessPhoneNumber}/groups/{groupId}","href":"/api-reference/whatsapp-groups/retrieve-a-group"},{"title":"Delete a group","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/{businessPhoneNumber}/groups/{groupId}","href":"/api-reference/whatsapp-groups/delete-a-group"},{"title":"Retrieve a group invite link","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/{businessPhoneNumber}/groups/{groupId}/inviteLink","href":"/api-reference/whatsapp-groups/retrieve-a-group-invite-link"},{"title":"Reset a group invite link","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/groups/{groupId}/inviteLink/reset","href":"/api-reference/whatsapp-groups/reset-a-group-invite-link"},{"title":"Send a group invite link message","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/groups/inviteLink/messages","href":"/api-reference/whatsapp-groups/send-a-group-invite-link-message"},{"title":"List group join requests","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/{businessPhoneNumber}/groups/{groupId}/joinRequests","href":"/api-reference/whatsapp-groups/list-group-join-requests"},{"title":"Approve group join requests","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/groups/{groupId}/joinRequests/approve","href":"/api-reference/whatsapp-groups/approve-group-join-requests"},{"title":"Reject group join requests","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/{businessPhoneNumber}/groups/{groupId}/joinRequests/reject","href":"/api-reference/whatsapp-groups/reject-group-join-requests"},{"title":"Remove group participants","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/groups/{groupId}/participants/remove","href":"/api-reference/whatsapp-groups/remove-group-participants"},{"title":"Update group settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/{businessPhoneNumber}/groups/{groupId}/settings","href":"/api-reference/whatsapp-groups/update-group-settings"}]},{"group":"WhatsApp Calling","pages":[{"title":"Connect a call","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/calls/connect","href":"/api-reference/whatsapp-calling/connect-a-call"},{"title":"Pre-accept a call","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/calls/preAccept","href":"/api-reference/whatsapp-calling/pre-accept-a-call"},{"title":"Accept a call","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/calls/accept","href":"/api-reference/whatsapp-calling/accept-a-call"},{"title":"Terminate a call","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/calls/terminate","href":"/api-reference/whatsapp-calling/terminate-a-call"},{"title":"Reject a call","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/calls/reject","href":"/api-reference/whatsapp-calling/reject-a-call"},{"title":"Download call media","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/calls/media/{mediaAssetId}","href":"/api-reference/whatsapp-calling/download-call-media"}]},{"group":"WhatsApp Phone Numbers","pages":[{"title":"List phone numbers","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers","href":"/api-reference/whatsapp-phone-numbers/list-phone-numbers"},{"title":"Retrieve a phone number","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}","href":"/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number"},{"title":"Retrieve a phone number profile","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile","href":"/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number-profile"},{"title":"Update a phone number profile","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/profile","href":"/api-reference/whatsapp-phone-numbers/update-a-phone-number-profile"},{"title":"Update a phone number display name","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/displayName","href":"/api-reference/whatsapp-phone-numbers/update-a-phone-number-display-name"},{"title":"Retrieve commerce settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings","href":"/api-reference/whatsapp-phone-numbers/retrieve-commerce-settings"},{"title":"Update commerce settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/whatsappCommerceSettings","href":"/api-reference/whatsapp-phone-numbers/update-commerce-settings"},{"title":"Register a phone number","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/register","href":"/api-reference/whatsapp-phone-numbers/register-a-phone-number"},{"title":"Retrieve phone number settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings","href":"/api-reference/whatsapp-phone-numbers/retrieve-phone-number-settings"},{"title":"Save phone number settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/settings","href":"/api-reference/whatsapp-phone-numbers/save-phone-number-settings"},{"title":"Retrieve a phone number business username","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername","href":"/api-reference/whatsapp-phone-numbers/retrieve-a-phone-number-business-username"},{"title":"Retrieve phone number business username suggestions","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername/suggestions","href":"/api-reference/whatsapp-phone-numbers/retrieve-phone-number-business-username-suggestions"},{"title":"Update a phone number business username","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername","href":"/api-reference/whatsapp-phone-numbers/update-a-phone-number-business-username"},{"title":"Delete a phone number business username","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername","href":"/api-reference/whatsapp-phone-numbers/delete-a-phone-number-business-username"},{"title":"Check a Meta contact book entry","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/contactBook/{bsuid}","href":"/api-reference/whatsapp-phone-numbers/check-a-meta-contact-book-entry"},{"title":"Delete a Meta contact book entry","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/contactBook/{bsuid}","href":"/api-reference/whatsapp-phone-numbers/delete-a-meta-contact-book-entry"}]},{"group":"WhatsApp Templates","pages":[{"title":"Create a template","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/templates","href":"/api-reference/whatsapp-templates/create-a-template"},{"title":"List templates","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/templates","href":"/api-reference/whatsapp-templates/list-templates"},{"title":"Retrieve WhatsApp template analytics","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/templates/analytics","href":"/api-reference/whatsapp-templates/retrieve-whatsapp-template-analytics"},{"title":"Delete templates by name","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/templates/{wabaId}/{name}","href":"/api-reference/whatsapp-templates/delete-templates-by-name"},{"title":"Delete a template","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/templates/{wabaId}/{name}/{language}","href":"/api-reference/whatsapp-templates/delete-a-template"},{"title":"Edit a template","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/templates/{wabaId}/{name}/{language}","href":"/api-reference/whatsapp-templates/edit-a-template"},{"title":"Retrieve a template","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/templates/{wabaId}/{name}/{language}","href":"/api-reference/whatsapp-templates/retrieve-a-template"}]},{"group":"WhatsApp Flows","pages":[{"title":"Create a flow","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/flows","href":"/api-reference/whatsapp-flows/create-a-flow"},{"title":"List flows","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/flows","href":"/api-reference/whatsapp-flows/list-flows"},{"title":"Update flow metadata","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/flows/{flowId}/metadata","href":"/api-reference/whatsapp-flows/update-flow-metadata"},{"title":"Update flow structure","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /whatsapp/flows/{flowId}/assets","href":"/api-reference/whatsapp-flows/update-flow-structure"},{"title":"Delete a flow","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /whatsapp/flows/{flowId}","href":"/api-reference/whatsapp-flows/delete-a-flow"},{"title":"Retrieve a flow","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/flows/{flowId}","href":"/api-reference/whatsapp-flows/retrieve-a-flow"},{"title":"Publish a flow","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/flows/{flowId}/publish","href":"/api-reference/whatsapp-flows/publish-a-flow"},{"title":"Deprecate a flow","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /whatsapp/flows/{flowId}/deprecate","href":"/api-reference/whatsapp-flows/deprecate-a-flow"},{"title":"generate a web preview URL with this flow.","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /whatsapp/flows/{flowId}/preview","href":"/api-reference/whatsapp-flows/generate-a-web-preview-url-with-this-flow"}]},{"group":"CTWA","pages":[{"title":"Submit a conversion event","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /ctwa/conversionEvents","href":"/api-reference/ctwa/submit-a-conversion-event"},{"title":"Submit conversion events","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /ctwa/conversionEvents/batch","href":"/api-reference/ctwa/submit-conversion-events"}]},{"group":"Balance","pages":[{"title":"Retrieve balance","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /balance","href":"/api-reference/balance/retrieve-balance"}]},{"group":"Contacts","pages":[{"title":"Create a contact","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /contact/contacts","href":"/api-reference/contacts/create-a-contact"},{"title":"List contacts","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /contact/contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Retrieve a contact","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /contact/contacts/{id}","href":"/api-reference/contacts/retrieve-a-contact"},{"title":"List contact notes","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /contact/contacts/{contactIdentifier}/notes","href":"/api-reference/contacts/list-contact-notes"},{"title":"Create a contact note","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /contact/contacts/{contactIdentifier}/notes","href":"/api-reference/contacts/create-a-contact-note"},{"title":"Update a contact note","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /contact/notes/{noteId}","href":"/api-reference/contacts/update-a-contact-note"},{"title":"Delete a contact note","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /contact/notes/{noteId}","href":"/api-reference/contacts/delete-a-contact-note"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /contact/contacts/{id}","href":"/api-reference/contacts/update-a-contact"},{"title":"Delete a contact","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /contact/contacts/{id}","href":"/api-reference/contacts/delete-a-contact"},{"title":"List contact attributes","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /contact/contacts/attributes","href":"/api-reference/contacts/list-contact-attributes"}]},{"group":"Custom Events","pages":[{"title":"Create an event definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /event/definitions","href":"/api-reference/custom-events/create-an-event-definition"},{"title":"Retrieve an event definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /event/definitions/{name}","href":"/api-reference/custom-events/retrieve-an-event-definition"},{"title":"Update an event definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /event/definitions/{name}","href":"/api-reference/custom-events/update-an-event-definition"},{"title":"Create an event property definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /event/definitions/{name}/properties","href":"/api-reference/custom-events/create-an-event-property-definition"},{"title":"Update an event property definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /event/definitions/{name}/properties/{propertyName}","href":"/api-reference/custom-events/update-an-event-property-definition"},{"title":"Delete an event property definition","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /event/definitions/{name}/properties/{propertyName}","href":"/api-reference/custom-events/delete-an-event-property-definition"},{"title":"Send an event","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /event/events","href":"/api-reference/custom-events/send-an-event"}]},{"group":"Emails","pages":[{"title":"Send an email","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /emails","href":"/api-reference/emails/send-an-email"}]},{"group":"SMS","pages":[{"title":"Send an SMS","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /sms","href":"/api-reference/sms/send-an-sms"},{"title":"List SMS records","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /sms","href":"/api-reference/sms/list-sms-records"}]},{"group":"Unsubscribers","pages":[{"title":"Create an unsubscriber","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /unsubscribers","href":"/api-reference/unsubscribers/create-an-unsubscriber"},{"title":"List unsubscribers","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /unsubscribers","href":"/api-reference/unsubscribers/list-unsubscribers"},{"title":"List all unsubscribers by customer","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /unsubscribers/{customer}","href":"/api-reference/unsubscribers/list-all-unsubscribers-by-customer"},{"title":"Retrieve an unsubscriber","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /unsubscribers/{customer}/{channel}","href":"/api-reference/unsubscribers/retrieve-an-unsubscriber"},{"title":"Delete an unsubscriber","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /unsubscribers/{customer}/{channel}","href":"/api-reference/unsubscribers/delete-an-unsubscriber"}]},{"group":"Verify","pages":[{"title":"Start a verification","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /verify/verifications","href":"/api-reference/verify/start-a-verification"},{"title":"Check a verification","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /verify/verificationChecks","href":"/api-reference/verify/check-a-verification"}]},{"group":"Voices","pages":[{"title":"Send a voice code","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /voices","href":"/api-reference/voices/send-a-voice-code"},{"title":"List voice records","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /voices","href":"/api-reference/voices/list-voice-records"}]},{"group":"Webhook Endpoints","pages":[{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /webhookEndpoints","href":"/api-reference/webhook-endpoints/create-a-webhook-endpoint"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /webhookEndpoints","href":"/api-reference/webhook-endpoints/list-webhook-endpoints"},{"title":"Retrieve a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml get /webhookEndpoints/{id}","href":"/api-reference/webhook-endpoints/retrieve-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml patch /webhookEndpoints/{id}","href":"/api-reference/webhook-endpoints/update-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml delete /webhookEndpoints/{id}","href":"/api-reference/webhook-endpoints/delete-a-webhook-endpoint"},{"title":"Rotate a webhook endpoint secret","deprecated":null,"version":null,"openapi":"/openapi/endpoints/ycloud-api-v2.yaml post /webhookEndpoints/{id}/rotateSecret","href":"/api-reference/webhook-endpoints/rotate-a-webhook-endpoint-secret"}]},{"group":"Meta Business Agent","pages":[{"title":"Meta Business Agent overview","href":"/en/api-reference/meta-business-agents/overview"},{"group":"Configure","pages":[{"group":"Agent Knowledge - Business Info","pages":[{"title":"Get Business Info","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/businessInfo","href":"/api-reference/meta-business-agents/get-business-info"},{"title":"Replace Business Info","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/businessInfo","href":"/api-reference/meta-business-agents/replace-business-info"},{"title":"Delete Business Info","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/businessInfo","href":"/api-reference/meta-business-agents/delete-business-info"}]},{"group":"Agent Knowledge - FAQs","pages":[{"title":"List Faqs","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/faqs","href":"/api-reference/meta-business-agents/list-faqs"},{"title":"Create Faq","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/faqs","href":"/api-reference/meta-business-agents/create-faq"},{"title":"Get Faq","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/faqs/{faqId}","href":"/api-reference/meta-business-agents/get-faq"},{"title":"Update Faq","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/faqs/{faqId}","href":"/api-reference/meta-business-agents/update-faq"},{"title":"Delete Faq","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/faqs/{faqId}","href":"/api-reference/meta-business-agents/delete-faq"}]},{"group":"Agent Knowledge - Files","pages":[{"title":"List Files","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/files","href":"/api-reference/meta-business-agents/list-files"},{"title":"Upload File","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/files","href":"/api-reference/meta-business-agents/upload-file"},{"title":"Get File","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/files/{fileId}","href":"/api-reference/meta-business-agents/get-file"},{"title":"Delete File","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/files/{fileId}","href":"/api-reference/meta-business-agents/delete-file"}]},{"group":"Agent Knowledge - Websites","pages":[{"title":"List Websites","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/websites","href":"/api-reference/meta-business-agents/list-websites"},{"title":"Create Website","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/websites","href":"/api-reference/meta-business-agents/create-website"},{"title":"Get Website","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/websites/{websiteId}","href":"/api-reference/meta-business-agents/get-website"},{"title":"Update Website","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/websites/{websiteId}","href":"/api-reference/meta-business-agents/update-website"},{"title":"Delete Website","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/websites/{websiteId}","href":"/api-reference/meta-business-agents/delete-website"}]},{"group":"Agent Skills","pages":[{"title":"List Skills","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/skills","href":"/api-reference/meta-business-agents/list-skills"},{"title":"Create Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/skills","href":"/api-reference/meta-business-agents/create-skill"},{"title":"Get Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/skills/{skillId}","href":"/api-reference/meta-business-agents/get-skill"},{"title":"Update Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/skills/{skillId}","href":"/api-reference/meta-business-agents/update-skill"},{"title":"Delete Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/skills/{skillId}","href":"/api-reference/meta-business-agents/delete-skill"}]},{"group":"UI Skills","pages":[{"title":"List UI Skills","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/uiSkills","href":"/api-reference/meta-business-agents/list-ui-skills"},{"title":"Create UI Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/uiSkills","href":"/api-reference/meta-business-agents/create-ui-skill"},{"title":"Get UI Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/uiSkills/{skillId}","href":"/api-reference/meta-business-agents/get-ui-skill"},{"title":"Update UI Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/uiSkills/{skillId}","href":"/api-reference/meta-business-agents/update-ui-skill"},{"title":"Delete UI Skill","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/uiSkills/{skillId}","href":"/api-reference/meta-business-agents/delete-ui-skill"}]},{"group":"Connector Tools","pages":[{"title":"List Connector Tools","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools","href":"/api-reference/meta-business-agents/list-connector-tools"},{"title":"Create Connector Tool","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools","href":"/api-reference/meta-business-agents/create-connector-tool"},{"title":"Get Connector Tool","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools/{toolId}","href":"/api-reference/meta-business-agents/get-connector-tool"},{"title":"Update Connector Tool","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools/{toolId}","href":"/api-reference/meta-business-agents/update-connector-tool"},{"title":"Delete Connector Tool","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools/{toolId}","href":"/api-reference/meta-business-agents/delete-connector-tool"},{"title":"Run Connector Tool","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/connectors/{connectorId}/tools/{toolId}/runs","href":"/api-reference/meta-business-agents/run-connector-tool"}]},{"group":"Connectors","pages":[{"title":"List Connectors","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/connectors","href":"/api-reference/meta-business-agents/list-connectors"},{"title":"Create Connector","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/connectors","href":"/api-reference/meta-business-agents/create-connector"},{"title":"Get Connector","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/connectors/{connectorId}","href":"/api-reference/meta-business-agents/get-connector"},{"title":"Update Connector","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json patch /metaBusinessAgents/{entityId}/connectors/{connectorId}","href":"/api-reference/meta-business-agents/update-connector"},{"title":"Refresh MCP Connector Tools","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/connectors/{connectorId}/refreshMCPTools","href":"/api-reference/meta-business-agents/refresh-mcp-connector-tools"},{"title":"Delete Connector","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/connectors/{connectorId}","href":"/api-reference/meta-business-agents/delete-connector"},{"title":"Upsert Connector Certificate","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/connectors/{connectorId}/credentials/certificate","href":"/api-reference/meta-business-agents/upsert-connector-certificate"},{"title":"Upsert Connector Api Key","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/connectors/{connectorId}/credentials/apiKey","href":"/api-reference/meta-business-agents/upsert-connector-api-key"},{"title":"Upsert Connector O Auth","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/connectors/{connectorId}/credentials/oauth","href":"/api-reference/meta-business-agents/upsert-connector-o-auth"},{"title":"List Connector Logs","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/connectors/{connectorId}/logs","href":"/api-reference/meta-business-agents/list-connector-logs"}]}]},{"group":"Delete Agent","pages":[{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}","href":"/api-reference/meta-business-agents/delete-agent"}]},{"group":"Onboard","pages":[{"group":"Agent Allowlist","pages":[{"title":"List Allowlist","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/allowListEntries","href":"/api-reference/meta-business-agents/list-allowlist"},{"title":"Create Allowlist Entry","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/allowListEntries","href":"/api-reference/meta-business-agents/create-allowlist-entry"},{"title":"Delete Allowlist Entry","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json delete /metaBusinessAgents/{entityId}/allowListEntries/{entryId}","href":"/api-reference/meta-business-agents/delete-allowlist-entry"}]},{"group":"Agent Eligibility","pages":[{"title":"Check Eligibility","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/eligibility","href":"/api-reference/meta-business-agents/check-eligibility"}]},{"group":"Agent Onboarding","pages":[{"title":"Onboard Agent","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/onboarding","href":"/api-reference/meta-business-agents/onboard-agent"}]},{"group":"Agent Settings","pages":[{"title":"Get Settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/settings","href":"/api-reference/meta-business-agents/get-settings"},{"title":"Replace Settings","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/settings","href":"/api-reference/meta-business-agents/replace-settings"}]},{"group":"Agent Budgets","pages":[{"title":"Get Budgets","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/budgets","href":"/api-reference/meta-business-agents/get-budgets"},{"title":"Replace Budgets","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json put /metaBusinessAgents/{entityId}/budgets","href":"/api-reference/meta-business-agents/replace-budgets"}]}]},{"group":"Operate","pages":[{"group":"Agent Eval","pages":[{"title":"List Eval Cases","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/evalCases","href":"/api-reference/meta-business-agents/list-eval-cases"},{"title":"Get Eval Summary","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/evalSummaries","href":"/api-reference/meta-business-agents/get-eval-summary"},{"title":"Get Eval Details","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/evals","href":"/api-reference/meta-business-agents/get-eval-details"},{"title":"Get Eval Run Status","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/evalRuns/{jobId}","href":"/api-reference/meta-business-agents/get-eval-run-status"},{"title":"Submit Eval Run","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/evalRuns","href":"/api-reference/meta-business-agents/submit-eval-run"}]},{"group":"Agent Event","pages":[{"title":"Submit Agent Event","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/events","href":"/api-reference/meta-business-agents/submit-agent-event"},{"title":"Get Agent Event Status","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/events/{agentEventId}","href":"/api-reference/meta-business-agents/get-agent-event-status"}]},{"group":"Agent Test","pages":[{"title":"Test Agent","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/tests","href":"/api-reference/meta-business-agents/test-agent"}]},{"group":"Conversation Turns","pages":[{"title":"Get Conversation Turns","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/conversationTurns","href":"/api-reference/meta-business-agents/get-conversation-turns"}]},{"group":"Thread Control (Cloud API)","pages":[{"title":"Control Thread","deprecated":null,"version":null,"openapi":"/openapi/endpoints/meta-business-agent-public.openapi.json post /metaBusinessAgents/{entityId}/threadControl","href":"/api-reference/meta-business-agents/control-thread"}]}]}]}]},{"group":"Webhook reference","pages":[{"group":"Messenger","pages":[{"title":"messenger.inbound_message.received","sidebarTitle":"messenger.inbound_message.received","href":"/en/api-reference/webhook-reference/messenger-inbound-message-received"},{"title":"messenger.inbound_message.updated","sidebarTitle":"messenger.inbound_message.updated","href":"/en/api-reference/webhook-reference/messenger-inbound-message-updated"},{"title":"messenger.message.updated","sidebarTitle":"messenger.message.updated","href":"/en/api-reference/webhook-reference/messenger-message-updated"},{"title":"messenger.message_reaction.updated","sidebarTitle":"messenger.message_reaction.updated","href":"/en/api-reference/webhook-reference/messenger-message-reaction-updated"}]},{"group":"WhatsApp messages","pages":[{"title":"whatsapp.inbound_message.received","sidebarTitle":"inbound_message.received","href":"/en/api-reference/webhook-reference/whatsapp-inbound-message-received"},{"title":"whatsapp.message.updated","sidebarTitle":"message.updated","href":"/en/api-reference/webhook-reference/whatsapp-message-updated"},{"title":"whatsapp.user.preferences","sidebarTitle":"user.preferences","href":"/en/api-reference/webhook-reference/whatsapp-user-preferences"}]},{"group":"WhatsApp templates","pages":[{"title":"whatsapp.template.category_updated","sidebarTitle":"category_updated","href":"/en/api-reference/webhook-reference/whatsapp-template-category-updated"},{"title":"whatsapp.template.correct_category_detection","sidebarTitle":"correct_category_detection","href":"/en/api-reference/webhook-reference/whatsapp-template-correct-category-detection"},{"title":"whatsapp.template.quality_updated","sidebarTitle":"quality_updated","href":"/en/api-reference/webhook-reference/whatsapp-template-quality-updated"},{"title":"whatsapp.template.reviewed","sidebarTitle":"reviewed","href":"/en/api-reference/webhook-reference/whatsapp-template-reviewed"}]},{"group":"WhatsApp accounts","pages":[{"title":"whatsapp.business_account.deleted","sidebarTitle":"deleted","href":"/en/api-reference/webhook-reference/whatsapp-business-account-deleted"},{"title":"whatsapp.business_account.reviewed","sidebarTitle":"reviewed","href":"/en/api-reference/webhook-reference/whatsapp-business-account-reviewed"},{"title":"whatsapp.business_account.updated","sidebarTitle":"updated","href":"/en/api-reference/webhook-reference/whatsapp-business-account-updated"}]},{"group":"WhatsApp phone numbers","pages":[{"title":"whatsapp.phone_number.deleted","sidebarTitle":"deleted","href":"/en/api-reference/webhook-reference/whatsapp-phone-number-deleted"},{"title":"whatsapp.phone_number.name_updated","sidebarTitle":"name_updated","href":"/en/api-reference/webhook-reference/whatsapp-phone-number-name-updated"},{"title":"whatsapp.phone_number.quality_updated","sidebarTitle":"quality_updated","href":"/en/api-reference/webhook-reference/whatsapp-phone-number-quality-updated"},{"title":"whatsapp.phone_number.business_username_updated","sidebarTitle":"business_username_updated","href":"/en/api-reference/webhook-reference/whatsapp-phone-number-business-username-updated"}]},{"group":"WhatsApp Business App","pages":[{"title":"whatsapp.smb.history","sidebarTitle":"smb.history","href":"/en/api-reference/webhook-reference/whatsapp-smb-history"},{"title":"whatsapp.smb.message.created","sidebarTitle":"smb.message.created","href":"/en/api-reference/webhook-reference/whatsapp-smb-message-created"},{"title":"whatsapp.smb.message.echoes","sidebarTitle":"smb.message.echoes","href":"/en/api-reference/webhook-reference/whatsapp-smb-message-echoes"}]},{"group":"WhatsApp Agents","pages":[{"title":"whatsapp.echo_message.created","sidebarTitle":"echo_message.created","href":"/en/api-reference/webhook-reference/whatsapp-echo-message-created"},{"title":"whatsapp.echo_message.updated","sidebarTitle":"echo_message.updated","href":"/en/api-reference/webhook-reference/whatsapp-echo-message-updated"},{"title":"whatsapp.meta_business_agent.handover.updated","sidebarTitle":"meta_business_agent.handover.updated","href":"/en/api-reference/webhook-reference/whatsapp-meta-business-agent-handover-updated"}]},{"group":"WhatsApp calls","pages":[{"title":"whatsapp.call.connect","sidebarTitle":"call.connect","href":"/en/api-reference/webhook-reference/whatsapp-call-connect"},{"title":"whatsapp.call.terminate","sidebarTitle":"call.terminate","href":"/en/api-reference/webhook-reference/whatsapp-call-terminate"},{"title":"whatsapp.call.status.updated","sidebarTitle":"call.status.updated","href":"/en/api-reference/webhook-reference/whatsapp-call-status-updated"},{"title":"whatsapp.call.recording.updated","sidebarTitle":"call.recording.updated","href":"/en/api-reference/webhook-reference/whatsapp-call-recording-updated"},{"title":"whatsapp.call.transcription.updated","sidebarTitle":"call.transcription.updated","href":"/en/api-reference/webhook-reference/whatsapp-call-transcription-updated"}]},{"group":"WhatsApp groups","pages":[{"title":"whatsapp.group.lifecycle_update","sidebarTitle":"lifecycle_update","href":"/en/api-reference/webhook-reference/whatsapp-group-lifecycle-update"},{"title":"whatsapp.group.participants_update","sidebarTitle":"participants_update","href":"/en/api-reference/webhook-reference/whatsapp-group-participants-update"},{"title":"whatsapp.group.settings_update","sidebarTitle":"settings_update","href":"/en/api-reference/webhook-reference/whatsapp-group-settings-update"},{"title":"whatsapp.group.status_update","sidebarTitle":"status_update","href":"/en/api-reference/webhook-reference/whatsapp-group-status-update"}]},{"group":"WhatsApp Flows and payments","pages":[{"title":"whatsapp.flow.status_change","sidebarTitle":"flow.status_change","href":"/en/api-reference/webhook-reference/whatsapp-flow-status-change"},{"title":"whatsapp.payment.updated","sidebarTitle":"payment.updated","href":"/en/api-reference/webhook-reference/whatsapp-payment-updated"}]},{"group":"Contacts","pages":[{"title":"contact.attributes_changed","sidebarTitle":"attributes_changed","href":"/en/api-reference/webhook-reference/contact-attributes-changed"},{"title":"contact.created","sidebarTitle":"created","href":"/en/api-reference/webhook-reference/contact-created"},{"title":"contact.deleted","sidebarTitle":"deleted","href":"/en/api-reference/webhook-reference/contact-deleted"},{"title":"contact.unsubscribe.created","sidebarTitle":"unsubscribe.created","href":"/en/api-reference/webhook-reference/contact-unsubscribe-created"},{"title":"contact.unsubscribe.deleted","sidebarTitle":"unsubscribe.deleted","href":"/en/api-reference/webhook-reference/contact-unsubscribe-deleted"},{"title":"contact.note.created","sidebarTitle":"note.created","href":"/en/api-reference/webhook-reference/contact-note-created"},{"title":"contact.note.updated","sidebarTitle":"note.updated","href":"/en/api-reference/webhook-reference/contact-note-updated"},{"title":"contact.note.deleted","sidebarTitle":"note.deleted","href":"/en/api-reference/webhook-reference/contact-note-deleted"}]},{"group":"Email, SMS, and Voice","pages":[{"title":"email.delivery.updated","sidebarTitle":"email.delivery.updated","href":"/en/api-reference/webhook-reference/email-delivery-updated"},{"title":"sms.message.updated","sidebarTitle":"sms.message.updated","href":"/en/api-reference/webhook-reference/sms-message-updated"},{"title":"sms.inbound.received","sidebarTitle":"sms.inbound.received","href":"/en/api-reference/webhook-reference/sms-inbound-received"},{"title":"voice.message.updated","sidebarTitle":"voice.message.updated","href":"/en/api-reference/webhook-reference/voice-message-updated"}]}]}]},{"tab":"Partner Center","icon":"handshake","groups":[{"group":"Overview","icon":"compass","pages":[{"title":"YCloud Partner Documentation","href":"/en/partner-center/overview"}]},{"group":"Technical development partners","icon":"code","pages":[{"group":"Getting started","pages":[{"title":"Tech Partner guide","href":"/en/partner-center/technical-development-partners/getting-started-with-tech-partner"},{"title":"Become YCloud Tech Partner","href":"/en/partner-center/technical-development-partners/become-ycloud-tech-partner"}]},{"group":"Partner Direct Link","pages":[{"sidebarTitle":"Integrate Partner Direct Link","title":"Integrate Partner Direct Link","href":"/en/partner-center/technical-development-partners/partner-direct-link-tp-lite"}]},{"group":"Use your own Meta App","pages":[{"title":"Become a Meta Tech Provider","href":"/en/partner-center/technical-development-partners/technical-development-partner-onboarding"},{"sidebarTitle":"Integrate Embedded Signup","title":"Embedded signup","href":"/en/partner-center/technical-development-partners/embedded-signup"}]},{"title":"Template Synchronisation","href":"/en/partner-center/technical-development-partners/template-synchronisation"},{"title":"Pricing, Billing, and Payment Methods for Technical Development Partners","href":"/en/partner-center/technical-development-partners/pricing-billing-and-payment-methods-for-technical-development-partners"},{"title":"Manage customer WABAs and phone numbers","href":"/en/partner-center/technical-development-partners/managing-customers-waba-and-numbers"},{"title":"Migration phone numbers","href":"/en/partner-center/technical-development-partners/migration-phone-numbers"}]},{"group":"Solution partners","icon":"briefcase","pages":[{"title":"Getting Started with Solution Partners","href":"/en/partner-center/solution-partners/getting-started-with-solution-partners"}]},{"group":"Affiliate partners","icon":"link","pages":[{"title":"Getting Started with Affiliate Partners","href":"/en/partner-center/affiliate-partners/getting-started-with-affiliate-partners"},{"title":"How do alliance partners receive payments?","href":"/en/partner-center/affiliate-partners/how-do-alliance-partners-receive-payments"}]}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/documentation/overview"}]},{"language":"es","pages":[{"title":"es","href":"/es/documentation/overview"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/documentation/overview"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/documentation/overview"}]}]},"basePath":"","title":"Traspaso de control de Meta Business Agent - YCloud Docs","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}