Skip to main content
Conclua este guia antes de criar um agente. O resultado é um número de telefone do WhatsApp Business elegível e uma lista clara de quaisquer pré-requisitos que ainda bloqueiam a integração.

Antes de começar

Verifique a elegibilidade antes de pedir ao proprietário da empresa para concluir a configuração. A aceitação dos termos e a configuração de faturamento ocorrem fora da API da YCloud. A YCloud não pode concluir essas ações em nome do proprietário da empresa.

Armazenar a chave de API e o ID do número de telefone

Mantenha a chave de API em seu servidor e defina o ID do número de telefone separadamente do número de telefone voltado para o cliente.

Verificar a elegibilidade

A elegibilidade é avaliada para o número de telefone individual do WhatsApp Business. Referência da API: GET Check Eligibility
Uma resposta elegível é:

Decidir se deve continuar

Aceitar os termos no Gerenciador do WhatsApp

Após a confirmação da elegibilidade, abra o Gerenciador do WhatsApp e selecione a conta empresarial proprietária do número de telefone. Em Ferramentas da conta, abra Meta Business Agent. A página de aceitação dos termos do Meta Business Agent no Gerenciador do WhatsApp, com o botão Configurar o Meta Business Agent. Selecione Configurar o Meta Business Agent. Conforme indicado na página, continuar significa que a empresa concorda com os Termos e a Política de Privacidade da Meta AI. Uma pessoa com acesso à empresa proprietária deve concluir esta etapa. Abrir a página a partir de outra conta empresarial não concede autoridade para aceitar os termos em nome do proprietário.
Esta ação de aceitação ocorre no Gerenciador do WhatsApp. Ela não é executada por POST Onboard Agent, e a YCloud não pode aceitar os termos pelo proprietário da empresa. Se uma solicitação de integração ou configurações retornar 403, confirme se essa configuração foi concluída para a WABA proprietária do número de telefone.

Adicionar uma forma de pagamento

A Meta exige uma linha de crédito de cliente para o uso do Meta Business Agent. Antes da integração, configure-a no Hub de Faturamento da empresa proprietária:
  1. Faça login como administrador da empresa ou usuário financeiro que pode gerenciar o faturamento da empresa proprietária da WABA.
  2. Abra o Hub de Faturamento e, em seguida, abra Linhas de crédito.
  3. Se a empresa já tiver uma linha de crédito de cliente, adicione a conta do Meta Business Agent a essa linha de crédito. Caso contrário, solicite uma linha de crédito de cliente.
  4. Confirme se a linha de crédito está disponível para a conta do Meta Business Agent antes de integrar o número de telefone.
O gerenciamento de linha de crédito pode ainda não estar disponível no Hub de Faturamento de todas as empresas. Se a ação necessária estiver ausente, entre em contato com o suporte da Meta em vez de chamar repetidamente a API de integração.
A configuração de faturamento ocorre fora da API da YCloud. A YCloud não pode criar, aprovar ou associar uma linha de crédito de cliente para a empresa. Se a integração permanecer bloqueada após a configuração de faturamento, confirme se a conta do Meta Business Agent está associada à linha de crédito pretendida na empresa proprietária da WABA.

Verificar o suporte ao número do usuário final

Números de telefone de usuários finais com o código de chamada do país +86 não são suportados atualmente pelo Meta Business Agent. O número ainda pode ser sintaticamente válido no formato E.164, mas o agente não responderá às mensagens desse usuário final. Use um número não +86 suportado para testes na lista de permissões e validação ao vivo.
Não armazene a elegibilidade em cache indefinidamente. Verifique-a novamente ao integrar um número de telefone diferente ou depois que um número anteriormente inelegível se tornar disponível.

A seguir: Integrar e configurar

Crie o agente, mantenha a implementação restrita e adicione sua configuração inicial.