Técnico

Meta Business Agent Platform: API, conectores y control de conversación

La diferencia entre un agente que responde bien y uno que resuelve está en esta capa: conocimiento propio, herramientas contra tus sistemas y un escalado a humano que funciona de verdad.

Conocimiento, instrucciones, conectores, webhooks, pruebas y evaluación
Control de conversación real entre el agente y tu aplicación
Patrón multicliente para socios tecnológicos de Meta

Hablar con nuestro equipo técnico Ver el servicio de implementación

Última actualización: septiembre de 2026

La respuesta corta

Meta Business Agent Platform es la capa de APIs con la que se configura y opera el agente de WhatsApp: se le carga conocimiento, se le fijan instrucciones de marca, se le declaran las APIs propias como herramientas, se suscriben webhooks y se gobierna quién controla cada conversación, el agente o tu aplicación.

Hoy la plataforma cubre exclusivamente WhatsApp, sobre la Cloud API. La activación desde la app de WhatsApp Business no da acceso a ninguna de estas superficies.

Fuente: documentación oficial de Meta Business Agent Platform, 2026.

Requisitos y accesos

Antes de la primera llamada hay que tener resuelta la parte aburrida, que es donde se atascan la mayoría de las integraciones.

Una cuenta de WhatsApp Business con un número elegible para el agente
Una app de Meta con los permisos de mensajería y de gestión de WhatsApp Business
Un usuario de sistema con rol de administrador, con la app y la cuenta de WhatsApp Business asignadas
Un método de pago activo en el Billing Hub: sin él los mensajes no se entregan
La app suscrita a la cuenta de WhatsApp Business

El detalle que rompe integraciones: la versión de la API

Es el error más silencioso de toda la plataforma y cuesta horas de depuración.

Hay que enviar la cabecera de versión de API 2.0.0 en todas las peticiones
Si se omite, la petición cae a la versión 1.0.0
En la versión 1.0.0 el endpoint de instrucciones del agente no existe, así que la llamada falla sin motivo aparente

Conocimiento: de dónde saca las respuestas

El conocimiento no es un prompt gigante: son cuatro superficies distintas que se mantienen por separado y se pueden auditar.

Información del negocio: los datos básicos con los que responde
Preguntas frecuentes: pares de pregunta y respuesta controlados por ti
Webs: URLs que la plataforma rastrea para extraer contenido
Ficheros: documentos que se suben como fuente de conocimiento
Los insights de conocimiento muestran qué se está usando y qué no, que es la base para depurar respuestas malas

Instrucciones: la voz y los límites

Aquí se define cómo se comporta el agente. Es el equivalente a las instrucciones de sistema, y es lo que separa un agente de marca de un bot genérico.

Tono y estilo de las respuestas
Qué prioriza cuando hay varias respuestas posibles
Qué no debe decir nunca y cuándo debe escalar en lugar de improvisar
Respuestas cortas y concretas, que además reducen el consumo de tokens

Conectores y herramientas: donde el agente deja de hablar y empieza a hacer

Un conector es la definición de una API externa. Sus herramientas son las operaciones concretas que el agente puede invocar durante una conversación.

Se declara el conector con la definición de tu API
Se declaran sus herramientas: consultar un pedido, comprobar stock, buscar huecos de agenda, crear una reserva
El agente decide cuándo invocarlas a partir de la conversación
Meta añade además conexiones a cientos de sistemas de terceros, con Shopify, Zendesk y Shopee entre los nombrados

Webhooks y control de conversación

Este es el bloque que más se subestima. Sin él, el escalado a una persona es un mensaje pidiendo que llame por teléfono.

Se suscriben tres campos de webhook: mensajes, escucha y cambios de control
Por defecto responde el agente y tu aplicación observa la conversación en modo de escucha
Tu aplicación toma el control del hilo con una acción explícita, o implícitamente al enviar un mensaje
Cuando el caso está cerrado, devuelve el control y el agente vuelve a responder
Cada cambio de control llega por webhook, así que queda registrado quién atendió y cuándo

Pruebas, evaluación e insights

La plataforma permite validar el agente antes de que hable con un cliente real. Saltarse este paso es la forma más rápida de quemar la confianza en el canal.

Envío de mensajes de prueba contra el agente configurado
Evaluación del rendimiento antes y después de salir a producción
Insights de uso del conocimiento para detectar lagunas
Eventos disparados desde tu sistema para que el agente reaccione a cambios de tu operación

Salida controlada con lista blanca

La forma sensata de lanzar: el agente habilitado, pero hablando sólo con quien tú decidas.

Se cargan los números autorizados en formato internacional E.164
Se pone la audiencia del agente en modo restringido a la lista
El agente se habilita sólo después de tener las dos cosas en su sitio
Por defecto la audiencia es todo el mundo y la lista blanca se ignora, así que el orden importa

Patrón para socios tecnológicos

Si la integración atiende a varios clientes, el modelo de credenciales cambia y conviene montarlo bien desde el primer proyecto.

Un integrador directo usa un token de usuario de sistema propio
Un socio tecnológico que opera para terceros usa un token de usuario de sistema de integración de negocio
Ese patrón permite gestionar muchas cuentas de cliente sin compartir credenciales entre ellas
Es el modelo con el que trabajamos como Meta Tech Provider

Referencia de endpoints

La secuencia real de la plataforma, agrupada por fase.

