🔁 Erros de limite de uso

Esses erros aparecem quando o volume de mensagens ou chamadas à API fica muito alto de uma só vez. Eles são comuns em envios em massa ou quando muitos atendimentos são abertos simultaneamente.

Quando isso acontecer, não se preocupe: normalmente o sistema só está “pedindo um respiro”. Basta aguardar alguns minutos e tentar novamente.

Código: 4

Descrição: O sistema atingiu o limite de chamadas da API.
Possível causa: Muitas solicitações foram feitas em um curto período.
Possível solução: Aguarde alguns minutos e diminua a frequência de envios. Organizar os disparos por lotes pode ajudar a evitar o mesmo erro no futuro.

Código: 80007

Descrição: A conta atingiu o limite de volume de mensagens.
Possível causa: Envio intenso de mensagens em pouco tempo.

Possível solução: Espere um pouco antes de tentar novamente ou reduza o número de mensagens enviadas de uma vez. Planejar os envios em lotes menores ajuda a manter tudo fluindo. Além disso, consulte o limite de envio da sua conta no Gerenciador do WhatsApp — lá você vê o nível atual e consegue entender até onde pode enviar sem esbarrar nesses bloqueios.

Código: 130429

Descrição: O limite de transferência de dados da API foi atingido.
Possível causa: Alto volume de envios em um intervalo curto.
Possível solução: Pausa rápida: aguarde e retome os envios com mais intervalo entre as mensagens.

Código: 131048

Descrição: O número atingiu o limite de mensagens devido a possíveis bloqueios ou marcações como spam.
Possível causa: Muitas mensagens foram entendidas como indesejadas pelos destinatários.

Possível solução: Revise o conteúdo das mensagens e reduza a frequência de envio. Mensagens mais personalizadas e relevantes têm mais chance de engajar e menos risco de serem marcadas como spam. Além disso, verifique o status de qualidade da sua conta no Gerenciador do WhatsApp — ele mostra se o número está com alertas ou restrições e ajuda a entender o que está impactando seus envios.

Código: 131056

Descrição: Foram enviadas várias mensagens seguidas para o mesmo número.
Possível causa: O sistema identificou excesso de contato com o mesmo usuário.
Possível solução: Dê um intervalo antes de falar novamente com o mesmo contato. Isso também melhora a experiência de quem está do outro lado.

🚫 Erros de política ou bloqueio

Esses erros aparecem quando o WhatsApp identifica algum descumprimento das políticas da plataforma ou quando há um bloqueio ativo na conta. Eles podem acontecer por conteúdo sensível, envio inadequado de mensagens ou configurações incorretas.

Se isso acontecer com você, não significa “fim de jogo” — é só um alerta para ajustar o uso e voltar para o loop com envio seguro e dentro das regras 😉

Código: 368

Descrição: Sua conta do WhatsApp foi bloqueada temporariamente.

Possível causa: A conta violou alguma regra das políticas do WhatsApp (por exemplo, tipo de conteúdo enviado, forma de contato com usuários ou frequência de mensagens).

Possível solução: Revise as políticas do WhatsApp e ajuste o envio de mensagens para evitar novos bloqueios. Mensagens mais claras, relevantes e enviadas apenas para quem consentiu reduzem bastante o risco desse tipo de restrição.

Código: 131031

Descrição: Sua conta do WhatsApp foi bloqueada.

Possível causa: Violação de políticas ou informações incorretas associadas à conta (como PIN errado ou tentativas repetidas de ativação).

Possível solução: Consulte a API de Status de Integridade para entender melhor o motivo do bloqueio. Ela ajuda a identificar o que aconteceu e qual é o próximo passo para regularizar sua conta e voltar a enviar mensagens com segurança.

Código: 130497

Descrição: Sua conta não pode enviar mensagens para números de determinados países.

Possível causa: Alguns países têm restrições ou incompatibilidade com o envio de mensagens para determinadas categorias de empresas.

Possível solução: Confira em quais países sua conta está autorizada a enviar mensagens. Assim, você ajusta sua estratégia e garante que o envio acontece apenas para regiões liberadas — menos atrito, mais conversas certas nos lugares certos.

📝 Erros de mensagem e conteúdo

Esses erros acontecem quando há algum problema com o tipo de mensagem enviada, com o template usado ou com o momento do envio. Em geral, não é erro técnico do sistema — é só ajuste de formato ou regra do WhatsApp.

A boa notícia: com pequenas correções, você volta para o loop de conversas rapidinho!

Código: 132000

Descrição: O modelo de mensagem (template) não corresponde às informações enviadas.

Possível causa: Faltam variáveis obrigatórias no template, foram enviadas em formato incorreto ou o modelo ainda não foi aprovado pela Meta.

Possível solução: Verifique se o template foi criado e aprovado no WhatsApp Business Manager e se todas as variáveis foram preenchidas corretamente. Ajustar esses pontos costuma resolver o envio na hora.

Código: 131047

Descrição: O cliente não respondeu há mais de 24 horas.

Possível causa: O WhatsApp só permite mensagens “livres” dentro das primeiras 24 horas após a última resposta do cliente. Depois desse período, a conversa precisa seguir regras específicas.

Possível solução: Use um template de mensagem aprovado para retomar o contato. Ele é o formato autorizado pelo WhatsApp para reabrir a conversa após a janela de 24h — sem risco de bloqueios ou penalidades.

Código: 131049

Descrição: O WhatsApp optou por não entregar a mensagem ao destinatário.

Possível causa: envio em massa, mensagens repetitivas ou baixa qualidade percebida no conteúdo enviado.

