Problemas comuns
Os erros da conexão pela API Oficial, da publicação de templates na Meta e as falhas de entrega do WhatsApp, com a causa e o que fazer em cada um.
Esta página reúne as mensagens de erro que o painel mostra na integração com o WhatsApp, com a causa indicada pelo próprio painel ou pela Meta. Os erros aparecem em três momentos: na conexão de um número pela API Oficial, na publicação de templates na Meta e no envio das mensagens, registrado na parte Falhas.
Conexão pela API Oficial
Os erros abaixo aparecem no passo 5 do assistente Conectar API Oficial (Meta), depois de Conectar.
| Erro | Causa | O que fazer |
|---|---|---|
| Token não é permanente | O token não tem expiração Nunca. | Gerar o token de um usuário do sistema com expiração Nunca. |
| Faltam escopos no token | O token não tem as permissões whatsapp_business_management e whatsapp_business_messaging. | Gerar o token de novo, com as duas permissões marcadas. |
| Número não pertence ao WABA | O Phone Number ID não pertence ao WABA ID informado. | Conferir os dois IDs em WhatsApp > Configuração da API, no app da Meta. |
| Falha ao inscrever o app no WABA | O app não conseguiu se inscrever na conta do WhatsApp Business. | Conferir as permissões do usuário do sistema e tentar de novo. |
| Nenhuma conta encontrada | Nenhum número foi detectado com o token. | Gerar o token com whatsapp_business_management, whatsapp_business_messaging e business_management e confirmar que a conta do WhatsApp está atribuída ao usuário do sistema. |
| Credenciais inválidas | O token e o App Secret não são do mesmo app, ou o token foi colado incompleto. | Conferir se os dois são do mesmo app no Meta for Developers e colar o token inteiro. |
| Token expirado | O token de acesso expirou. | Gerar um novo token permanente do usuário do sistema. |
| Dados incompletos | Algum campo ficou vazio ou inválido. | Revisar os campos e tentar de novo. |
| Falha ao conectar | O painel não conseguiu validar as credenciais com a Meta. | Tentar de novo. |
Os passos para gerar o token estão em Conectar pela API Oficial.
Publicação de templates na Meta
| Mensagem | Causa | O que fazer |
|---|---|---|
| Precisam de ajuste | A mensagem começa ou termina com uma variável, o que a Meta não aceita. | Clicar em Corrigir ou em Corrigir todos, ou editar a mensagem. |
| Template em análise que não pode ser editado | A Meta ainda está analisando o template. | Esperar a resposta da Meta, ou apagar o template no Gerenciador do WhatsApp e publicar de novo. |
| A Meta não permite editar o template | O estado atual do template na Meta não aceita edição. | Apagar o template no Gerenciador do WhatsApp e publicar de novo. |
| Edição depois de publicar | O template foi editado depois da publicação, e a Meta continua enviando a versão aprovada. | Clicar em Republicar. A nova versão passa por outra aprovação. |
| Aviso do tipo 6 de 6 não deram certo. Tente de novo. | A publicação em lote falhou nos templates indicados. | Publicar de novo. |
| Templates criados fora do ggCheckout | Templates criados direto no Gerenciador do WhatsApp, sem o prefixo ggc_ no nome, não são importados. | Publicar o template pelo ggCheckout. |
| Templates que não existem mais na Meta | O template foi apagado na Meta e aparece como Desativado. | Publicar de novo para recriar. |
O aviso de aprovação do painel informa que contas novas ou não verificadas podem ficar em análise e que, nesse estado, os templates não são aprovados e as mensagens não são entregues. Um template Rejeitado pode ser editado e enviado de novo para análise, ou contestado no Gerenciador do WhatsApp, conforme a página Análise de modelos, da Meta.
Status do chip
| Status | O que fazer |
|---|---|
| Desconectado ou Erro | Abrir o chip e usar Reiniciar. No chip de QR Code, ler o novo QR Code com o celular. |
| Banido | O WhatsApp bloqueou o número. Pela documentação da Meta, um número banido só volta a ser registrado depois de liberado pelo processo de recurso do WhatsApp. |
| Desativado | Usar Reativar para colocar o chip em uso de novo. |
Falhas de entrega
A parte Falhas lista as mensagens que não chegaram ao comprador, com o erro, a severidade, o cliente, o produto, a data e a origem. Os filtros separam Ativas, Resolvidas e Dispensadas, por tipo de erro, severidade e período. Cada falha pode ser reenviada com Retentar ou descartada com Dispensar.
| Erro | Causa |
|---|---|
| Sessão desconectada | O chip da sessão não estava conectado no envio. |
| Número banido | O WhatsApp bloqueou o número do chip. |
| Produto não vinculado | O produto não está em nenhuma sessão. |
| Template não configurado | Não há template ativo para o evento. |
| URL do arquivo expirada | O link do arquivo da mensagem não estava mais válido. |
| Máximo de tentativas esgotado | O envio falhou em todas as tentativas automáticas. |
| Telefone inválido, Número não está no WhatsApp ou Telefone não informado | O telefone do comprador impede o envio. |
No painel
Ferramentas > WhatsApp, partes Chips, Templates e Falhas.
Páginas relacionadas
- Conectar pela API Oficial: o assistente de conexão e a publicação dos templates.
- Sessões: os chips e os produtos de cada sessão.
- Templates: os eventos e as opções de envio.