Como conectar o WhatsApp pela API oficial da Meta

Antes de começar

• Uma conta no Meta Business (Business Manager) com o negócio cadastrado.
• Um número que possa receber SMS ou ligação para verificação.
• A decisão mais importante: se o número está no aplicativo WhatsApp Business, decida se vai ligar a coexistência (o número continua no celular e o histórico recente vem junto) ou se ele vai atender só pela plataforma.

1. Escolha o número antes de começar

Se o número que você divulga está no aplicativo WhatsApp Business, marque a opção de coexistência no início da conexão. O número continua funcionando no celular, as conversas aparecem nos dois lugares e a Meta envia os contatos e o histórico recente do aparelho para a plataforma.

Sem coexistência — ou se o número está no WhatsApp comum, não no Business —, o número passa a atender só pela API oficial e o histórico local fica no aparelho. Nesse caso, avise a equipe e combine uma data para a migração.

2. Abra a tela de Conexões e escolha WhatsApp Business

No menu do painel, vá em Conexões e escolha WhatsApp Business. O fluxo abre uma janela da própria Meta, onde você entra com a sua conta e autoriza o Zuppdesk a atender pelo número.

Se a janela não abrir, verifique se o navegador não bloqueou o pop-up.

3. Cadastre e verifique o número na WABA

Dentro do fluxo da Meta você escolhe a conta de WhatsApp Business (WABA) e cadastra o número. A Meta envia um código por SMS ou ligação para confirmar que o número é seu.

Um detalhe que costuma travar aqui: uma WABA pertence a um único portfólio de negócios. Não existe "mover" uma WABA entre negócios — se o número está em outro portfólio, o caminho é migrá-lo para uma WABA nova ou compartilhar o acesso como parceiro.

4. Confirme que os eventos estão chegando

Terminado o fluxo da Meta, a conexão aparece na tela com o número e a foto de perfil. O Zuppdesk assina os eventos da WABA automaticamente — você não precisa configurar webhook nem token à mão.

Mande uma mensagem de outro celular para o número e confirme que o ticket abre na fila. É o teste que vale mais do que qualquer indicador na tela.

5. Entenda a janela de atendimento

Depois que o cliente manda uma mensagem, abre-se uma janela de 24 horas em que você responde livremente, sem precisar de modelo aprovado. Desde 1º de outubro de 2026 essas respostas são cobradas pela Meta por mensagem, com 1.000 mensagens de serviço grátis por mês em cada número.

Fora dessa janela, a Meta só entrega mensagens por modelo aprovado, também cobradas por mensagem. É a regra que organiza tudo o que você pode fazer com envio ativo.

Se não funcionar