Cuando Meta Business Agent se activa en un número de WhatsApp gestionado a través de un Business Solution Provider (BSP), la app del partner deja de ser el respondedor principal: los mensajes del consumidor llegan al campo de webhook standby mientras el agente tiene el control, y la app recupera el control al enviar un mensaje o, como escalation partner configurado, al llamar a Thread Control con la acción take.[1] Tres campos de webhook transportan el tráfico, dos Terms of Service condicionan cada llamada a la API, y Meta factura directamente al negocio a $2.00 por 1 millón de tokens. El mecanismo está documentado en las páginas para desarrolladores de Meta y puede probarse en números allowlisted antes de que un consumidor real llegue al agente.
Puntos clave
- Meta Business Agent necesita tres suscripciones a campos de webhook (messages, standby y messaging_handovers), y los mensajes del consumidor pasan a standby mientras el agente tiene el control.
- Tu app toma el control al enviar cualquier mensaje y lo conserva hasta que llama a Thread Control con la acción release; en palabras de Meta, “Stopping message sends does not release control”.
- Dos Terms of Service condicionan cada llamada a la API: la del cliente en WhatsApp Manager y la del BSP en el Facebook Developer Portal.
- Los Solution Partners y Tech Providers se autentican con un Business Integration System User (BISU) token que tiene ambos permisos requeridos, además del header X-API-Version: 2.0.0.
- Un agente configurado con ai_audience ALLOWLISTED_ONLY puede activarse sin un método de pago, así que probar con consumidores allowlisted viene antes de la facturación.
Qué cambia en la configuración de tu webhook cuando Meta Business Agent está activo
Meta Business Agent requiere tres suscripciones a campos de webhook: messages, standby y messaging_handovers, todas configuradas en el Developer Portal. Qué campo transporta un mensaje del consumidor depende de quién tiene el control: standby mientras lo tiene el agente, messages mientras lo tiene tu app. Un evento messaging_handovers se dispara cada vez que el control cambia de manos, y standby es el valor predeterminado para conversaciones nuevas una vez que el agente está activado.[4]
El payload de standby contiene uno de tres objetos: standby.messages para el mensaje entrante del consumidor, standby.message_echoes para cada mensaje que envía el agente, y standby.statuses para los acuses de enviado, entregado y leído de esos mensajes.[3] El contenido entrante usa la misma estructura de payload que un webhook estándar de mensaje entrante, y tus propios mensajes salientes nunca te llegan como eco.
La guía completa de Meta Business Agent resume este modelo de enrutamiento. Para una integración construida por un BSP, el cambio de código consiste en ramificar el handler según el nombre del campo, guardar el contexto de standby para dar continuidad cuando tu app se convierta en el handler activo, y deduplicar por el id del mensaje.
Cómo funciona Thread Control entre Meta Business Agent y tu app
Thread Control es el endpoint de Cloud API que mueve el control de una conversación entre Meta Business Agent y una app. Release devuelve la conversación a Meta Business Agent como respondedor automático. Pass transfiere el control al escalation partner configurado para el número de teléfono, o al agente cuando control_pass.target_role es “ai_agent”. Ambas acciones requieren que quien llama tenga el control. Take adquiere el control de quien lo tiene en ese momento y está restringida al escalation partner configurado; otras apps reciben un error y toman el control enviando un mensaje.
La página Get Started de Meta (actualizada el 25 de agosto de 2026) documenta POST https://graph.facebook.com/v21.0//thread_control con X-API-Version: 2.0.0 y un body con messaging_product “whatsapp”, la acción, y el consumidor en el campo to. La referencia de Thread Control (Cloud API) (actualizada el 4 de septiembre de 2026) documenta las mismas tres acciones en https://api.facebook.com/business/whatsapp/phone_numbers/{phone_number_id}/thread_control con X-API-Version 1.0.0, así que prueba primero release contra tu propio entorno.[2]
Activar Meta Business Agent no pausa nada de tu lado: tu app pasa al rol de standby, y enviar cualquier mensaje desde ella transfiere de inmediato el control principal de vuelta a tu app, lo que Meta identifica como la causa más común de agentes que quedan en silencio en producción. En palabras de Meta, “Your app retains control until you explicitly release it. Stopping message sends does not release control”. Por eso, una respuesta automática que se dispara ante un mensaje de standby silencia al agente hasta que tu app llama a release.
Cuando el control cambia de manos, la app que lo perdió recibe un webhook control_taken en messaging_handovers con previous_owner_app_id, new_owner_app_id, new_owner_business_id, y la cadena de metadata de la llamada; es el único payload de messaging_handovers documentado en las páginas para desarrolladores de Meta Business Agent. Las páginas de Meta todavía no describen cómo se configura el escalation partner ni si una app de BSP puede tener ese rol.
Qué Terms of Service deben aceptarse antes de que funcionen las llamadas a la API
Dos Terms of Service condicionan cada llamada a la API de Meta Business Agent en un número gestionado por un BSP: el cliente acepta los Meta Business Agent Terms of Service en WhatsApp Manager, y el Solution Partner o Tech Provider acepta los Tech Provider Terms of Service en el Facebook Developer Portal. Hasta que ambas estén en orden, Meta rechaza las llamadas con 403 Forbidden y un error de Terms of Service.
La pestaña del lado del cliente aparece en WhatsApp Manager solo cuando al menos un número de teléfono en la WhatsApp Account (anteriormente WhatsApp Business Account o WABA) es elegible; el checklist de elegibilidad cubre esas condiciones, que incluyen números de Cloud API gestionados a través de un Solution Partner o Embedded Signup.[12]
El lado del partner requiere el estatus de Tech Provider: una app de Meta con el caso de uso de WhatsApp, verificación de negocio, App Review con dos videos de demostración, y acceso avanzado a los permisos whatsapp_business_messaging y whatsapp_business_management.[5] 360Dialog, un Official Meta Solution Partner, opera la infraestructura de WhatsApp Business API y la Partner Platform que integran los ISV y revendedores; en un número que gestiona, la aceptación de Tech Provider es el paso del lado del partner, y la aceptación en WhatsApp Manager es el paso propio del negocio.
Qué pasa con los BISU tokens y los permisos de system user
Los Solution Partners y Tech Providers autentican las llamadas a la API de Meta Business Agent Platform en nombre de las WABA de sus clientes con un Business Integration System User (BISU) token, mientras que los integradores directos usan un system user token para su propia WABA. Ambos tipos de token requieren whatsapp_business_messaging y whatsapp_business_management. Un BISU token permite que una sola plataforma actúe para varias WABA de clientes bajo una única credencial y se obtiene mediante Embedded Signup con Facebook Login for Businesses.[6] Un token al que le falte alguno de los dos permisos devuelve 401, según el Quickstart de Meta.[11]
Cada solicitud a la Platform API también necesita el header X-API-Version: 2.0.0; sin él, las solicitudes usan por defecto 1.0.0, donde el endpoint de Skills no está disponible. En una integración directa, el system user debe tener el rol de Admin y la WABA asignada con “View and manage phone numbers” habilitado.
¿Listo para ejecutar Meta Business Agent en tu propio número de WhatsApp Business API? Obtener acceso a la API.
Las respuestas del agente aparecen en tu dashboard o inbox de BSP
Que las respuestas del agente aparezcan en tu dashboard o inbox de BSP depende de si el BSP conectó el campo de webhook standby a ese producto. Meta entrega cada respuesta del agente a tu app como un eco en standby.message_echoes, que contiene el body exacto de la solicitud enviada a POST /{phone-number-id}/messages, con acuses de entregado y leído en standby.statuses. Meta no documenta el comportamiento del inbox de ningún BSP, así que consulta con tu proveedor y prueba en un número allowlisted.
El handoff hacia un humano, del lado del agente, se rige por dos campos de Agent Settings: handoff.enabled controla si el agente libera el control de la conversación después de enviar un mensaje de handoff, y handoff.message_selection elige DEFAULT, AGENT o CUSTOM como fuente de ese mensaje.[8] La documentación de Meta no especifica qué dispara un handoff; la respuesta del endpoint Agent Test incluye un campo handoff_reason para observarlo.
Qué mensajes factura Meta y cuáles factura tu BSP
Meta factura directamente al negocio por cada mensaje de Meta Business Agent, incluidos los negocios que acceden a la WhatsApp Business Platform a través de un Solution Provider, a una tarifa global única de $2.00 por 1 millón de tokens; un mensaje típico consume entre 20,000 y 25,000 tokens, aproximadamente 4 a 5 centavos de dólar, ya que es un único cargo por token que cubre tanto el procesamiento como la entrega del agente.[7] La ventana gratuita de 72 horas de entrada y la ventana de servicio al cliente de 24 horas no eximen a los mensajes del agente. Un mensaje que no es de plantilla se cobra como mensaje de agente o como mensaje de servicio, nunca como ambos, así que una respuesta humana después de un handoff es un mensaje de servicio: gratis hasta el 1 de octubre de 2026, y desde entonces se cobra por mensaje.
Meta no entregará mensajes del agente para un negocio sin un método de pago en su cuenta de Business Agent: una línea de crédito de Meta facturada mensualmente o, a partir del 8 de septiembre de 2026, una tarjeta de crédito o débito Visa o Mastercard. Las líneas de crédito, tarjetas, monedas y facturas se cubren en quién factura los mensajes de Meta Business Agent.
Qué debes probar antes de activar Meta Business Agent
Prueba en un número en vivo con el agente restringido a consumidores allowlisted; con el ai_audience predeterminado de EVERYONE, el agente responde a todos los consumidores. El orden documentado por Meta es agregar cada consumidor de prueba con POST /{entity_id}/agent_config/allowlist (un consumer_phone_number por llamada, en formato E.164), configurar ai_audience como ALLOWLISTED_ONLY con PUT /{entity_id}/agent_config/settings, verificarlo con GET, y solo entonces configurar rollout.enabled como true.[9] Un agente activado con ai_audience en ALLOWLISTED_ONLY no requiere un método de pago, así que un cliente de BSP puede probar de extremo a extremo antes de configurar la facturación; activarlo para EVERYONE, o ampliar a EVERYONE después, sí lo requiere y devuelve un 400 hasta que se agregue uno.[10]
Antes de hacer el cambio, ejecuta estas verificaciones:
- Ambas Terms of Service están aceptadas, y una llamada de prueba ya no devuelve 403.
- La app está suscrita a los tres campos de webhook, y un mensaje de un consumidor allowlisted llega a standby.
- Toda automatización que pueda enviar mensajes en este número está inventariada; cada una que se dispare le quita el control al agente.
- Una llamada de release tiene éxito, y el siguiente mensaje del consumidor vuelve a llegar a standby.
- Se llamó a Onboarding para el número; de lo contrario, las llamadas de configuración devuelven un 500 con “no workspace found”.
Meta Business Agent agrega un segundo respondedor a un número, y la falla documentada más común, un agente en silencio en producción, se reduce a cuál de los dos tiene el control. Una integración que sabe qué campo está leyendo, libera lo que toma, y comprueba la secuencia primero en un allowlist, está lista para el cambio que describe la cobertura inicial de lanzamiento de 360Dialog.
Para revisar qué implica activar Meta Business Agent en un número gestionado a través de 360Dialog, habla con nosotros.
Preguntas frecuentes
Cuál es la diferencia entre release y pass en Thread Control
Release devuelve una conversación a Meta Business Agent como respondedor automático, mientras que pass transfiere el control al escalation partner configurado para el número de teléfono, o al agente cuando control_pass.target_role es “ai_agent”. Ambas requieren que quien llama tenga el control, y después de release los mensajes del consumidor vuelven a tu campo de standby.
Qué es un escalation partner en Meta Business Agent
Un escalation partner es el negocio configurado para un número de teléfono que puede llamar a Thread Control con la acción take, adquiriendo el control de Meta Business Agent, de otra app, o de una conversación inactiva. Otras apps reciben un error al intentar take, y Meta todavía no documenta cómo se configura el escalation partner.
Necesito un BISU token si integro directamente con Cloud API
Un integrador directo se autentica con un system user token para su propia WhatsApp Account. Un Business Integration System User (BISU) token es para Solution Partners y Tech Providers que llaman a las API de Meta Business Agent Platform en nombre de las WhatsApp Account de sus clientes. Ambos tipos de token requieren los permisos whatsapp_business_messaging y whatsapp_business_management.
Qué pasa si mi app nunca llama a la acción release de Thread Control
Tu app conserva el control de cada conversación en la que envió un mensaje, y Meta Business Agent no responde ahí hasta que se libera el control. Meta indica que dejar de enviar mensajes no libera el control, así que los mensajes del consumidor siguen llegando a tu campo messages mientras el agente permanece en silencio.
Puedo limitar Meta Business Agent a números de prueba antes de salir en vivo
Meta Business Agent puede limitarse a números de prueba agregando cada consumidor al allowlist y configurando ai_audience como ALLOWLISTED_ONLY antes de configurar rollout.enabled como true. Con el valor predeterminado EVERYONE, el allowlist se ignora. Un agente restringido solo al allowlist puede activarse sin un método de pago; ampliar a EVERYONE sí lo requiere.
Fuentes
[1] “Get started with Meta Business Agent Platform APIs.” Updated August 25, 2026. https://developers.facebook.com/documentation/meta-business-agent/get-started. Accessed September 7, 2026.
[2] “Thread Control (Cloud API).” Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/operate/thread-control-cloud-api. Accessed September 7, 2026.
[3] “Standby webhooks.” Updated August 4, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/standby. Accessed September 7, 2026.
[4] “Meta Business Agent Troubleshooting.” Updated August 27, 2026. https://developers.facebook.com/documentation/meta-business-agent/troubleshooting. Accessed September 7, 2026.
[5] “Become a Tech Provider.” Updated August 20, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/get-started-for-tech-providers. Accessed September 7, 2026.
[6] “Access Tokens.” Updated June 30, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens/. Accessed September 7, 2026.
[7] “Upcoming pricing updates for Meta Business Agent, service and utility messages.” Updated August 25, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages. Accessed September 7, 2026.
[8] “Agent Settings.” Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings. Accessed September 7, 2026.
[9] “Agent Allowlist.” Updated September 4, 2026. https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-allowlist. Accessed September 7, 2026.
[10] “Meta Business Agent Changelog.” Updated September 3, 2026. https://developers.facebook.com/documentation/meta-business-agent/changelog/. Accessed September 7, 2026.
[11] “Meta Business Agent Quickstart.” Updated August 27, 2026. https://developers.facebook.com/documentation/meta-business-agent/quickstart. Accessed September 7, 2026.
[12] “Meta Business Agent Platform overview.” Updated August 28, 2026. https://developers.facebook.com/documentation/meta-business-agent/overview. Accessed September 7, 2026.
