Como conectar o WhatsApp Business API
Nível: Iniciante
Tempo de leitura: 5 min
Plano necessário: Pro ou superior
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). Conta no Meta Business Manager e plano Pro na Wevi.
Passo a passo:
- Acesse Conectores 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 →
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).