🧭 Introdução
Ao integrar ou utilizar os serviços da Meta, alguns códigos de erro podem ser retornados pela plataforma. Este tutorial apresenta a descrição dos principais erros e suas possíveis causas, auxiliando na compreensão das situações mais comuns encontradas durante a utilização da API Oficial do WhatsApp.
⚙️ Pré-requisitos
- Possuir uma conta utilizando a API Oficial do WhatsApp.
- Ter acesso às mensagens de retorno (erros) fornecidas pela Meta.
- Conhecer o contexto do envio das mensagens realizadas.
🔢 Códigos de erros comuns na API Oficial
Localize o código retornado pela API e consulte abaixo sua descrição para entender o motivo da ocorrência.
- Erro 131049 – Envio de Template Messenger de Marketing: Esse erro indica que a Meta limitou temporariamente o envio de uma mensagem de modelo (template) de marketing para determinado destinatário. Geralmente ocorre quando o contato já recebeu um volume elevado de mensagens de marketing em um curto período, como forma de preservar a experiência do usuário.
- Erro 131056 – Limite de Volume de Envios de Mensagens Atingido: Esse erro informa que a Meta aplicou uma restrição temporária devido ao alto volume de mensagens de marketing enviadas para um mesmo destinatário. A limitação é automática e busca evitar excesso de comunicações promocionais.
- Erro 130472 – Experimento da Meta: Esse erro ocorre quando o número de telefone ou a conta está incluído em um experimento ou teste interno realizado pela Meta. Durante esses testes, alguns recursos podem apresentar comportamentos diferentes ou restrições temporárias de envio.
- Erro 130497 – Conta Comercial Impedida de Enviar Mensagens: Esse erro indica que a conta comercial do WhatsApp Business está temporariamente impedida de enviar mensagens. Isso pode ocorrer devido ao descumprimento das Políticas da Meta, baixa qualidade da conta, limitações aplicadas pela plataforma ou outras restrições relacionadas ao uso do serviço.
- Erro 131042 – META: Esse erro indica que ocorreu uma falha temporária nos serviços da própria Meta durante o processamento da solicitação. Geralmente está relacionado a indisponibilidades momentâneas da plataforma e não necessariamente a problemas na configuração da conta.
- Erro 131026 – Número Não Registrado no WhatsApp: Esse erro ocorre quando o número de telefone informado não possui uma conta ativa no WhatsApp ou não está registrado na plataforma. Como consequência, não é possível entregar mensagens para esse destinatário.
- Erro 131000 – Erro Desconhecido: Esse código representa um erro interno não especificado pela Meta. Geralmente ocorre quando a plataforma identifica uma falha inesperada durante o processamento da solicitação, sem fornecer uma causa detalhada.
- Erro 135000 – Falha ao Enviar Mensagem: Esse erro indica que a Meta não conseguiu concluir o envio da mensagem. A causa pode estar relacionada a falhas temporárias de processamento, indisponibilidade momentânea dos serviços ou outros problemas internos da plataforma.
- Erro 131047 – Mais de 24h Sem Contato: Esse erro ocorre quando uma mensagem é enviada fora da janela de atendimento de 24 horas iniciada pela última interação do usuário. Após esse período, a Meta permite apenas o envio de mensagens utilizando modelos (templates) previamente aprovados.
- Erro 131048 – Parâmetro Ausente ou Inválido: Esse erro indica que a solicitação enviada para a API contém informações obrigatórias ausentes ou parâmetros com valores inválidos. Também pode ocorrer quando algum campo foi informado em formato incorreto.
- Erro 132001 – Modelo Não Existe: Esse erro informa que o modelo (template) especificado não foi encontrado pela Meta. Isso pode acontecer quando o template foi removido, ainda não foi aprovado, pertence a outra conta ou o nome informado está incorreto.
- Erro 131031 – Conta Restrita ou Bloqueada: Esse erro indica que a conta do WhatsApp Business possui alguma restrição ou bloqueio aplicado pela Meta. A limitação pode estar relacionada ao cumprimento das políticas da plataforma, à verificação da conta ou a medidas de segurança.
- Erro 100 – Mensagem Não Suportada: Esse erro ocorre quando a solicitação contém um tipo de mensagem ou parâmetro que não é aceito pela API do WhatsApp Business. Também pode ocorrer devido ao uso incorreto de campos ou formatos incompatíveis com a operação solicitada.
- Erro 131051 – Mensagem Não Suportada pela API:Esse erro indica que o conteúdo da mensagem não pode ser processado pela API Oficial do WhatsApp. Geralmente ocorre quando o tipo de mensagem é compatível apenas com o aplicativo WhatsApp ou utiliza recursos que ainda não são suportados pela API.
💡 Dicas e Boas Práticas
- Analise sempre o código de erro retornado antes de realizar novas tentativas de envio.
- Respeite as políticas e limites estabelecidos pela Meta para reduzir restrições na conta.
- Mantenha os modelos de mensagem aprovados e atualizados.
- Verifique se os dados enviados à API estão corretos e completos.
- Acompanhe periodicamente a documentação oficial da Meta para conhecer novos códigos e alterações de comportamento da API.
✅ Conclusão
Conhecer os principais códigos de erro da API Oficial do WhatsApp facilita a identificação das causas mais comuns de falhas durante o envio de mensagens. Com essas informações, é possível compreender melhor o comportamento da plataforma e agir de forma mais assertiva na análise de cada ocorrência.
Em caso de dúvidas, conte com nossa equipe abrindo um ticket em nossa Central do Usuário CLIQUE AQUI.