> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Información general de Meta Business Agent

> Cree y opere un agente de IA alojado en Meta para un número de teléfono de WhatsApp Business a través de las API de YCloud.

Meta Business Agent es un agente de IA alojado en Meta que puede responder a los mensajes de los clientes de WhatsApp utilizando la información empresarial, los conocimientos, las habilidades y las herramientas que usted configure. YCloud expone el ciclo de vida de Meta Business Agent a través de la API REST de YCloud y proporciona las credenciales de Meta en su nombre.

<Warning>
  Meta Business Agent es un producto de Meta en fase de acceso anticipado. La disponibilidad, la validación y el comportamiento en tiempo de ejecución pueden cambiar independientemente de YCloud. Llame siempre al [endpoint Check Eligibility](/api-reference/meta-business-agents/check-eligibility) para el número de teléfono que planee utilizar.
</Warning>

## Aspectos básicos de la API

| Elemento | Valor |
| - | - |
| URL base | `https://api.ycloud.com/v2` |
| Autenticación | `X-API-Key: YOUR_API_KEY` |
| Ruta del recurso | `/metaBusinessAgents/{entityId}` |
| `entityId` | El ID del número de teléfono de WhatsApp Business al que pertenece el agente |
| Nomenclatura del payload | `snake_case` |

YCloud resuelve el tenant y el token de acceso de Meta a partir de su clave de API. No envíe un token de acceso de Meta en estas solicitudes.

## Ciclo de vida recomendado

Siga las guías de creación y lanzamiento en orden. Estas conectan los recursos individuales de la API en un proceso de despliegue de extremo a extremo.

1. [Preparar y comprobar la elegibilidad](/es/documentation/meta-business-agent/prepare-and-check-eligibility).
2. [Incorporar y configurar](/es/documentation/meta-business-agent/onboard-and-configure) el agente en un estado de prueba restringido.
3. [Probar y evaluar](/es/documentation/meta-business-agent/test-and-evaluate) escenarios empresariales representativos, de un solo turno y de varios turnos.
4. [Desplegar de forma segura](/es/documentation/meta-business-agent/roll-out-safely) desde destinatarios en la lista de permitidos hasta la audiencia completa.
5. [Operar y solucionar problemas](/es/documentation/meta-business-agent/operate-and-troubleshoot) del agente en producción.

## Recursos cubiertos por el flujo de trabajo

Cada directorio de la Referencia de API tiene su propia página de destino y enlaza a cada endpoint de esa área.

| Área | Lo que puede hacer | Referencia de API |
| - | - | - |
| Incorporación | Comprobar la elegibilidad, incorporar o eliminar un agente, gestionar la configuración del perfil y presupuestos, y mantener las entradas de la lista de permitidos | [Abrir directorio](/es/api-reference/meta-business-agents/onboard) |
| Configuración | Gestionar conocimientos empresariales, habilidades de comportamiento y de interfaz de usuario, conectores, credenciales y herramientas de conectores | [Abrir directorio](/es/api-reference/meta-business-agents/configure) |
| Operación | Enviar eventos, inspeccionar turnos de conversación, probar respuestas, controlar hilos de conversación, ejecutar evaluaciones y recuperar resultados | [Abrir directorio](/es/api-reference/meta-business-agents/operate) |

Esta versión documenta 62 operaciones REST. Los agentes creados mediante la API también pueden emitir
[eventos de webhook de eco y de transferencia](/es/api-reference/guides/examples/webhook-examples/overview#echo-and-agent-handover-events).

## Propiedad y aislamiento

A excepción de la comprobación de elegibilidad, las operaciones con alcance de número de teléfono requieren una vinculación activa de agente de la API pública perteneciente al mismo tenant de YCloud. YCloud devuelve `404` cuando la vinculación no existe, pertenece a otro tenant o se creó a través de un origen incompatible. Esto evita que un tenant o una superficie de integración acceda al agente de otro.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.