Voltar à Central de Ajuda
Diagnóstico Técnico

Catálogo de Códigos de Erro

Consulte os códigos de erro retornados pelo sistema ou pelas integrações da Meta (WhatsApp, Instagram) com as ações recomendadas de resolução.

META_AUTH_401Falha de autenticação na Meta

Causa provável: O token do aplicativo Meta expirou ou perdeu permissões.

Ação recomendada: Reconecte a integração em Configurações > Integrações > Meta.
META_WEBHOOK_SIGNATUREAssinatura do webhook Meta inválida

Causa provável: O App Secret configurado não corresponde ao aplicativo que enviou o evento.

Ação recomendada: Atualize o App Secret e execute Testar Webhook.
META_LEAD_FETCH_ERRORNão foi possível buscar os dados do lead na Meta

Causa provável: Permissão de leads_retrieval ausente ou formulário indisponível.

Ação recomendada: Reautorize a integração e confirme as permissões da Página.
WA_AUTH_401Falha de autenticação no WhatsApp

Causa provável: O access token expirou ou foi revogado.

Ação recomendada: Atualize as credenciais em Configurações > Integrações > WhatsApp.
WA_SEND_FAILEDFalha ao enviar mensagem no WhatsApp

Causa provável: A API recusou o envio: número inválido, template rejeitado ou erro temporário.

Ação recomendada: Confira o motivo no log e tente novamente ou use outro template.
WA_WINDOW_EXPIREDJanela de atendimento expirada

Causa provável: O cliente não interage há tempo suficiente para permitir mensagem livre.

Ação recomendada: Envie um template aprovado para reabrir a conversa.
EMAIL_SMTP_AUTHFalha de autenticação SMTP

Causa provável: Usuário, senha ou porta de envio incorretos; provedor pode exigir senha de aplicativo.

Ação recomendada: Revise as credenciais e execute Testar Envio.
EMAIL_IMAP_AUTHFalha de autenticação IMAP

Causa provável: Credenciais de recebimento incorretas ou IMAP desativado na conta.

Ação recomendada: Habilite o IMAP no provedor e execute Testar Recebimento.
WEBHOOK_INVALID_KEYChave de integração inválida

Causa provável: O header Authorization não corresponde à Integration Key atual.

Ação recomendada: Copie a chave atual em Integrações > Website e atualize o site.
RLS_ACCESS_DENIEDAcesso negado ao registro

Causa provável: O registro pertence a outra empresa ou seu perfil não tem permissão.

Ação recomendada: Confirme a empresa selecionada ou solicite permissão ao administrador.
DUPLICATE_CONTACTContato duplicado

Causa provável: Telefone ou e-mail já pertence a outro contato da mesma empresa.

Ação recomendada: Vincule ao contato existente ou use a mesclagem de contatos.
ASSIGNMENT_NO_OPERATORNenhum operador disponível para o lead

Causa provável: Ninguém online, fora do horário de atendimento ou equipe sem operadores ativos.

Ação recomendada: Ajuste a regra de distribuição ou o horário e defina um fallback.