Para conectar um número novo à ConverZAP pela API oficial do WhatsApp, um administrador do workspace abre Configurações → Integrações, clica em “Número novo” no quadro “Conectar WhatsApp com o Facebook” e conclui o cadastro incorporado da Meta na janela que se abre. Não é preciso copiar token, ID da conta (WABA) nem App Secret: a ConverZAP recebe a autorização da Meta, registra o número na API oficial e passa a receber os eventos do WhatsApp. A conta do WhatsApp Business continua sendo da empresa, e as mensagens são cobradas pela Meta na conta da empresa.
Pré-requisitos
- Acesso de administrador no workspace da ConverZAP: o quadro de conexão só aparece para administradores.
- Uma conta do Facebook que administre a empresa na Meta. Durante o fluxo, é possível escolher um portfólio empresarial (Business Manager) existente ou criar um novo, assim como escolher ou criar a conta do WhatsApp Business.
- Um número que não esteja em nenhum WhatsApp. Se o número já usa o app WhatsApp Business no celular, siga o guia de coexistência. Se está no WhatsApp comum, é preciso passá-lo para o app WhatsApp Business ou apagar a conta no celular antes.
- Acesso ao número para concluir a verificação que a Meta solicitar durante o cadastro.
- Navegador sem bloqueador de anúncios ativo na página, porque ele pode impedir o carregamento do login do Facebook.
Passo a passo na ConverZAP
- No menu lateral, clique em Configurações e depois em Integrações. Se ainda não houver número conectado, o mesmo quadro também aparece na tela Saúde do WhatsApp.
- No quadro “Conectar WhatsApp com o Facebook”, clique em “Número novo”.
- Na janela da Meta, entre com a conta do Facebook que administra a empresa.
- Escolha ou crie o portfólio empresarial e a conta do WhatsApp Business, informe o número e siga as etapas de verificação exibidas pela Meta.
- Ao terminar, a ConverZAP mostra a mensagem “WhatsApp conectado” com o número e o nome verificado. Os números e templates da conta aparecem em instantes.
- Abra Saúde do WhatsApp para conferir o número, a qualidade e o limite diário. Se precisar, clique em “Atualizar agora” para buscar os dados mais recentes na Meta.
Conectar de novo a mesma conta do WhatsApp Business não cria uma integração duplicada: a ConverZAP atualiza a conexão existente e mostra “WhatsApp reconectado”.
Forma de pagamento no WhatsApp Manager
Depois de conectar, adicione a forma de pagamento da empresa no WhatsApp Manager da Meta (business.facebook.com/wa/manage). Sem ela, a Meta não envia mensagens. A cobrança das conversas é feita pela Meta diretamente na conta da empresa, e não pela ConverZAP. Para estimar o custo, use a calculadora de custo da API do WhatsApp.
Erros comuns
“Não foi possível carregar o login do Facebook”
O navegador bloqueou o script de login do Facebook, geralmente por bloqueador de anúncios. Desative o bloqueador para a ConverZAP e recarregue a página.
“Conexão cancelada antes de terminar” ou “Login do Facebook não concluído”
A janela da Meta foi fechada antes do fim. Clique em “Número novo” de novo e conclua todas as etapas.
“A Meta não aceitou a autorização”
O código de autorização gerado pela Meta vale 30 segundos. Se a conclusão demorou, repita a conexão.
Número já registrado em uma conta do WhatsApp
O fluxo de número novo recusa número ativo em um app de WhatsApp. Se o número está no app WhatsApp Business, use o botão “Número que já usa o app WhatsApp Business” (coexistência).
“Este número já está conectado a outro workspace do ConverZap”
Cada número só pode estar ligado a um workspace. Remova a integração no outro workspace antes de conectar.
“Nenhum número foi adicionado nesta conta ainda”
A conta do WhatsApp Business foi autorizada, mas sem número. Adicione o número no WhatsApp Manager e clique em “Atualizar agora” na tela Saúde do WhatsApp.
Dica: se a conexão foi concluída mas aparece o aviso “a Meta não concluiu o registro”, aguarde alguns minutos e conecte novamente; reconectar a mesma conta apenas atualiza a integração.