Skip to main content
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.
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 para o número de telefone que você planeja usar.

Conceitos básicos da API

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.
  2. Fazer a integração e configurar o agente em um estado de teste restrito.
  3. Testar e avaliar cenários de turno único, múltiplos turnos e cenários de negócios representativos.
  4. Lançar com segurança a partir de destinatários em lista de permissões para todo o público.
  5. Operar e solucionar problemas 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. Esta versão documenta 62 operações REST. Agentes criados via API também podem emitir eventos de Webhook de eco e transferência.

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.