R
Por Ryan
Publicado em 11 de fev. de 2026
Códigos de erro da WhatsApp API: lista completa com causas e soluções (2026)
A WhatsApp API está apresentando erros? Confira mais de 40 códigos de erro relacionados a autenticação, limitação de taxa, modelos, mídia e fluxos, com etapas para solucionar problemas.
Os códigos de erro da WhatsApp API são códigos numéricos que identificam e ajudam a resolver os problemas enfrentados pelos usuários ao interagir com soluções da WhatsApp API. Como a WhatsApp API é baseada na Graph API, recomenda-se que provedores de soluções ou integradores de API tratem a lógica de erros usando código e detalhes para obter informações claras sobre o problema subjacente. Com esses códigos, as empresas conseguem entender o problema ao enviar mensagens ou se conectar à WhatsApp API e solucionar a questão.
A seguir, apresentamos uma lista abrangente de códigos de erro da API do WhatsApp, organizados em categorias relevantes e acompanhados de sugestões de etapas para solução de problemas. O WhatsApp também lista um conjunto de códigos de erro técnicos para seu serviço de API na nuvem aqui.
a) Erros de autorização: erros de autenticação ocorrem quando o sistema da WhatsApp API não consegue verificar as credenciais ou permissões do usuário ou aplicativo que está fazendo as solicitações.
| Código | Descrição | Solução possível |
|
0 | AuthException A Meta não consegue autenticar o usuário do aplicativo: token expirado ou alteração no acesso aos dados podem ser os motivos . | Verifique novamente as permissões do aplicativo ou gere o token de acesso aqui ou consulte seu provedor de soluções para saber quais são as etapas. |
|
3 | Método da API Falta de permissões necessárias para fazer a chamada à API ou chamada à API configurada incorretamente | Revise a configuração da API ou gere novamente o token de acesso. Se estiver usando um provedor de soluções, entre em contato com ele. |
|
10 | Permissão negada As permissões do aplicativo são insuficientes ou não foram concedidas, ou o acesso foi removido. Número de telefone não aprovado: o número de telefone não está aprovado nem incluído na lista de números permitidos para a conta da WhatsApp API |
Verifique novamente se o token da API tem as permissões necessárias para o aplicativo aqui. Se estiver usando um provedor de soluções, consulte-o para saber quais são as etapas necessárias. Verifique se o número de telefone está registrado e aprovado corretamente na sua WhatsApp Business Account. Se o seu provedor de soluções ainda não fez isso, conclua o registro e a aprovação |
|
190 | Permissão negada O token de acesso expirou e o acesso à API foi bloqueado | Obtenha um novo token de acesso para o aplicativo em questão, garantindo que todas as permissões sejam concedidas. Seu provedor de soluções pode orientar você sobre as etapas. |
|
200-299 | Erros de permissão da API Permissão ausente ou revogada: acesso a recursos específicos da API restrito | Verifique o token da API para obter as permissões necessárias para o aplicativo aqui. Se estiver usando a solução do seu provedor de soluções, consulte-o para saber quais são as etapas necessárias. |
b) Erros de limitação de taxa: ocorrem quando seu aplicativo excede o limite de chamadas à API alocado para sua conta.
| Código | Descrição | Solução possível |
| 4 | API has too many calls O aplicativo excedeu o limite de chamadas à API | Monitore e otimize proativamente suas taxas de chamadas à API. Planeje com antecedência como lidar com os limites de taxa da API |
| 80007 | Problemas com o limite de taxa A conta da WhatsApp API atingiu o limite de taxa | Tente novamente mais tarde ou reduza o número de chamadas à API. |
| 130429 | Limite de taxa atingido O limite de volume de mensagens foi excedido. | Você precisa reduzir a frequência de envio de mensagens ou tentar novamente mais tarde |
| 131048 | Limite de taxa de spam atingido Isso pode ocorrer devido a restrições no volume de mensagens do número de telefone na conta da API. O motivo pode ser um histórico anterior de sinalizações de spam e mensagens bloqueadas pelo destinatário. | Verifique o status de qualidade no WhatsApp Manager e reduza a frequência das mensagens. |
| 131056 | Limite de taxa de mensagens para o mesmo destinatário atingido Um grande número de mensagens é enviado em pouco tempo do número de telefone do remetente para o número de telefone de um destinatário específico. | Aguarde e tente enviar mensagens novamente para o número de telefone do mesmo destinatário. O envio de mensagens para outros números de telefone não é restrito. |
| 133016 | Limite de registro/desregistro de número de telefone excedido A WhatsApp limita o número de tentativas de registro ou desregistro a 10 em um período de 72 horas | Aguarde um pouco e tente novamente depois que o período de bloqueio de 72 horas terminar. |
c) Erros de integridade: estão relacionados a uma violação das políticas da Plataforma WhatsApp que restringiu temporariamente determinadas ações da conta comercial.
| Código | Descrição | Solução possível |
| 368 | Bloqueio temporário devido a violações de políticas A WhatsApp Business Account associada está restrita ou bloqueada por violar uma política da plataforma. | Consulte as políticas da WhatsApp para entender e resolver as violações ou consulte seu provedor de soluções da WhatsApp para encontrar uma solução. |
| 130497 | Restrições de mensagens em alguns países: a WhatsApp Business Account está proibida de enviar mensagens a usuários em determinados países devido a restrições por categoria ou políticas locais | Confira aquias restrições geográficas e as políticas da WhatsApp para envio de mensagens em cada país. Consulte o suporte da WhatsApp ou seu provedor de soluções para saber mais. |
| 131031 | Conta bloqueada A WhatsApp Business Account está restrita ou totalmente desativada por violar as políticas da plataforma ou de comércio. Isso pode ocorrer devido à verificação insuficiente do conteúdo ou dos dados das mensagens. | Confira as diretrizes de integridade das mensagens ou as políticas da plataforma relacionadas à aplicação contra spam. |
d) Erros de modelo de mensagem: problemas relacionados aos modelos de mensagem estruturados predefinidos, causados por fatores como violação de políticas, conteúdo proibido, limite de taxa ou problemas de formatação.
| Código | Descrição | Solução possível |
| 132000 | Incompatibilidade na contagem de parâmetros do modelo O número de parâmetros variáveis na mensagem não corresponde às variáveis definidas no modelo aprovado | Revise a mensagem e consulte as diretrizes do modelo, garantindo que todos os parâmetros variáveis estejam definidos |
| 132001 | O modelo não existe O modelo não está aprovado ou não existe no idioma específico. | Verifique se o modelo de mensagem foi aprovado e se o nome da mensagem e a localidade do idioma estão corretos. Para mais detalhes, consulte a política de modelos de mensagem |
| 132005 | O modelo traduzido excede o limite de caracteres Modelos interativos com todos os botões, respostas rápidas e outros caracteres excedem os limites quando traduzidos. | Revise o conteúdo do modelo, simplifique-o e reduza o número de caracteres; de preferência, use conteúdo conciso. Consulte o status do modelo para ver outras ações. |
| 132007 | Violação da política de formatação de modelos Esse erro ocorre quando o conteúdo inclui caracteres não compatíveis, formatação incorreta ou outros elementos que não seguem as diretrizes do WhatsApp. | Consulte o motivo da rejeição e edite o conteúdo do modelo novamente. |
| 132012 | Incompatibilidade no formato dos parâmetros do modelo Envio de parâmetros incorretos (como uma imagem em vez de um vídeo) na mensagem do modelo, que não correspondem ao formato aprovado. | Verifique se os parâmetros do modelo correspondem ao formato aprovado. Se necessário, peça ajuda ao seu provedor de soluções do WhatsApp. |
| 132015 | Modelo pausado O modelo foi pausado devido à baixa classificação de qualidade, e a conta da API não pode enviar mensagens desse modelo aos usuários. | Edite o modelo, melhore a qualidade e tente enviá-lo novamente. |
| 132016 | Modelo desativado Se o modelo tiver sido pausado várias vezes devido à baixa qualidade, o WhatsApp o terá desativado. | Recomendamos criar um novo modelo, fazer alterações no conteúdo e garantir que ele tenha qualidade. |
e) Erro na entrega da mensagem: Isso se refere à falha na entrega da mensagem ao destinatário devido a problemas com o conteúdo, a configuração ou do lado do destinatário.
| Código | Descrição | Solução possível |
| 131026 | Não foi possível entregar a mensagem Os motivos podem incluir -O destinatário não tem um número válido do WhatsApp -O destinatário está usando uma versão antiga do aplicativo WhatsApp -O destinatário não aceitou os novos termos de serviço e a política de privacidade do WhatsApp | O destinatário precisa aceitar os T&Cs do WhatsApp para usar o serviço, registrar uma conta do WhatsApp ou atualizar a versão do aplicativo. |
| 131047 | Mensagem de reengajamento Já se passaram mais de 24 horas desde a última resposta do destinatário. | Use um modelo de mensagem iniciado pela empresa para iniciar uma nova conversa com o usuário. |
| 131049 | A Meta não entregou a mensagem A Meta optou por não entregar a mensagem para manter um engajamento saudável no ecossistema. | Isso pode ocorrer devido ao limite de mensagens de marketing por usuário (saiba mais aqui). Tente novamente após algum tempo. |
| 131051 | Tipo de mensagem não compatível Tentativa de enviar mensagens em um formato de modelo (mídia ou outro payload) não compatível com o WhatsApp. | Consulte os tipos de mensagem compatíveis na documentação do WhatsApp. |
f) Erros de mídia: Erros no processamento de arquivos de mídia
| Código | Descrição | Solução possível |
| 131052 | Erro ao baixar mídia O WhatsApp não consegue baixar a mídia incluída na mensagem do usuário do WhatsApp. | Recomendamos pedir ao usuário que envie o arquivo de mídia por um canal diferente do WhatsApp. |
| 131053 | Erro ao enviar mídia O WhatsApp não conseguiu enviar a mídia por motivos como
| Consulte a lista de formatos de arquivo de mídia compatíveis com o WhatsApp |
g) Erro do WhatsApp Flows: Problemas relacionados ao recurso WhatsApp Flows
| Código | Descrição | Solução possível |
| 100 | Uma possível causa pode ser um dos vários problemas encontrados durante o gerenciamento de fluxos
| Informe um nome válido e exclusivo, confirme o ID específico e verifique se a URL aplicada é válida. Saiba mais sobre o tratamento de erros específicos do Flows |
| 139000 | Bloqueio por integridade O WhatsApp pode ter identificado problemas de integridade na conta comercial, impedindo a criação ou publicação dos seus fluxos | Entre em contato com o suporte do WhatsApp ou com seu provedor de soluções para resolver o problema. |
| 139001 | Não é possível atualizar os fluxos Não é possível tentar atualizar os fluxos após a publicação. Essa tentativa gerará este erro. |
Clone o fluxo, atualize-o e publique-o novamente. Use o novo fluxo em vez do antigo. |
| 139002 | Publicação de fluxos com informações incompletas A publicação de fluxos com informações incompletas ou incorretas resultará neste erro. Pode haver vários motivos, como
|
Identifique os detalhes ausentes nos fluxos. Adicione as informações relevantes usando a solução adequada e tente publicar novamente. |
| 139003 | Descontinuar um fluxo O erro ocorrido ao tentar descontinuar um fluxo pode ter sido causado pelos motivos abaixo
| Consulte este guia sobre como descontinuar um fluxo |
| 139004 | Não é possível excluir um fluxo publicado Erro ao excluir um fluxo publicado, pois isso não é permitido | Depois que um fluxo é publicado, ele não pode ser excluído. Em vez disso, tente descontinuá-lo |
| 139006 | Limite mínimo de métricas do fluxo Não há dados suficientes para gerar métricas do fluxo | Aguarde até que haja dados suficientes nos fluxos para gerar métricas |
| 132068 | Fluxo bloqueado A execução dos fluxos do WhatsApp está bloqueada devido a violações de políticas ou denúncias de usuários. | Revise o fluxo e verifique se há violações de políticas ou um número excessivo de denúncias de usuários. |
| 132069 | Fluxo limitado A capacidade de um fluxo específico do WhatsApp de processar mensagens foi temporariamente limitada, pois 10 mensagens já foram enviadas em 1 hora | Monitore o desempenho e corrija o fluxo. Peça ajuda ao suporte do WhatsApp ou ao seu provedor de soluções. |
h) Outros erros diversos:
| Código | Descrição | Solução possível |
| 131000 | Algo deu errado Falha ao enviar a mensagem devido a um erro desconhecido | Tente novamente ou entre em contato com o suporte. Se necessário, fale com seu Provedor de Soluções do WhatsApp |
| 131005 | Acesso negado O WhatsApp não concedeu a permissão ou a revogou | Tente solucionar o problema usando este guia. |
| 131008 | O parâmetro obrigatório está ausente: | Consulte a referência do endpoint para saber quais parâmetros são obrigatórios. |
| 131009 | O valor do parâmetro é inválido | Informe apenas parâmetros compatíveis. Consulte este material para verificar os tipos de parâmetros compatíveis. |
| 131016 | Serviço indisponível Um serviço do WhatsApp está temporariamente indisponível | Entre em contato com seu Provedor de Soluções do WhatsApp para saber mais ou tente verificar o status da Plataforma WhatsApp Business aqui |
| 131021 | O destinatário não pode ser o remetente O remetente e o destinatário têm o mesmo número | Use números diferentes para enviar a mensagem |
| 131037 | Nome de exibição ausente Para enviar mensagens, é necessário ter um nome de exibição aprovado na API do WhatsApp. Não é possível enviar a mensagem se o nome de exibição não estiver aprovado | Tente alterar o nome de exibição e obter aprovação seguindo este guia |
| 131042 | Problema de pagamento que afeta a elegibilidade da empresa Ocorreu um erro no método de pagamento vinculado à sua conta do WhatsApp Business. Entre os possíveis motivos estão: limite de crédito excedido, ausência de conta de pagamento, pagamento ou linha de crédito não configurados etc. | Verifique os dados de cobrança e o método de pagamento no WhatsApp Manager para garantir que a cobrança esteja configurada corretamente. |
| 131045 | Certificado incorreto O envio da mensagem está falhando devido a um erro no registro do telefone comercial | Tente registrar novamente o número de telefone e, em seguida, tente outra vez |
| 131057 | Conta em modo de manutenção | Entre em contato com o suporte do WhatsApp ou com seu provedor de soluções para saber mais. |