Como conectar o WhatsApp Business API
Nível: Iniciante
Tempo de leitura: 5 min
Plano necessário: qualquer plano (Básico, Pro ou Ultra)
O que é a WhatsApp Business API
A WhatsApp Business API é a versão profissional do WhatsApp, criada para empresas que precisam automatizar o atendimento. Diferente do aplicativo WhatsApp Business comum, ela permite integração direta com agentes de IA, como os que você cria na Wevi.
Para conectar, você precisa de um número de telefone que não esteja cadastrado em nenhuma conta WhatsApp (nem pessoal, nem Business). Se o número já tem WhatsApp, será necessário migrá-lo ou usar um número novo.
Como conectar (via Meta)
A Wevi usa o fluxo oficial de autenticação da Meta. Você não precisa criar aplicativos, gerar tokens ou configurar nada manualmente. Tudo acontece dentro de uma janela do Facebook.
O único pré-requisito é ter um número de telefone disponível, sem WhatsApp ativo (nem pessoal, nem Business). Você também precisa de uma conta no Meta Business Manager e de uma conta ativa na Wevi, em qualquer plano.
Passo a passo:
- Acesse Configurações → WhatsApp no painel da Wevi
- Na seção Canais de entrada, clique em Adicionar número
- Selecione o agente que vai responder as mensagens
- Clique em Conectar via Meta
- Uma janela do Facebook abre. Se ainda não tiver conta Meta Business, você cria ali mesmo. Depois autoriza a Wevi e seleciona (ou adiciona) o número
- Pronto. A janela fecha e o número aparece conectado
A Wevi configura o webhook e ativa o número automaticamente, sem nenhuma etapa manual.
Se você tiver mais de um número
Quando a conta WhatsApp Business tem mais de um número cadastrado, a Wevi exibe um seletor após a autorização. Escolha qual número deseja conectar e clique para confirmar.
Configurações após conectar
Mensagem de boas-vindas
Configure a primeira mensagem que o agente envia quando um novo cliente inicia conversa. No agente, acesse a aba Aparência, seção Mensagens Iniciais.
Horário de atendimento
Defina quando o agente opera. Fora do horário configurado, uma mensagem automática é enviada. No agente, acesse a aba Inteligência, seção Horário de Atendimento.
Templates para mensagens ativas
Para enviar mensagens proativamente (e não apenas responder), você precisa de templates aprovados pela Meta. Veja: O que são templates de WhatsApp →
Responsável pelo número e carteira automática
Cada número pode ter um Responsável, configurado em Configurações → WhatsApp: as conversas que chegam nele já entram atribuídas a essa pessoa. Com a chave Carteira automática ligada (é o padrão), contatos que ainda não têm dono também entram na carteira do responsável assim que mandam a primeira mensagem. Contatos que já pertencem à carteira de alguém nunca mudam de dono por essa via.
Se você quer que o responsável assuma as conversas do número, mas prefere montar as carteiras manualmente, desligue a chave Carteira automática na configuração do número.
Aviso por e-mail quando o cliente responde
Feito para números de atendimento humano (sem agente de IA) em que o responsável não fica com a Wevichat aberta o dia todo. Com o aviso ligado, sempre que um cliente responde e a conversa está sem resposta, o responsável do número recebe um e-mail com o nome de quem respondeu, um trecho da mensagem e o link direto da conversa.
Para ligar, vá em Configurações → WhatsApp, localize o número e ative a chave Aviso por e-mail. Ela só aparece em números sem agente vinculado: quando um agente responde sozinho, o aviso viraria ruído.
O ritmo é de um e-mail por espera. Se o cliente manda várias mensagens seguidas, chega um aviso só, e um novo e-mail sai apenas quando começa uma espera nova. Quem recebe é sempre o Responsável configurado no número.
Remover um número da conta
Quando um número sai de operação, ou quando você vai reconectá-lo em outro modo, vá em Configurações → WhatsApp, abra o número e clique em Remover número.
Na hora da remoção:
- O número some das listas de envio (campanhas, templates, automações e o compositor do inbox).
- Ele para de enviar e de receber mensagens.
- A chave de envio é apagada da conta.
- Os templates sincronizados daquele número saem das telas.
O que fica:
- As conversas antigas continuam no inbox, ainda ligadas ao número em que aconteceram.
- As campanhas já disparadas continuam nos relatórios.
Reconectar o mesmo número depois traz o envio de volta ligado a esse mesmo histórico. A Wevichat reconhece que é o número que já esteve na conta e reaproveita a conexão antiga, em vez de começar do zero.
Só quem tem papel de Administrador ou Editor vê essa opção.
Problemas comuns
"Nenhum número disponível na conta selecionada" A conta WhatsApp Business selecionada ainda não tem nenhum número cadastrado. Na janela do Facebook, volte e escolha a opção de adicionar um número antes de concluir.
"Número já está em uso no WhatsApp" O número precisa ser desvinculado de qualquer conta WhatsApp antes de ser usado na API. A Meta tem um processo de portabilidade; consulte a central de ajuda em facebook.com/business/help.
"Mensagens não chegam ao agente" Verifique se o agente correto está vinculado à conexão. No painel, clique no ícone de lápis ao lado da conexão para trocar o agente.
A janela do Facebook não abre ou fecha sem concluir Certifique-se de que o bloqueador de pop-ups do navegador está desativado para o app.wevi.chat. Tente novamente após liberar.
Modo avançado: token permanente (System User)
Se você já tem um token de acesso permanente gerado via System User no Meta Business Manager, pode conectar sem passar pelo fluxo acima. Na tela de adicionar número, clique em Tenho um token permanente e preencha manualmente o Phone Number ID, WABA ID e Access Token.
Esse modo é indicado para integrações técnicas específicas, como conexões gerenciadas por BSPs (provedores de soluções de negócios da Meta).
Modo Coexistência (opcional)
Se quiser que esse mesmo número continue funcionando no seu WhatsApp Business App no celular ao mesmo tempo que na Wevi, você pode ativar o modo Coexistência durante a conexão. Esse modo é indicado para quem já atende clientes pelo celular e quer adicionar a Wevi sem perder essa rotina.
Saiba mais em O que é o modo Coexistência do WhatsApp.