Principais erros da Meta

Este artigo tem como objetivo ajudar a identificar e resolver rapidamente os principais erros de envio de mensagens via WhatsApp utilizando a Octadesk. Caso deseje obter informações detalhadas e atualizadas sobre cada código de erro, consulte a documentação oficial da Meta sobre códigos de erro do WhatsApp Cloud API.

📌 Erros mais comuns

130472 – Mensagem não entregue: número em experimento

O que significa: O número do destinatário está participando de um experimento conduzido pela Meta no WhatsApp, o que pode bloquear certos tipos de mensagem durante o período do teste.

Como resolver: Não é possível contornar essa restrição enquanto o número estiver em experimento. Considere aguardar ou utilizar outros canais de contato.

131026 – A mensagem não pode ser entregue

O que significa: A mensagem não foi entregue porque o número pode não estar registrado no WhatsApp, estar usando uma versão desatualizada, não ter aceitado os Termos de Serviço, ou o usuário pode ter bloqueado sua empresa.

Como resolver: Verifique se o número está registrado e atualizado no WhatsApp. Peça ao usuário que aceite os Termos de Serviço e atualize o app, e certifique-se que sua empresa não está bloqueada pelo destinatário.

131049 – Meta bloqueou a entrega

O que significa: O WhatsApp impôs um limite de envio para este usuário, a fim de manter o ecossistema saudável e evitar spam.

Como resolver: Aguarde um tempo antes de tentar reenviar, reduza a frequência dos envios e adote boas práticas de comunicação.

131047 – Falha no envio: janela de 24h expirada

O que significa: A última mensagem enviada pelo usuário foi há mais de 24 horas. Após esse período, só é possível enviar mensagens usando templates previamente aprovados pela Meta (HSMs).

Como resolver: Para retomar o contato, envie uma mensagem utilizando um template aprovado.

131050 – Falha no envio: destinatário desativou mensagens de marketing

O que significa: O destinatário optou por não receber mais mensagens de marketing da sua empresa pelo WhatsApp.

Como resolver: Não tente reenviar mensagens de marketing para este usuário, respeitando as preferências do destinatário.

131000 – Falha de envio: erro desconhecido

O que significa: Um erro inesperado, sem causa exata identificada, ocorreu durante o envio da mensagem.

Como resolver: Tente reenviar a mensagem após alguns minutos. Caso persista, entre em contato com o suporte da Octadesk com os detalhes do erro.

131053 – Mensagem não entregue: erro de upload de mídia

O que significa: O upload do arquivo de mídia falhou, geralmente devido ao formato não suportado, tamanho excedido ou outro problema técnico.

Como resolver: Ajuste o arquivo para atender os requisitos (formato e tamanho) e tente novamente.

135000 – Falha ao enviar: erro genérico do usuário

O que significa: Algum erro está presente nos dados enviados para a API, normalmente relacionado a campos obrigatórios ausentes ou formato incorreto de informações.

Como resolver: Verifique e corrija os dados enviados de acordo com as especificações, revise a estrutura do envio e, se continuar o erro, entre em contato com o suporte informando os detalhes.

ℹ️ Outros erros

1001 – Erro de autenticação

O que significa: O token usado para autenticação não é válido ou expirou.

Como resolver: Solicite um novo token e tente novamente com credenciais válidas. Certifique-se de atualizar o token periodicamente.

131000 – Falha de envio: erro genérico (outro contexto)

O que significa: Ocorreu um erro não categorizado durante o envio da mensagem.

Como resolver: Tente reenviar, confira logs e, se continuar, entre em contato com o suporte técnico.

131041 – Remetente não autorizado

O que significa: O número de telefone usado para enviar a mensagem não está habilitado ou aprovado para uso na conta atual.

Como resolver: Verifique se o número remetente está corretamente associado à conta e aprovado para uso na API.

131042 – Destinatário não encontrado

