Ajuda pública
Integração oficial do WhatsApp
Conectar número novo
- Entre no painel e abra Conexões.
- Escolha “Número novo ou elegível”.
- Clique em “Conectar WhatsApp oficial”.
- Na janela Meta, selecione/crie Portfólio, WABA e número.
- Conclua a verificação e volte ao painel.
- Use Testar e confirme a cobrança na Meta.
Conectar WhatsApp Business App
Escolha “WhatsApp Business App existente”. A Meta exibirá essa opção apenas para contas elegíveis. Siga a confirmação no aplicativo. Dispositivos complementares podem ser desvinculados e precisar de novo vínculo. Mantenha o aparelho principal ativo durante a sincronização inicial.
Troca de celular ou novo registro
Trocar o aparelho, registrar novamente o número ou deixar o dispositivo principal inativo pode desconectar a Coexistência. O painel receberá eventos de conta quando disponíveis. Abra Conexões e use Reconectar para repetir o fluxo oficial com o mesmo parceiro.
Desconectar Cloud API
No painel, abra Conexões e use Desconectar. Isso remove a assinatura do aplicativo e revoga a credencial local; seus ativos permanecem sob controle da sua empresa na Meta.
Desconectar Coexistência
No WhatsApp Business App, abra Configurações > Conta > Plataforma comercial e toque em Desconectar conta. Aguarde o painel receber o evento `PARTNER_REMOVED`. Se o app foi removido ou o aparelho mudou, use Reconectar no painel.
Mensagens e janela de 24 horas
Uma mensagem recebida após a integração abre a janela de atendimento da Cloud API. Dentro dela, é possível responder com texto e mídia. Fora dela, use template aprovado. Mensagens enviadas apenas pelo Business App não abrem nem estendem a janela da Cloud API.
Erros comuns
- Autorização expirada: use Reconectar.
- Forma de pagamento ausente: configure na WABA no Gerenciador do WhatsApp.
- Template pendente: aguarde a Meta ou revise conteúdo/categoria.
- Coexistência indisponível: confirme versão atual do WhatsApp Business App e elegibilidade; não há garantia para toda conta.
- ID de correlação: envie o identificador mostrado no erro ao suporte, nunca tokens ou senhas.