Problemas comuns na configuração da API
Erros frequentes na coexistência e como resolvê-los.
Solução de problemasAtualizado em 02 de novembro de 2026
O que você vai aprender
Os erros mais comuns ao conectar o número com coexistência e como corrigi-los.
Problemas comuns
| Erro | Causa | Solução |
|---|---|---|
| "Número não é elegível" | Menos de 7 dias de uso no app | Usar o número com conversas reais por 7+ dias; não reinstalar nem re-registrar |
| "Número registrado em conta existente" | Número ainda vinculado a outra WABA | Excluir a WABA antiga no provedor anterior e aguardar de 1 a 2 meses |
| Histórico não sincroniza | Muito histórico ou app fechado | Deixar o celular desbloqueado com o app aberto; pode levar até 6 h |
| QR Code não aparece | App desatualizado | Atualizar para 2.24.17+ e refazer o fluxo |
| Mensagens do WhatsApp Windows somem | Dispositivo companheiro não suportado | Usar WhatsApp Web ou WhatsApp para Mac |
| Não consigo desativar | Não existe opção na API | No app: Configurações > Conta > Plataforma de Negócios > Desconectar |
Outras situações
- Número aparece errado na lista de conexões (por exemplo, sem o 9º dígito): use Corrigir número.
- Templates de marketing não são entregues: confirme se a forma de pagamento foi adicionada na WABA.
Próximos passos
Se o problema continuar, entre em contato com o suporte.