Endpoint	Fase	Para qué sirve
GET /agent_config/eligibility	Alta	Comprobar si el número puede tener agente
POST /agent_config	Alta	Dar de alta el agente, obligatorio antes de habilitarlo
PUT /agent_config/settings	Alta	Habilitar el agente y configurar su comportamiento
PUT /agent_config/skills	Configuración	Instrucciones de sistema: tono, prioridades y límites
POST /agent_config/knowledge/business_info	Configuración	Información del negocio
POST /agent_config/knowledge/faqs	Configuración	Pares de pregunta y respuesta
POST /agent_config/knowledge/websites	Configuración	URLs que la plataforma rastrea
POST /agent_config/knowledge/files	Configuración	Ficheros como fuente de conocimiento
POST /agent_config/connectors	Configuración	Declarar una API externa como conector
POST /agent_config/connectors/{id}/tools	Configuración	Operaciones que el agente puede invocar
POST /{phone-number-id}/thread_control	Operación	Tomar o devolver el control de la conversación
POST /agent_config/events	Operación	Disparar acciones del agente desde tu sistema
POST /agent_config/test	Operación	Enviar mensajes de prueba
POST /agent_config/eval	Operación	Evaluar el rendimiento del agente
GET /agent_insights	Operación	Revisar el uso del conocimiento
POST /{entity-id}/agent_config/allowlist	Operación	Restringir la audiencia a números concretos

GET /agent_config/eligibility

Fase: Alta
Para qué sirve: Comprobar si el número puede tener agente

POST /agent_config

Fase: Alta
Para qué sirve: Dar de alta el agente, obligatorio antes de habilitarlo

PUT /agent_config/settings

Fase: Alta
Para qué sirve: Habilitar el agente y configurar su comportamiento

PUT /agent_config/skills

Fase: Configuración
Para qué sirve: Instrucciones de sistema: tono, prioridades y límites

POST /agent_config/knowledge/business_info

Fase: Configuración
Para qué sirve: Información del negocio

POST /agent_config/knowledge/faqs

Fase: Configuración
Para qué sirve: Pares de pregunta y respuesta

POST /agent_config/knowledge/websites

Fase: Configuración
Para qué sirve: URLs que la plataforma rastrea

POST /agent_config/knowledge/files

Fase: Configuración
Para qué sirve: Ficheros como fuente de conocimiento

POST /agent_config/connectors

Fase: Configuración
Para qué sirve: Declarar una API externa como conector

POST /agent_config/connectors/{id}/tools

Fase: Configuración
Para qué sirve: Operaciones que el agente puede invocar

POST /{phone-number-id}/thread_control

Fase: Operación
Para qué sirve: Tomar o devolver el control de la conversación

POST /agent_config/events

Fase: Operación
Para qué sirve: Disparar acciones del agente desde tu sistema

POST /agent_config/test

Fase: Operación
Para qué sirve: Enviar mensajes de prueba

POST /agent_config/eval

Fase: Operación
Para qué sirve: Evaluar el rendimiento del agente

GET /agent_insights

Fase: Operación
Para qué sirve: Revisar el uso del conocimiento

POST /{entity-id}/agent_config/allowlist

Fase: Operación
Para qué sirve: Restringir la audiencia a números concretos

Rutas según la documentación oficial de Meta a septiembre de 2026. La plataforma evoluciona rápido: verifica siempre contra la referencia vigente.

Sigue por aquí

El servicio de implementación, los requisitos de activación y el coste por tokens.

Implementación de Meta Business Agent

El servicio completo: elegibilidad, conocimiento, conectores a tus sistemas y escalado a humano.

Qué es Meta Business Agent

Qué hace, en qué canales, qué cambió en junio de 2026 y dónde están sus límites.

Precios y facturación por tokens

Cuánto cuesta cada mensaje, qué cambió el 1 de agosto y qué llega el 1 de octubre de 2026.

Cómo activarlo: requisitos y países

Ruta desde la app, ruta desde WhatsApp Manager y qué hacer si la pestaña no aparece.

Preguntas frecuentes

Sí, si integras para tu propio negocio: basta una app de Meta con los permisos correctos y un usuario de sistema. El patrón de socio tecnológico es necesario cuando operas cuentas de terceros y necesitas credenciales separadas por cliente.

Depende de las herramientas que le declares. Un conector puede exponer operaciones de lectura, como consultar un pedido, y de escritura, como crear una reserva. La superficie es la que tú decidas, y ahí es donde hay que poner los límites.

Por los webhooks. Los mensajes que atiende el agente llegan por el campo de escucha, y cada cambio de control se notifica en su propio evento. Enviar un mensaje desde tu aplicación toma el control de forma implícita.

No a la vez. Un número no puede correr varios productos de mensajería simultáneamente. Lo que sí se puede es repartir por números, o usar el control de conversación para que el agente y tu aplicación se alternen en el mismo hilo.

El agente se queda sin el dato que iba a consultar, así que la estrategia de fallo hay que definirla: escalar a una persona, responder con una alternativa segura o pedir reintento. Es parte del diseño de la integración, no algo que la plataforma resuelva sola.

Sí. Hay un endpoint de evaluación para medir el rendimiento y otro de insights que muestra qué conocimiento se está usando. Esa combinación es la que permite depurar respuestas malas en lugar de adivinar.

¿Lo integramos con tus sistemas?

Nos cuentas qué APIs tienes y qué debería resolver el agente, y te devolvemos el diseño de conectores, control de conversación y plan de pruebas.

Hablar de la integración Ver el servicio completo

¿Integramos tu API con el agente?

Hablamos con tu equipo técnico

Hablar