O que significa: O número de telefone do destinatário não foi localizado no WhatsApp.

Como resolver: Confirme se o número está correto, ativo e registrado no WhatsApp.

131043 – Mensagem não aprovada

O que significa: Você tentou enviar um template de mensagem que ainda não foi aprovado pela Meta.

Como resolver: Aguarde a aprovação do template antes de tentar o envio. Só templates aprovados podem ser enviados.

131044 – Limite da conta atingido

O que significa: Você atingiu o limite global de mensagens permitido para sua conta.

Como resolver: Aguarde a renovação do limite (por tempo determinado pela Meta) ou solicite o aumento do limite se necessário, conforme elegibilidade.

131045 – Conta suspensa

O que significa: A conta do WhatsApp Business foi suspensa por violação às políticas da Meta.

Como resolver: Revise as regras da plataforma, corrija práticas inadequadas e entre em contato com o suporte para solicitar a reativação, se aplicável.

131046 – Pedido em duplicidade

O que significa: Uma solicitação duplicada foi feita para o mesmo usuário/mensagem em curto intervalo.

Como resolver: Implemente controle para evitar envios duplicados, respeitando intervalos e evitando repetição de mensagens.

131048 – Parâmetro ausente ou inválido

O que significa: Algum parâmetro obrigatório está ausente ou possui valor inválido na solicitação enviada à API.

Como resolver: Revise todos os campos obrigatórios na requisição e ajuste confome o requerido pela documentação.

131051 – Mensagem bloqueada por spam

O que significa: O conteúdo da mensagem ou o padrão de envio foi identificado pela Meta como potencial spam.

Como resolver: Revise o conteúdo da mensagem, evite mensagens repetitivas e reduza a frequência do envio para este contato.

131052 – Mensagem bloqueada por políticas comerciais

O que significa: O conteúdo enviado infringe alguma das políticas de negócios da Meta para mensagens comerciais.

Como resolver: Altere o conteúdo da mensagem para conformidade com as políticas da Meta e só envie mensagens aprovadas.

132000 – Política reforçada

O que significa: A mensagem foi bloqueada por violar diretamente alguma política ou diretriz da Meta/WhatsApp Business.

Como resolver: Revise cuidadosamente as políticas de uso e ajuste o envio para garantir conformidade.

132001 – Recurso temporariamente não disponível

O que significa: O recurso solicitado está temporariamente indisponível devido a manutenção, instabilidade ou limitação momentânea.

Como resolver: Tente novamente após alguns minutos.

133004 – Formato de mensagem inválido

O que significa: O payload (estrutura dos dados enviados) está em formato inválido; pode ser um valor incorreto para parâmetros exigidos pela API.

Como resolver: Ajuste a requisição conforme os exemplos e especificações técnicas da API na documentação.

133005 – País de destino não suportado

O que significa: O número do destinatário pertence a um país/região ainda não suportado pelo WhatsApp Cloud API.

Como resolver: Verifique se o país/região está habilitado para mensagens e, se não for suportado, aguarde futuras atualizações da API.

133006 – Template não encontrado

O que significa: O nome do template informado para envio não existe ou está incorreto.

Como resolver: Verifique o nome/código do template, garantindo que ele está corretamente cadastrado e aprovado no gerenciador de templates.

133007 – Mensagem não pode ser entregue a grupos

O que significa: Tentativa de envio para grupos do WhatsApp, o que não é suportado via API comercial.

Como resolver: Envie mensagens apenas para contatos individuais (contas pessoais); as APIs comerciais não permitem envio a grupos.

132005 - Texto hidratado do modelo longo demais

O que significa: O texto traduzido é longo demais. O texto do template expande para além do limite após substituição das variáveis

Possíveis motivos e soluções: Consulte o Gerenciador do WhatsApp para verificar se seu modelo foi traduzido. Consulte a Classificação de qualidade e status do modelo. Em seguida, teste enviar a mensagem através de outra categoria.