Falha de autenticação na Meta
META_AUTH_401
- Possível causa:
- O token do aplicativo Meta expirou ou perdeu permissões.
- O que fazer:
- Reconecte a integração em Configurações > Integrações > Meta.
Central de Ajuda
Códigos de erro internos
Todo erro relevante do CRM exibe o que aconteceu, a possível causa, o que fazer e o código técnico abaixo.
Assinatura do webhook Meta inválida
META_WEBHOOK_SIGNATURE
- Possível causa:
- O App Secret configurado não corresponde ao aplicativo que enviou o evento.
- O que fazer:
- Atualize o App Secret e execute Testar Webhook.
Não foi possível buscar os dados do lead na Meta
META_LEAD_FETCH_ERROR
- Possível causa:
- Permissão de leads_retrieval ausente ou formulário indisponível.
- O que fazer:
- Reautorize a integração e confirme as permissões da Página.
Falha de autenticação no WhatsApp
WA_AUTH_401
- Possível causa:
- O access token expirou ou foi revogado.
- O que fazer:
- Atualize as credenciais em Configurações > Integrações > WhatsApp.
Falha ao enviar mensagem no WhatsApp
WA_SEND_FAILED
- Possível causa:
- A API recusou o envio: número inválido, template rejeitado ou erro temporário.
- O que fazer:
- Confira o motivo no log e tente novamente ou use outro template.
Janela de atendimento expirada
WA_WINDOW_EXPIRED
- Possível causa:
- O cliente não interage há tempo suficiente para permitir mensagem livre.
- O que fazer:
- Envie um template aprovado para reabrir a conversa.
Falha de autenticação SMTP
EMAIL_SMTP_AUTH
- Possível causa:
- Usuário, senha ou porta de envio incorretos; provedor pode exigir senha de aplicativo.
- O que fazer:
- Revise as credenciais e execute Testar Envio.
Falha de autenticação IMAP
EMAIL_IMAP_AUTH
- Possível causa:
- Credenciais de recebimento incorretas ou IMAP desativado na conta.
- O que fazer:
- Habilite o IMAP no provedor e execute Testar Recebimento.
Chave de integração inválida
WEBHOOK_INVALID_KEY
- Possível causa:
- O header Authorization não corresponde à Integration Key atual.
- O que fazer:
- Copie a chave atual em Integrações > Website e atualize o site.
Acesso negado ao registro
RLS_ACCESS_DENIED
- Possível causa:
- O registro pertence a outra empresa ou seu perfil não tem permissão.
- O que fazer:
- Confirme a empresa selecionada ou solicite permissão ao administrador.
Contato duplicado
DUPLICATE_CONTACT
- Possível causa:
- Telefone ou e-mail já pertence a outro contato da mesma empresa.
- O que fazer:
- Vincule ao contato existente ou use a mesclagem de contatos.
Nenhum operador disponível para o lead
ASSIGNMENT_NO_OPERATOR
- Possível causa:
- Ninguém online, fora do horário de atendimento ou equipe sem operadores ativos.
- O que fazer:
- Ajuste a regra de distribuição ou o horário e defina um fallback.