GG CheckoutHelp Center
IntegraçõesWhatsApp

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.

Assistente no passo 5 de 5, Número, com os campos WhatsApp Business Account ID, Phone Number ID e Nome do chip e o botão Conectar
ErroCausaO que fazer
Token não é permanenteO token não tem expiração Nunca.Gerar o token de um usuário do sistema com expiração Nunca.
Faltam escopos no tokenO 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 WABAO 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 WABAO 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 encontradaNenhum 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álidasO 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 expiradoO token de acesso expirou.Gerar um novo token permanente do usuário do sistema.
Dados incompletosAlgum campo ficou vazio ou inválido.Revisar os campos e tentar de novo.
Falha ao conectarO 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

Parte Templates na aba API Oficial, com a lista de eventos, os botões Importar e Publicar na Meta, o editor da mensagem e o bloco Publicar na Meta
MensagemCausaO que fazer
Precisam de ajusteA 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 editadoA 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 templateO 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 publicarO 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 ggCheckoutTemplates 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 MetaO 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

Parte Chips da tela WhatsApp, com os botões Verificar status, Atualizar e Cadastrar chip e a lista de chips com as colunas Chip, Status, Sessão e Sessões
StatusO que fazer
Desconectado ou ErroAbrir o chip e usar Reiniciar. No chip de QR Code, ler o novo QR Code com o celular.
BanidoO 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.
DesativadoUsar 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.

ErroCausa
Sessão desconectadaO chip da sessão não estava conectado no envio.
Número banidoO WhatsApp bloqueou o número do chip.
Produto não vinculadoO produto não está em nenhuma sessão.
Template não configuradoNão há template ativo para o evento.
URL do arquivo expiradaO link do arquivo da mensagem não estava mais válido.
Máximo de tentativas esgotadoO envio falhou em todas as tentativas automáticas.
Telefone inválido, Número não está no WhatsApp ou Telefone não informadoO telefone do comprador impede o envio.

No painel

Ferramentas > WhatsApp, partes Chips, Templates e Falhas.

Páginas relacionadas

On this page