Habilita Meta Business Agent en un número de WhatsApp gestionado por un BSP completando siete pasos en las herramientas de desarrollo de Meta: aceptar los términos de servicio de MBA en WhatsApp Manager, configurar la facturación, crear un usuario del sistema con rol Admin, asignar tu app y WABA a ese usuario, generar un token BISU con los permisos requeridos, suscribir tu app a la WABA y suscribirte a los campos de Webhook que enrutan las conversaciones entre el agente y tu aplicación. Para una visión más amplia del producto, consulta la guía completa de Meta Business Agent.
Puntos clave
- La configuración de Meta Business Agent en un número gestionado por un BSP requiere siete pasos independientes, cada uno dependiente de que el anterior se complete exitosamente.
- El BSP o Tech Provider debe aceptar los términos de servicio de Tech Provider en el Facebook Developer Portal antes de que las llamadas a la API de MBA funcionen.
- MBA requiere un token BISU con alcance tanto de
whatsapp_business_messagingcomo dewhatsapp_business_management; un token al que le falte cualquiera de los dos permisos devuelve un error 401 Unauthorized.[1] - La llamada a la API de Onboarding (
POST /{entity_id}/agent_onboarding) es un paso obligatorio antes de configurar el agente a través del Endpoint de Settings.[2] - Prueba con
ai_audienceconfigurado enALLOWLISTED_ONLYantes de pasar a producción. No se requiere un método de pago durante las pruebas.[3]
¿Cuáles son los prerrequisitos para habilitar Meta Business Agent en un número gestionado por un BSP?
Antes de iniciar la configuración, reúne tres IDs y confirma que tu número de teléfono es elegible. Necesitas un ID de WhatsApp Business Account (WABA) desde WhatsApp Manager, un ID de Business Portfolio desde Meta Business Suite y un App ID desde el Facebook Developer Portal.[1] La app debe tener el permiso whatsapp_business_messaging otorgado.
El número de teléfono debe cumplir las seis condiciones de elegibilidad.[4] Debe estar en un vertical compatible con una categoría de negocio válida. Todos los verticales son compatibles excepto Finanzas, Gobierno, Salud, Alcohol, Apuestas, medicamentos de venta libre y servicios matrimoniales. El número debe estar gestionado a través de Cloud API, incluyendo a través de un Solution Partner o Embedded Signup. Ni la WABA ni el negocio propietario pueden estar restringidos o prohibidos. El negocio debe estar en un país autorizado para MBA y debe cumplir con los requisitos de confianza y verificación.
Confirma la elegibilidad programáticamente con GET /{phone_number_id}/agent_eligibility usando el header X-API-Version: 2.0.0.[4] Para la lista completa de condiciones, consulta el checklist de elegibilidad.
Aceptar los términos de servicio de MBA
Acepta los términos de servicio de MBA en WhatsApp Manager navegando a la WABA correcta y abriendo la pestaña de Meta Business Agent. Esta pestaña aparece solo si al menos un número de teléfono en la WABA es elegible.[1] Selecciona los números elegibles y completa la aceptación. El agente no se habilita después de este paso.
Para números gestionados por un BSP, se requieren dos aceptaciones. El cliente acepta los términos de servicio de MBA en WhatsApp Manager. El BSP o Tech Provider debe aceptar por separado los términos de servicio de Tech Provider registrándose como Tech Provider en el Facebook Developer Portal.[1] Meta Business Agent rechaza las llamadas a la API hasta que ambos estén registrados.
Configurar la facturación para Meta Business Agent
Configura un método de pago en el Billing Hub de Meta antes de activar el agente para tráfico de producción. Los mensajes no se entregan a menos que la cuenta tenga un método de pago asociado.[1] Navega a business.facebook.com/latest/billing_hub/ y agrega un método de pago para el Business Portfolio asociado a la WABA.
Habilitar el agente con ai_audience configurado en ALLOWLISTED_ONLY no requiere un método de pago.[3] Un método de pago es necesario solo al expandir a EVERYONE.
Crear y configurar un usuario del sistema
Crea un usuario del sistema con el rol Admin en Meta Business Suite, luego asigna tanto la app como la WABA a ese usuario. Las solicitudes a la API de MBA se autentican como un usuario del sistema.[1] Si ya existe un usuario del sistema adecuado, ve directamente a la asignación de activos.
Ve a Meta Business Suite (business.facebook.com/settings/), abre Settings, selecciona System users en Users, haz clic en + Add, ingresa un nombre, selecciona el rol Admin y haz clic en Create system user.
Para asignar activos, selecciona el usuario del sistema, haz clic en el menú de tres puntos y haz clic en Assign Assets. Selecciona Apps, encuentra la app y activa la casilla. Luego encuentra la WABA, activa la casilla y haz clic en el slider junto a View and manage phone numbers. Haz clic en Assign Assets para guardar.
Si gestionas múltiples WABAs y necesitas ayuda para configurar usuarios del sistema en todas ellas, habla con 360Dialog para simplificar el proceso a través de una integración de socio única.
Generar un token BISU con los permisos requeridos
Genera un token Business Integration System User (BISU) para el usuario del sistema. Un token BISU permite que tu plataforma actúe en nombre de múltiples WABAs de clientes bajo una sola credencial.[1] Meta documenta dos opciones de token: un token estándar de usuario del sistema para integradores directos, y un token BISU para Solution Partners y Tech Providers.
MBA requiere un token BISU con alcance tanto de whatsapp_business_messaging como de whatsapp_business_management; un token al que le falte cualquiera de los dos permisos devuelve un error 401 Unauthorized.[5] Este es el punto de falla más común durante la configuración. Verifica que ambos permisos estén seleccionados antes de generar el token.
Incluye el header X-API-Version: 2.0.0 en cada solicitud a la API de MBA.[1] Las solicitudes sin este header usan la versión 1.0.0 por defecto, donde el Endpoint de Skills no está disponible.
El equipo de soporte para socios de 360Dialog puede verificar la configuración de tu token antes de que te encuentres con un error 401.
Suscribirse a los campos de Webhook requeridos
Suscribe tu app a la WABA y configura los tres campos de Webhook requeridos que conectan tu app al pipeline de conversaciones.[1]
Primero, suscribe la app a la WABA. En el Graph API Explorer, selecciona la app, elige Get App Token, selecciona el Business Portfolio y la WABA, luego envía POST /{WABA_ID}/subscribed_apps. Verifica con GET /{WABA_ID}/subscribed_apps.
Segundo, suscríbete a los campos de Webhook en el Facebook Developer Portal. Abre la app, navega a la pestaña de WhatsApp y abre Configuration. Suscríbete a tres campos: messages, standby y messaging_handovers.[1]
Estos campos establecen el enrutamiento de conversaciones entre MBA y tu aplicación. MBA actúa como el respondedor principal. Tu app de socio recibe los mensajes del consumidor en el Webhook standby mientras el agente mantiene el control, y en el Webhook messages cuando tu app tiene el control. El Webhook messaging_handovers se dispara en cada cambio de control. Tu app de socio toma el control enviando un mensaje a la conversación o llamando a Thread Control con la acción take (restringida al socio de escalamiento configurado). Para devolver el control, llama a Thread Control con la acción release. Dejar de enviar mensajes no libera el control; el Endpoint release debe llamarse explícitamente.
Para una visión más detallada de los cambios en el enrutamiento de conversaciones, consulta qué cambia en tu integración BSP.
Como BSP que gestiona la infraestructura de WhatsApp Business API para cuentas de clientes, 360Dialog, un Official Meta Solution Partner, soporta la ruta completa de habilitación de MBA para números gestionados a través de su plataforma.
Si tu plataforma está lista para la configuración de MBA, obtener acceso a la API para comenzar a construir sobre la infraestructura de WhatsApp Business API de 360Dialog.
Configurar el conocimiento, las habilidades y los conectores del agente
Configura el agente a través de tres etapas de API: Onboard, Configure y Operate. Lo mínimo para habilitar el agente es llamar al Endpoint de Onboarding y luego al Endpoint de Settings.[1]
Comienza con la API de Onboarding: envía POST /{entity_id}/agent_onboarding con un cuerpo vacío para WhatsApp.[2] Esto devuelve un agent_id y crea la configuración del agente. Hasta que esta llamada sea exitosa, todos los demás Endpoints de MBA reportan que no existe un agente para la entidad.
Después del Onboarding, configura el conocimiento a través de los Endpoints dedicados: Skills (instrucciones del sistema), Business info (horarios, ubicaciones, políticas), FAQs, Websites (URLs para que el agente rastree), Files (fuentes de conocimiento cargadas), Connectors (definiciones de API externas) y Connector tools.[1] El catálogo de productos se gestiona por separado en Meta Commerce Manager.
Configura el comportamiento de transferencia a través del Endpoint de Settings. El booleano handoff.enabled controla si el agente libera el control del hilo después de un mensaje de transferencia. El campo message_selection soporta tres modos: CUSTOM (el negocio proporciona el mensaje), AGENT (la IA compone según la conversación) y DEFAULT (mensaje estándar fijo).[3]
Probar Meta Business Agent antes de pasar a producción
Prueba con una audiencia restringida antes de exponer el agente a clientes reales. La secuencia correcta es: agregar consumidores de prueba a la lista de permitidos, configurar ai_audience en ALLOWLISTED_ONLY y luego habilitar el agente.[1] Habilitar el agente antes de restringir la audiencia lo expone a conversaciones en vivo.
Agrega números de teléfono de prueba llamando a POST /{entity_id}/agent_config/allowlist con consumer_phone_number en formato E.164.[1] Lista las entradas con GET y elimina con DELETE en el mismo Endpoint.
Habilita el agente llamando a PUT /{entity_id}/agent_config/settings con rollout.enabled configurado en true.[3] Meta también proporciona una API de prueba del agente en /{entity_id}/agent_test que envía mensajes de prueba a través del pipeline completo de forma síncrona, sin necesidad de que el agente esté habilitado y sin facturar los tokens consumidos.[5]
Antes de cambiar ai_audience a EVERYONE, confirma las suscripciones de Webhook con GET /{WABA_ID}/subscribed_apps, verifica la configuración con GET /{entity_id}/agent_config/settings, asocia un método de pago en el Billing Hub y valida la lógica de transferencia activando una escalación a través de la API de prueba del agente.[1] Monitorea el Endpoint de Agent Insights para revisar qué fuentes de conocimiento y habilidades usa el agente durante las conversaciones de prueba. Deshabilitar el agente detiene las respuestas en todos los hilos activos; rehabilitarlo lo hace responder solo a hilos nuevos.[3]
Los clientes de 360Dialog cuentan con soporte dedicado de partner en cada paso de la configuración de MBA, desde la configuración del token hasta el go-live. Obtener acceso a la API para empezar a construir.
Preguntas frecuentes
¿Puedo usar Meta Business Agent con un número gestionado por un BSP?
Sí. Meta Business Agent funciona con números gestionados a través de un BSP o Tech Provider, siempre que el número use Cloud API. El BSP o Tech Provider debe aceptar los términos de servicio de Tech Provider en el Facebook Developer Portal, y el token BISU debe incluir tanto los permisos whatsapp_business_messaging como whatsapp_business_management.
¿Meta Business Agent funciona en todos los verticales?
MBA soporta todos los verticales excepto Finanzas, Gobierno, Salud, Alcohol, Apuestas, medicamentos de venta libre y servicios matrimoniales. El número de teléfono también debe tener una categoría de negocio válida configurada en WhatsApp Manager. Confirma la elegibilidad llamando a GET /{phone_number_id}/agent_eligibility con el header X-API-Version: 2.0.0 antes de iniciar el proceso de configuración.
¿Qué pasa si al token BISU le falta un permiso?
Un token BISU al que le falte el permiso whatsapp_business_messaging o whatsapp_business_management devuelve un error 401 Unauthorized en las llamadas a la API de MBA. Regenera el token con ambos permisos seleccionados. Este es el punto de falla más común durante la configuración de MBA, así que verifica ambos alcances antes de hacer cualquier solicitud a la API.
¿Necesito configurar la facturación antes de probar?
Habilitar el agente con ai_audience configurado en ALLOWLISTED_ONLY no requiere un método de pago. Un método de pago es necesario solo al cambiar ai_audience a EVERYONE para tráfico de producción. La API de prueba del agente en /{entity_id}/agent_test también envía mensajes de prueba sin facturar los tokens consumidos.
¿Cuál es la diferencia entre las acciones release, pass y take de Thread Control?
La acción release devuelve el control de la app de socio a MBA. La acción pass transfiere el control al socio de escalamiento, o a MBA cuando control_pass.target_role está configurado en ai_agent. La acción take está restringida al socio de escalamiento configurado y toma el control de la conversación directamente.
Fuentes
[1] “Get started,” Meta for Developers, consultado el 14 de septiembre de 2026, https://developers.facebook.com/documentation/meta-business-agent/get-started.
[2] “Agent Onboarding,” Meta for Developers, consultado el 14 de septiembre de 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-onboarding.
[3] “Agent Settings,” Meta for Developers, consultado el 14 de septiembre de 2026, https://developers.facebook.com/documentation/meta-business-agent/reference/onboard/agent-settings.
[4] “Overview,” Meta for Developers, consultado el 14 de septiembre de 2026, https://developers.facebook.com/documentation/meta-business-agent/overview.
[5] “Quickstart,” Meta for Developers, consultado el 14 de septiembre de 2026, https://developers.facebook.com/documentation/meta-business-agent/quickstart.
