{"id":1737,"date":"2026-09-07T08:34:15","date_gmt":"2026-09-07T08:34:15","guid":{"rendered":"https:\/\/360dialog.com\/blog\/?p=1737"},"modified":"2026-09-07T08:55:30","modified_gmt":"2026-09-07T08:55:30","slug":"integracion-bsp-meta-business-agent-whatsapp","status":"publish","type":"post","link":"https:\/\/360dialog.com\/blog\/es\/integracion-bsp-meta-business-agent-whatsapp\/","title":{"rendered":"Qu\u00e9 pasa con tu integraci\u00f3n de BSP cuando se activa Meta Business Agent"},"content":{"rendered":"\n

Cuando Meta Business Agent se activa en un n\u00famero de WhatsApp gestionado a trav\u00e9s 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\u00f3n take.<\/strong>[1] Tres campos de webhook transportan el tr\u00e1fico, dos Terms of Service condicionan cada llamada a la API, y Meta factura directamente al negocio a $2.00 por 1 mill\u00f3n de tokens. El mecanismo est\u00e1 documentado en las p\u00e1ginas para desarrolladores de Meta y puede probarse en n\u00fameros allowlisted antes de que un consumidor real llegue al agente.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Puntos clave<\/h2>\n\n\n\n
    \n
  1. 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.<\/li>\n\n\n\n
  2. Tu app toma el control al enviar cualquier mensaje y lo conserva hasta que llama a Thread Control con la acci\u00f3n release; en palabras de Meta, “Stopping message sends does not release control”.<\/li>\n\n\n\n
  3. 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.<\/li>\n\n\n\n
  4. Los Solution Partners y Tech Providers se autentican con un Business Integration System User (BISU) token que tiene ambos permisos requeridos, adem\u00e1s del header X-API-Version: 2.0.0.<\/li>\n\n\n\n
  5. Un agente configurado con ai_audience ALLOWLISTED_ONLY puede activarse sin un m\u00e9todo de pago, as\u00ed que probar con consumidores allowlisted viene antes de la facturaci\u00f3n.<\/li>\n<\/ol>\n\n\n\n

    <\/p>\n\n\n\n

    Qu\u00e9 cambia en la configuraci\u00f3n de tu webhook cuando Meta Business Agent est\u00e1 activo<\/h2>\n\n\n\n

    Meta Business Agent requiere tres suscripciones a campos de webhook: messages, standby y messaging_handovers, todas configuradas en el Developer Portal. Qu\u00e9 campo transporta un mensaje del consumidor depende de qui\u00e9n 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\u00e1 activado.[4]<\/p>\n\n\n\n

    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\u00eda el agente, y standby.statuses para los acuses de enviado, entregado y le\u00eddo de esos mensajes.[3] El contenido entrante usa la misma estructura de payload que un webhook est\u00e1ndar de mensaje entrante, y tus propios mensajes salientes nunca te llegan como eco.<\/p>\n\n\n\n

    La gu\u00eda completa de Meta Business Agent<\/a> resume este modelo de enrutamiento. Para una integraci\u00f3n construida por un BSP, el cambio de c\u00f3digo consiste en ramificar el handler seg\u00fan 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.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    C\u00f3mo funciona Thread Control entre Meta Business Agent y tu app<\/h2>\n\n\n\n

    Thread Control es el endpoint de Cloud API que mueve el control de una conversaci\u00f3n entre Meta Business Agent y una app. Release devuelve la conversaci\u00f3n a Meta Business Agent como respondedor autom\u00e1tico. Pass transfiere el control al escalation partner configurado para el n\u00famero de tel\u00e9fono, 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\u00e1 restringida al escalation partner configurado; otras apps reciben un error y toman el control enviando un mensaje.<\/p>\n\n\n\n

    La p\u00e1gina Get Started de Meta (actualizada el 25 de agosto de 2026) documenta POST https:\/\/graph.facebook.com\/v21.0\/<\/a>\/thread_control con X-API-Version: 2.0.0 y un body con messaging_product “whatsapp”, la acci\u00f3n, 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<\/a> con X-API-Version 1.0.0, as\u00ed que prueba primero release contra tu propio entorno.[2]<\/p>\n\n\n\n

    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\u00e1s com\u00fan de agentes que quedan en silencio en producci\u00f3n. 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\u00e1tica que se dispara ante un mensaje de standby silencia al agente hasta que tu app llama a release.<\/p>\n\n\n\n

    Cuando el control cambia de manos, la app que lo perdi\u00f3 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 \u00fanico payload de messaging_handovers documentado en las p\u00e1ginas para desarrolladores de Meta Business Agent. Las p\u00e1ginas de Meta todav\u00eda no describen c\u00f3mo se configura el escalation partner ni si una app de BSP puede tener ese rol.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Qu\u00e9 Terms of Service deben aceptarse antes de que funcionen las llamadas a la API<\/h2>\n\n\n\n

    Dos Terms of Service condicionan cada llamada a la API de Meta Business Agent en un n\u00famero 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\u00e9n en orden, Meta rechaza las llamadas con 403 Forbidden y un error de Terms of Service.<\/p>\n\n\n\n

    La pesta\u00f1a del lado del cliente aparece en WhatsApp Manager solo cuando al menos un n\u00famero de tel\u00e9fono en la WhatsApp Account (anteriormente WhatsApp Business Account o WABA) es elegible; el checklist de elegibilidad<\/a> cubre esas condiciones, que incluyen n\u00fameros de Cloud API gestionados a trav\u00e9s de un Solution Partner o Embedded Signup.[12]<\/p>\n\n\n\n

    El lado del partner requiere el estatus de Tech Provider: una app de Meta con el caso de uso de WhatsApp, verificaci\u00f3n de negocio, App Review con dos videos de demostraci\u00f3n, 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\u00famero que gestiona, la aceptaci\u00f3n de Tech Provider es el paso del lado del partner, y la aceptaci\u00f3n en WhatsApp Manager es el paso propio del negocio.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Qu\u00e9 pasa con los BISU tokens y los permisos de system user<\/h2>\n\n\n\n

    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\u00fae para varias WABA de clientes bajo una \u00fanica 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\u00fan el Quickstart de Meta.[11]<\/p>\n\n\n\n

    Cada solicitud a la Platform API tambi\u00e9n necesita el header X-API-Version: 2.0.0; sin \u00e9l, las solicitudes usan por defecto 1.0.0, donde el endpoint de Skills no est\u00e1 disponible. En una integraci\u00f3n directa, el system user debe tener el rol de Admin y la WABA asignada con “View and manage phone numbers” habilitado.<\/p>\n\n\n\n

    \u00bfListo para ejecutar Meta Business Agent en tu propio n\u00famero de WhatsApp Business API? Obtener acceso a la API<\/a>.<\/strong><\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Las respuestas del agente aparecen en tu dashboard o inbox de BSP<\/h2>\n\n\n\n

    Que las respuestas del agente aparezcan en tu dashboard o inbox de BSP depende de si el BSP conect\u00f3 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\u00eddo en standby.statuses. Meta no documenta el comportamiento del inbox de ning\u00fan BSP, as\u00ed que consulta con tu proveedor y prueba en un n\u00famero allowlisted.<\/p>\n\n\n\n

    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\u00f3n despu\u00e9s de enviar un mensaje de handoff, y handoff.message_selection elige DEFAULT, AGENT o CUSTOM como fuente de ese mensaje.[8] La documentaci\u00f3n de Meta no especifica qu\u00e9 dispara un handoff; la respuesta del endpoint Agent Test incluye un campo handoff_reason para observarlo.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Qu\u00e9 mensajes factura Meta y cu\u00e1les factura tu BSP<\/h2>\n\n\n\n

    Meta factura directamente al negocio por cada mensaje de Meta Business Agent, incluidos los negocios que acceden a la WhatsApp Business Platform a trav\u00e9s de un Solution Provider, a una tarifa global \u00fanica de $2.00 por 1 mill\u00f3n de tokens; un mensaje t\u00edpico consume entre 20,000 y 25,000 tokens, aproximadamente 4 a 5 centavos de d\u00f3lar, ya que es un \u00fanico 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\u00ed que una respuesta humana despu\u00e9s de un handoff es un mensaje de servicio: gratis hasta el 1 de octubre de 2026, y desde entonces se cobra por mensaje.<\/p>\n\n\n\n

    Meta no entregar\u00e1 mensajes del agente para un negocio sin un m\u00e9todo de pago en su cuenta de Business Agent: una l\u00ednea de cr\u00e9dito de Meta facturada mensualmente o, a partir del 8 de septiembre de 2026, una tarjeta de cr\u00e9dito o d\u00e9bito Visa o Mastercard. Las l\u00edneas de cr\u00e9dito, tarjetas, monedas y facturas se cubren en qui\u00e9n factura los mensajes de Meta Business Agent<\/a>.<\/p>\n\n\n\n

    <\/p>\n\n\n\n

    Qu\u00e9 debes probar antes de activar Meta Business Agent<\/h2>\n\n\n\n

    Prueba en un n\u00famero 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\u00e9todo de pago, as\u00ed que un cliente de BSP puede probar de extremo a extremo antes de configurar la facturaci\u00f3n; activarlo para EVERYONE, o ampliar a EVERYONE despu\u00e9s, s\u00ed lo requiere y devuelve un 400 hasta que se agregue uno.[10]<\/p>\n\n\n\n

    Antes de hacer el cambio, ejecuta estas verificaciones:<\/p>\n\n\n\n