> ## 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.

# Visão geral do Meta Business Agent

> Crie e opere um agente de IA hospedado pela Meta para um número de telefone do WhatsApp Business por meio das APIs da YCloud.

O Meta Business Agent é um agente de IA hospedado pela Meta que pode responder a mensagens de clientes no WhatsApp usando as informações comerciais, conhecimentos, habilidades e ferramentas que você configurar. A YCloud disponibiliza o ciclo de vida do Meta Business Agent por meio da API REST da YCloud e fornece as credenciais da Meta em seu nome.

<Warning>
  O Meta Business Agent é um produto da Meta em acesso antecipado. A disponibilidade, a validação e o comportamento de execução podem mudar independentemente da YCloud. Sempre chame o [endpoint Check Eligibility](/api-reference/meta-business-agents/check-eligibility) para o número de telefone que você planeja usar.
</Warning>

## Conceitos básicos da API

| Item | Valor |
| - | - |
| URL base | `https://api.ycloud.com/v2` |
| Autenticação | `X-API-Key: YOUR_API_KEY` |
| Caminho do recurso | `/metaBusinessAgents/{entityId}` |
| `entityId` | O ID do número de telefone do WhatsApp Business proprietário do agente |
| Nomenclatura do payload | `snake_case` |

A YCloud resolve o tenant e o token de acesso da Meta a partir da sua chave de API. Não envie um token de acesso da Meta nessas solicitações.

## Ciclo de vida recomendado

Siga os guias de criação e lançamento em ordem. Eles conectam os recursos individuais da API em um processo de implantação de ponta a ponta.

1. [Preparar e verificar elegibilidade](/pt/documentation/meta-business-agent/prepare-and-check-eligibility).
2. [Fazer a integração e configurar](/pt/documentation/meta-business-agent/onboard-and-configure) o agente em um estado de teste restrito.
3. [Testar e avaliar](/pt/documentation/meta-business-agent/test-and-evaluate) cenários de turno único, múltiplos turnos e cenários de negócios representativos.
4. [Lançar com segurança](/pt/documentation/meta-business-agent/roll-out-safely) a partir de destinatários em lista de permissões para todo o público.
5. [Operar e solucionar problemas](/pt/documentation/meta-business-agent/operate-and-troubleshoot) do agente em produção.

## Recursos cobertos pelo fluxo de trabalho

Cada diretório de Referência da API tem sua própria página inicial e links para todos os endpoints daquela área.

| Área | O que você pode fazer | Referência da API |
| - | - | - |
| Integrar | Verificar a elegibilidade, integrar ou excluir um agente, gerenciar configurações de perfil e orçamentos, e manter entradas na lista de permissões | [Abrir diretório](/pt/api-reference/meta-business-agents/onboard) |
| Configurar | Gerenciar conhecimentos de negócios, habilidades comportamentais e de interface do usuário, conectores, credenciais e ferramentas de conectores | [Abrir diretório](/pt/api-reference/meta-business-agents/configure) |
| Operar | Enviar eventos, inspecionar turnos de conversa, testar respostas, controlar threads de conversa, executar avaliações e recuperar resultados | [Abrir diretório](/pt/api-reference/meta-business-agents/operate) |

Esta versão documenta 62 operações REST. Agentes criados via API também podem emitir
[eventos de Webhook de eco e transferência](/pt/api-reference/guides/examples/webhook-examples/overview#echo-and-agent-handover-events).

## Propriedade e isolamento

Exceto para elegibilidade, as operações com escopo de número de telefone exigem uma associação ativa de agente da API pública pertencente ao mesmo tenant da YCloud. A YCloud retorna `404` quando a associação está ausente, pertence a outro tenant ou foi criada por meio de uma origem incompatível. Isso impede que um tenant ou superfície de integração acesse outro agente.


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