Como conectar o número à Agnus Vox

O que você vai aprender

Como conectar um número de WhatsApp ao Agnus Vox pela API Oficial e pelas conexões v1/v2 (QR Code).

Antes de começar

Confira os itens da aula Requisitos para utilizar a API Oficial, principalmente o acesso de administrador ao Business Manager.

Passo a passo — API Oficial

1. Em Conexão → WhatsApp, clique em Nova Conexão.

   

2. Escolha API Oficial ("Conexão oficial via Meta, com aprovação da conta"). Abre uma nova aba "Conexão API Oficial do WhatsApp".

   

3. Clique em Conectar com Facebook e faça login com o perfil que é administrador do Business Manager.

   

   A partir daqui a tela é da Meta

   Depois de clicar em Conectar com Facebook, as telas do cadastro incorporado são da Meta e podem mudar. Siga os passos abaixo na ordem em que a Meta apresentar.

4. No cadastro incorporado da Meta:

   1. Selecione (ou crie) o Portfólio empresarial / Business Manager.
   2. Selecione (ou crie) a conta do WhatsApp Business (WABA).
   3. Preencha o perfil: nome de exibição, categoria, descrição e site.
   4. Escolha o número. Para número novo, você recebe um código por SMS ou ligação, e o número não pode estar ativo em nenhum WhatsApp. Para usar o app WhatsApp Business existente (coexistência), a Meta mostra um QR Code que você lê no app em Configurações > Conta > Plataforma de Negócios.
   5. Revise as permissões e clique em Concluir.

5. Volte para a aba do Agnus Vox. A conexão aparece na lista com o selo API OFICIAL, o ID da conta e o número. Aguarde o status ATIVO.

6. No Gerenciador do WhatsApp (business.facebook.com), adicione a forma de pagamento na WABA. Sem isso, templates de marketing não são entregues.

7. Faça um teste: mande uma mensagem de outro celular para o número e confira se ela aparece em Conversas.

Passo a passo — v1 / v2 (QR Code)

1. Nova Conexão → escolha v1 ou v2.
2. No celular: WhatsApp → Aparelhos conectados → Conectar um aparelho → leia o QR Code exibido.
3. Aguarde o status ATIVO. Mantenha o celular com internet.

Ações na lista de conexões

Status da conta

Ao clicar na seta (▼) (7) da conexão, abre o painel STATUS DA CONTA (8). Ele mostra:

• o status da WABA (por exemplo, Aprovada);
• o número conectado, com o nome de exibição;
• se a conexão está Conectada;
• o limite de conversas por dia da conta.

O indicador ATIVO (4) na lista confirma que o sistema está recebendo as mensagens desse número.

Resultado esperado

Conexão com status ATIVO e mensagens recebidas aparecendo em Conversas.

Próximos passos

Crie seus templates em Como criar templates de marketing e utilidade. Se algo der errado, veja Problemas comuns na configuração da API.