Como conectar o WhatsApp pela API oficial da Meta
A conexão é feita pela WhatsApp Cloud API, a via oficial da Meta. Ao fim, o número atende dentro da plataforma, com estabilidade de API, envio ativo por modelos aprovados e painel de qualidade.
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: o número escolhido vai deixar de funcionar no aplicativo do WhatsApp no celular, e o histórico que está no aparelho não vai junto.
1. Escolha o número antes de começar
Um número só pode viver em um lugar: ou no aplicativo do WhatsApp, ou na API oficial. Por isso a escolha do número vem antes de qualquer clique.
Se o número que você divulga hoje está em um celular, planeje a migração: avise a equipe, combine uma data e aceite que o histórico local fica no aparelho. Se preferir não mexer no número atual, use um número novo e faça a transição divulgando os dois por um período.
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 em que você responde livremente, sem custo por mensagem e sem modelo aprovado.
Fora dessa janela, a Meta só entrega mensagens por modelo aprovado, e essas são cobradas por mensagem. É a regra que organiza tudo o que você pode fazer com envio ativo.
Se não funcionar
O número já está em uso no aplicativo do WhatsApp
A Meta não aceita o mesmo número nos dois lugares. É preciso apagar a conta do WhatsApp naquele aparelho antes de cadastrar o número na API oficial — e isso apaga o histórico local.
Minha mensagem ativa não chega
Fora da janela de atendimento, só passam mensagens por modelo aprovado. Verifique se o modelo está aprovado e se a categoria dele corresponde ao conteúdo: marketing, utilidade ou autenticação.
A qualidade do meu número caiu
A Meta rebaixa números que recebem bloqueio e denúncia. Isso vem de envio para quem não pediu contato, não da ferramenta. Reduza o envio ativo, revise a lista e a qualidade se recupera com o tempo.
A verificação por SMS não chega
Tente a opção de verificação por ligação. Números virtuais e alguns ramais corporativos costumam falhar nas duas — nesse caso, use um número móvel comum.
Atualizado em .
Atendimento no WhatsApp com vários atendentes no mesmo número
Vários atendentes no mesmo número de WhatsApp, sem passar o celular de mão em mão. Histórico único por contato, filas por equipe e relatório de resposta.
Artigos relacionados
- Como criar times e organizar a fila de atendimentoComo dividir o atendimento em times, o que cada atendente enxerga na fila e por que aqui o atendente puxa o ticket em vez de recebê-lo automaticamente.
- Como configurar SLA e horário de funcionamentoDefina a grade de horário de cada time e prazos de primeira resposta e resolução que contam só em horário útil — sem inflar a métrica com fim de semana.