Erros comuns nas integrações e como resolver
Lista rápida dos erros mais comuns no WhatsApp (Z-API), no Meta Ads, no Google Ads e no rastreamento do site, com a causa e a solução.
Atualizado em 04/11/2026
Use este artigo como um guia rápido quando uma integração parar de funcionar. Cada linha mostra o que aparece, o que costuma causar e o que fazer. Os detalhes de cada integração estão nos artigos indicados.
Antes de começar
- Tenha acesso de Administrador ao CRM: as integrações ficam em Configurações → Integrações.
- Para o Google e o Meta, comece sempre pela aba Logs de Conversão: ela mostra o motivo de cada falha.
Quem pode fazer
O Administrador do CRM confere e corrige as integrações. O gestor de tráfego ajuda com as contas do Meta e do Google.
Passo a passo para investigar
- Identifique a integração: WhatsApp, Meta Ads, Google Ads ou rastreamento do site.
- Faça o teste da própria tela (Enviar mensagem de teste no WhatsApp; Testar envio no Meta e no Google).
- Para Meta e Google, abra Logs de Conversão, filtre por Falhou e clique no ícone de olho para ler o Erro.
- Procure o erro nas tabelas abaixo e aplique a solução.
- Depois de corrigir, peça ao suporte o reenvio das vendas que falharam (Meta: até 7 dias; Google: até 90 dias).
WhatsApp (Z-API) das notificações
| Erro | Causa | Solução |
|---|---|---|
| HTTP 404 "Instância não encontrada" | Instance ID ou Instance Token errado | Copie de novo do painel da Z-API |
| HTTP 401/403 "Credenciais recusadas" | Client Token errado | Confira em Segurança da conta na Z-API |
| HTTP 400 "A Z-API recusou o envio" | Instância desconectada ou número inválido | Reconecte a instância (QR code) e confira o número |
| Teste funciona, vendedor não recebe | Integração desativada, notificação desligada no perfil ou vendedor sem WhatsApp no cadastro | Confira os três pontos |
Detalhes: Como conectar o WhatsApp (Z-API).
Google Ads
| Erro | Causa | Solução |
|---|---|---|
invalid_grant | Refresh Token expirado ou revogado. Quase sempre o app OAuth está em Testando (token vale 7 dias) ou o token foi gerado antes de publicar | Publique o app (Público-alvo → Publicar app), gere um token novo no OAuth Playground e troque na integração |
The caller does not have permission | O e-mail do token não pode enviar para a conta | Dê acesso Administrador ou Padrão ao e-mail; com MCC, preencha o Login Customer ID (MCC); confira se a ação é da mesma conta e se a Data Manager API está ativada |
redirect_uri_mismatch (ao gerar o token) | Cliente OAuth do tipo errado ou redirecionamento ausente | Crie como Aplicativo da Web, com https://developers.google.com/oauthplayground |
| "Deve conter apenas dígitos." | Customer ID ou ID da ação com hífens | Digite só os números |
| Teste OK, mas vendas falham | O teste não confere a permissão na conta | Veja The caller does not have permission |
Meta Ads
| Erro | Causa | Solução |
|---|---|---|
| "Teste falhou. Verifique as credenciais." | Access Token inválido ou revogado | Gere outro token no Gerenciador de Eventos e troque na integração |
| Vendas só em "Testar eventos" | Integração com Test Event Code | Recadastre a integração sem o código |
| Venda Falhou depois de dias | O Meta não aceita vendas com mais de 7 dias | Corrija rápido e peça o reenvio dentro do prazo |
Detalhes: Como enviar as vendas ao Meta Ads.
Vendas que não aparecem em lugar nenhum
| Situação | Causa | Solução |
|---|---|---|
| Pedido pago não aparece nos logs | Nenhuma integração ativa para o time do lead | Veja Qual integração recebe cada venda |
| Ignorado nos logs | Pedido com valor zero | Normal |
| Enviado, mas não aparece no Google Ads | Lead não veio de anúncio do Google, ou ainda não passaram 48 horas | Aguarde; confira se o lead tem origem de anúncio |
Rastreamento do site
| Sintoma | Causa | Solução |
|---|---|---|
| Leads em dobro | A mesma plataforma no painel do site e no GTM | Use um caminho só |
| Nada do Google pelo GTM | Container não publicado, sem Vinculador de conversões ou nome do evento diferente | Publique e confira o acionador |
| Pixel não aparece | Cookies não aceitos ou bloqueador de anúncios | Teste em janela anônima, aceitando os cookies |
Detalhes: Rastrear conversões do site.
Como conferir se funcionou
Depois de corrigir, faça o teste da tela de novo e acompanhe a próxima venda paga nos Logs de Conversão até ela ficar Enviado.
Dúvidas comuns
Corrigi a integração. As vendas antigas vão sozinhas? Não. Abra um chamado pedindo o reenvio das vendas que falharam, dentro dos prazos (Meta 7 dias, Google 90 dias).
O teste deu certo. Por que as vendas falham? No Google, o teste confere só as credenciais. A permissão na conta de anúncios só é verificada no primeiro envio real.
O Google Ads parou de receber vendas depois de uma semana. Por quê? É o sinal clássico do app OAuth em Testando: o Refresh Token expira em 7 dias. Publique o app, gere outro token e troque no CRM.