Possível solução: Aguarde um tempo antes de reenviar e evite mensagens automáticas repetitivas. Mensagens mais personalizadas e relevantes tendem a ter melhor entrega e engajamento — e mantêm você no loop certo com seus clientes.

Código: 131026

Descrição: A mensagem não pôde ser entregue ao destinatário.

Possível causa: O número não possui WhatsApp ativo, o cliente não aceitou os novos termos de uso ou está utilizando uma versão desatualizada do aplicativo.
Como resolver: Tente contato por outro canal (e-mail, SMS, telefone) e oriente o cliente a atualizar o aplicativo do WhatsApp e aceitar os termos de uso.

⚠️ Erros gerais

Esses erros não estão, necessariamente, relacionados ao conteúdo da mensagem ou à política — muitas vezes são situações temporárias da plataforma, instabilidades ou configurações específicas da conta. Na maior parte dos casos, é só uma pausa rápida e tudo volta ao fluxo normal.

Código: 2 ou 503

Descrição: O WhatsApp está com instabilidade momentânea.

Possível causa: Manutenção da plataforma ou alto volume de uso.

Possível solução: Aguarde alguns minutos e tente novamente mais tarde. Em geral, esse erro se resolve sozinho.

Código: 130472

Descrição: Não foi possível enviar a mensagem para este contato.

Possível causa: O usuário faz parte de um teste controlado pelo WhatsApp.

Possível solução: Durante o período do experimento, não é possível enviar mensagens para esse usuário. Depois que o teste terminar, o envio volta ao normal.

Código: 131000

Descrição: O WhatsApp encontrou um erro inesperado.

Possível causa: Falha temporária na plataforma.

Possível solução: Espere alguns minutos e tente reenviar a mensagem. Se o erro persistir, vale tentar novamente mais tarde.

Código: 131016

Descrição: O WhatsApp está indisponível no momento.

Possível causa: O serviço do WhatsApp da Meta está temporariamente fora do ar.

Possível solução: Antes de tentar de novo, consulte a página de Status da WhatsApp Business API para verificar se há incidentes ativos. Assim você evita tentativas repetidas desnecessárias.

Código: 131037

Descrição: O nome de exibição do seu número de WhatsApp ainda não foi aprovado.

Possível causa: O nome de exibição foi rejeitado ou está em análise.

Possível solução: Ajuste o nome conforme as diretrizes ou aguarde a aprovação antes de enviar mensagens. Se precisar, siga o passo a passo do artigo sobre como alterar o nome de exibição no WhatsApp Business.

Código: 131042

Descrição: Há um problema com a forma de pagamento da sua conta.

Possível causa: Falta de método de pagamento, limite de crédito estourado ou conta suspensa.

Possível solução: Verifique a configuração de cobrança da sua conta do WhatsApp Business e regularize o pagamento para liberar o envio de mensagens.

Código: 131045

Descrição: Ocorreu uma falha ao enviar a mensagem devido a um erro de registro do número de telefone.

Possível causa: O número não foi registrado corretamente na plataforma.

Possível solução: Finalize o registro do número de telefone e tente novamente o envio depois.

Código: 131053

Descrição: Não foi possível carregar a mídia usada na mensagem.

Possível causa: Arquivo em formato não compatível com o WhatsApp.

Possível solução: Utilize um formato aceito (como JPG, PNG, PDF, MP4, entre outros compatíveis) e tente novamente.

Código: 132001

Descrição: O modelo de mensagem não existe ou ainda não foi aprovado.

Possível causa: Nome incorreto do modelo ou idioma não configurado/aprovado.

Possível solução: Confirme se o modelo está criado, aprovado e no idioma correto. Siga as diretrizes de modelos de mensagem antes de enviar.

Código: 132005

Descrição: O texto final do modelo ultrapassou o limite permitido.

Possível causa: Traduções ou adaptações deixaram o conteúdo maior do que o aprovado.

Possível solução: Edite o modelo e reduza o texto antes de tentar novamente. Depois disso, reenvie para aprovação.

Código: 132007

Descrição: O conteúdo do modelo não segue as regras do WhatsApp.

Possível causa: Uso de termos proibidos ou conteúdo que viola políticas.

Possível solução: Revise as razões de rejeição e ajuste o texto conforme as políticas da plataforma para evitar bloqueios futuros.

Código: 132012

Descrição: Algum campo do modelo foi preenchido de forma incorreta.

Possível causa: Formato diferente do esperado (por exemplo, data, número ou código).

Possível solução: Revise os parâmetros enviados e ajuste para o formato correto, seguindo as diretrizes de modelos.

Código: 132015

Descrição: O modelo foi pausado por baixa qualidade.

Possível causa: Muitos usuários classificaram o modelo como ruim.

Possível solução: Melhore o texto, torne-o mais claro e relevante, e envie para aprovação novamente antes de voltar a usá-lo.

Código: 132016

Descrição: O modelo foi desativado permanentemente por baixa qualidade.

Possível causa: Rejeições repetidas ou avaliações negativas.

Possível solução: Crie um novo modelo com abordagem diferente e mais alinhada às políticas e boas práticas.

Código: 133004

Descrição: O servidor do WhatsApp está temporariamente indisponível.

Possível causa: Instabilidade na plataforma.

Possível solução: Aguarde alguns minutos e tente novamente mais tarde — normalmente esse erro é resolvido automaticamente.

Não achou o seu erro aqui? Fique tranquilo 😊
Fale com o nosso time de atendimento e nós ajudamos você a identificar o problema e voltar para o loop de conversas.