O que é
Quando uma mensagem não é entregue ao cliente, a OmniChat exibe um ponto de exclamação vermelho ao lado da mensagem. Isso indica que houve um erro no envio. Ao posicionar o mouse sobre o ícone, o sistema exibe o código do erro e, em muitos casos, uma sugestão de solução.
Este artigo lista os códigos de erro mais comuns, seus significados e o que fazer para resolvê-los.
Como identificar o erro
Localize a mensagem não entregue (exibida com o ícone de exclamação vermelho).
Posicione o mouse sobre o ícone de exclamação. O sistema exibirá o código do erro.
Consulte a tabela abaixo para identificar o significado e a ação recomendada.
Se o erro não estiver listado, consulte a documentação oficial da WhatsApp Business API da Meta ou entre em contato com o suporte.
Ao acionar o suporte: Informe sempre o código do erro e envie uma captura de tela da tela inteira. Isso acelera o diagnóstico e a resolução do problema.
Tabela de erros mais comuns
Código | Significado | Ação recomendada |
10 | Regra de janela de 24 horas — Facebook Messenger | Consulte o artigo sobre a Janela de 24h para entender a regra e como proceder. |
190 | Token de autenticação inválido | Revise as credenciais e permissões da integração. Consulte o suporte se necessário. |
200 | Erro de autenticação | O token de acesso pode estar expirado ou incorreto. Solicite ao suporte a geração de um novo token. |
400 | Parâmetros informados inválidos | Erro relacionado à configuração da integração da sua loja. Entre em contato com o suporte. |
403 | Mensagem não permitida | A mensagem pode ferir as políticas do WhatsApp. Tente enviá-la de outra forma ou use um arquivo diferente para testar. |
404 | Contato não existe | Verifique se o número está correto, se possui o nono dígito e se é o mesmo número cadastrado no WhatsApp do cliente. |
407 | Mensagem não entregue (destinatário inacessível) | O número pode não estar registrado no WhatsApp, o destinatário pode não ter aceitado os Termos de Serviço, ou estar usando uma versão antiga do aplicativo. Peça ao cliente para atualizar o WhatsApp para a versão mais recente. |
408 | Timeout de integração com serviço externo | Pode ser uma instabilidade temporária. Consulte a página de status da OmniChat ou acione o suporte. |
409 | Destinatário incapaz de receber a mensagem | Use outro canal para verificar se o cliente está com conexão e recebendo outras mensagens. |
410 | Mensagem com TTL expirado ou limite de retentativas excedido | Pode ser uma instabilidade temporária. Consulte a página de status da OmniChat ou acione o suporte. |
411 | Não foi possível baixar a mídia enviada pelo cliente | Solicite ao cliente que reenvie o arquivo de outra forma. |
420 | Modelo pausado por baixa qualidade | Edite o modelo de mensagem para melhorar a qualidade e aguarde a aprovação antes de reenviar. |
429 | Limite de requisições atingido | Muitas mensagens enviadas em pouco tempo. Reduza o volume, envie em lotes e aguarde antes de tentar novamente. |
470 | Regra de janela de 24 horas — WhatsApp | Consulte o artigo sobre a Janela de 24h. Utilize um template HSM aprovado para reabrir a conversa. |
500 | Erro de configuração na integração | Entre em contato com o suporte ou com o Customer Success da sua conta para verificar a integração. |
501 | Mensagem não suportada | A mensagem pode ferir as políticas do WhatsApp. Tente enviá-la de outra forma ou use um arquivo diferente para testar. |
503 | Integração não configurada | Entre em contato com o suporte ou com o Customer Success da sua conta para verificar a integração. |
505 | Alcance da conta reduzido (conta marcada como spammer) | Verifique no Gerenciador de Negócios da Meta quais comportamentos podem ter enquadrado a conta nessa categoria e siga as orientações para normalização. |
1000 | Erro desconhecido | Tente reenviar a mensagem. Se o erro persistir, entre em contato com o suporte. |
1002 | Não foi possível carregar a mídia usada na mensagem | Verifique se o arquivo é compatível com os formatos suportados pela plataforma. |
1004 | Erro relacionado a políticas de uso e restrições de engajamento | O WhatsApp pode estar limitando o envio. Aguarde antes de tentar novamente. |
1005 | Destinatário optou por não receber mensagens de marketing desta empresa | Não tente reenviar mensagens para este contato. O bloqueio foi definido pelo próprio usuário e não pode ser revertido pela empresa. |
1020 | Mensagem fora da janela de conversa | O cliente não respondeu há mais de 24h. Utilize um template HSM aprovado para reabrir a conversa. |
1031 | Conta restringida pela Meta | Acesse o Gerenciador de Negócios para verificar o status da conta e, se necessário, abra uma apelação junto à Meta. |
131000 | Número inválido ou inexistente | Valide o número do contato com código de país e DDD corretos. |
131026 | Variável do template não preenchida | Preencha todos os campos variáveis do template antes de enviar. |
131042 | Usuário não pode receber mensagens | O número pode não ter uma conta ativa no WhatsApp. Verifique e tente outro canal de contato. |
132000 | Usuário optou por não receber mensagens desta empresa | O contato bloqueou ou recusou o recebimento. O contato só poderá ser retomado se o próprio usuário iniciar uma nova conversa. |
132003 | Parâmetros do template inválidos | Verifique as variáveis do template (ex.: |
132005 | Template não aprovado | Utilize apenas templates que já foram aprovados pela Meta antes de enviar. |