Códigos de erro do WhatsApp Business API

85 erros listados

• 0 Autenticação
  Corrigir e reenviar

  Falha ao autenticar o app

  O token de acesso expirou, foi invalidado, ou o usuário revogou o acesso do aplicativo.

  O que fazer: Gere um novo token de acesso (System User Token) no Meta Business e atualize a conexão.

• 3 Autenticação
  Corrigir e reenviar

  Problema de capacidade ou permissão

  O app não tem a capacidade ou a permissão exigida pelo endpoint chamado.

  O que fazer: Confira as permissões do token no Access Token Debugger da Meta e reautorize o que faltar.

• 10 Autenticação
  Corrigir e reenviar

  Permissão não concedida ou removida

  A permissão necessária nunca foi concedida ou foi revogada depois. Também aparece quando a conta não é elegível para o endpoint.

  O que fazer: Reautorize o app e valide o token no debugger. Em Flows com endpoint, confirme que o número usado para definir a chave pública está liberado.

• 190 Autenticação
  Corrigir e reenviar

  Token de acesso expirado

  O token de acesso usado na requisição não é mais válido.

  O que fazer: Gere um novo token de acesso e substitua o antigo na integração.

• 200 Autenticação
  Corrigir e reenviar

  Nenhum token enviado

  A requisição chegou sem token. Acontece em certos endpoints GET (como whatsapp_business_profile) e retorna a mensagem "Provide valid app ID".

  O que fazer: Inclua um token válido no cabeçalho. Não confunda com o 190, que indica token existente porém expirado.

• 200–299 Autenticação
  Corrigir e reenviar

  Permissão ausente ou revogada

  Faixa de erros de permissão do Graph API: o escopo exigido pelo endpoint não está concedido.

  O que fazer: Verifique no Access Token Debugger quais permissões o app recebeu e reautorize os escopos que faltarem.

• 368 Políticas
  Acionar suporte

  Conta restrita por violação de política

  A conta comercial (WABA) associada ao app foi restrita ou desativada por violar uma política da plataforma.

  O que fazer: Consulte o Policy Enforcement no Business Manager para ver a violação e o caminho de recurso.

• 130497 Políticas
  Não retentar

  Envio bloqueado para certos países

  A conta comercial está impedida de enviar mensagens para usuários em determinados países, conforme a categoria do negócio.

  O que fazer: Confira a Política de Mensagens do WhatsApp Business para saber quais países são permitidos na sua categoria.

• 131031 Políticas
  Acionar suporte

  Conta bloqueada

  A conta foi restrita por violação de política, ou algum dado da requisição não bate com o que está na conta (por exemplo, o PIN de duas etapas).

  O que fazer: Use a Health Status API para entender o motivo do bloqueio e verifique o Policy Enforcement.

• 130403 Políticas
  Não retentar

  Usuário bloqueado pela empresa

  A mensagem não foi entregue porque a própria empresa bloqueou esse usuário no WhatsApp.

  O que fazer: Não retente. Desbloqueie o contato para voltar a enviar mensagens para ele.

• 131050 Políticas
  Não retentar

  Usuário optou por não receber marketing

  O destinatário pediu para parar de receber mensagens de marketing da sua empresa no WhatsApp.

  O que fazer: Não retente — a mensagem não será entregue. Assine o webhook user_preferences para saber quando alguém sai ou volta a aceitar.

• 4 Limites
  Aguardar e retentar

  Limite de chamadas do app atingido

  O aplicativo estourou o limite de chamadas por hora do Graph API.

  O que fazer: Veja a seção Application Rate Limit no App Dashboard. Reduza a frequência das chamadas e adicione cache.

• 80007 Limites
  Aguardar e retentar

  Limite da conta comercial atingido

  A conta comercial (WABA) atingiu o próprio rate limit.

  O que fazer: Aguarde a janela virar e reduza a frequência ou o volume de chamadas.

• 130429 Limites
  Aguardar e retentar

  Throughput da Cloud API atingido

  A capacidade de envio por segundo da Cloud API foi saturada.

  O que fazer: Aplique backoff exponencial e espace os disparos. Contas com volume alto podem solicitar upgrade de throughput.

• 131048 Limites
  Aguardar e retentar

  Restrição por qualidade e spam

  Há restrição de quantas mensagens esse número pode enviar, geralmente porque muitas mensagens anteriores foram bloqueadas ou marcadas como spam.

  O que fazer: Verifique o quality status no WhatsApp Manager, revise o conteúdo dos templates e reduza o volume até a qualidade se recuperar.

• 131056 Limites
  Aguardar e retentar

  Limite entre o mesmo par de números

  Muitas mensagens do mesmo número remetente para o mesmo destinatário em um intervalo curto.

  O que fazer: Aguarde antes de reenviar para esse contato. Envios para outros números seguem normalmente.

• 131064 Limites
  Aguardar e retentar

  Limite por classificação de template

  A conta atingiu o limite de mensagens por violações de classificação de template. Vale tanto para templates quanto para mensagens diretas.

  O que fazer: Revise as categorias dos seus templates e corrija as classificações. A restrição sai sozinha ao fim do período de enforcement.

• 133016 Limites
  Aguardar e retentar

  Tentativas demais de registro

  O registro ou desregistro falhou porque houve tentativas demais para esse número em pouco tempo.

  O que fazer: Aguarde o desbloqueio do número antes de tentar de novo.

• 132000 Templates
  Corrigir e reenviar

  Número de variáveis não confere

  A quantidade de parâmetros enviados na requisição é diferente da quantidade definida no template aprovado.

  O que fazer: Compare o corpo do template aprovado com o payload e envie exatamente o número de variáveis esperado.

• 132001 Templates
  Corrigir e reenviar

  Template não existe ou não aprovado

  O template não existe no idioma informado, ou ainda não foi aprovado.

  O que fazer: Confirme o nome exato e o locale do idioma, e verifique se o status está aprovado no WhatsApp Manager.

• 132005 Templates
  Corrigir e reenviar

  Texto traduzido longo demais

  Depois de substituir as variáveis, a mensagem final ultrapassou o limite de caracteres.

  O que fazer: Encurte o conteúdo das variáveis ou reescreva o template com menos texto fixo.

• 132007 Templates
  Corrigir e reenviar

  Conteúdo viola política

  O conteúdo do template infringe uma política do WhatsApp.

  O que fazer: Leia os motivos de rejeição no WhatsApp Manager e reescreva o template dentro das diretrizes.

• 132012 Templates
  Corrigir e reenviar

  Variáveis mal formatadas

  Os valores enviados nas variáveis não seguem o formato definido no template.

  O que fazer: Ajuste tipo, ordem e formatação dos parâmetros para bater com o template aprovado.

• 132015 Templates
  Corrigir e reenviar

  Template pausado

  O template foi pausado por baixa qualidade e não pode ser enviado nesse estado.

  O que fazer: Edite o template para melhorar a qualidade e aguarde a nova aprovação.

• 132016 Templates
  Corrigir e reenviar

  Template desativado permanentemente

  O template foi pausado vezes demais por baixa qualidade e acabou desativado de vez.

  O que fazer: Não há recuperação: crie um template novo, com conteúdo diferente.

• 132018 Templates
  Corrigir e reenviar

  Erro de validação do template

  Há um problema nos parâmetros do template usado no envio.

  O que fazer: Leia o detalhe do erro, corrija os parâmetros e reenvie com o template configurado corretamente.

• 2388019 Templates
  Corrigir e reenviar

  Limite de templates excedido

  A conta comercial chegou ao teto de templates permitidos (até 250 por WABA).

  O que fazer: Apague templates obsoletos antes de criar novos.

• 2388039 Templates
  Aguardar e retentar

  Status do template não pode mudar

  Tentativa de editar um template cujo status não permite alteração — normalmente um template ainda em revisão.

  O que fazer: Espere a aprovação ou a rejeição antes de editar. Lembre que há limite diário de edições.

• 2388040 Templates
  Corrigir e reenviar

  Limite de caracteres excedido

  Algum campo do template passou do máximo de caracteres permitido.

  O que fazer: A mensagem de erro indica o campo afetado e o limite. Encurte o conteúdo desse campo.

• 2388047 Templates
  Corrigir e reenviar

  Formato do cabeçalho incorreto

  O header do template contém formatação inválida.

  O que fazer: Siga a formatação aceita para cabeçalhos indicada na mensagem de erro.

• 2388072 Templates
  Corrigir e reenviar

  Formato do corpo incorreto

  O body do template contém formatação inválida.

  O que fazer: Revise a formatação do corpo conforme o detalhe retornado no erro.

• 2388073 Templates
  Corrigir e reenviar

  Formato do rodapé incorreto

  O footer do template contém formatação inválida.

  O que fazer: Revise a formatação do rodapé conforme o detalhe retornado no erro.

• 2388293 Templates
  Corrigir e reenviar

  Proporção de variáveis excede o limite

  O template tem variáveis demais para o tamanho do texto.

  O que fazer: Reduza a quantidade de variáveis ou aumente o texto fixo da mensagem.

• 2388299 Templates
  Corrigir e reenviar

  Variável no início ou no fim

  O template começa ou termina com uma variável, o que não é permitido.

  O que fazer: Envolva as variáveis com texto fixo no começo e no fim do template.

• 130472 Mensagens
  Não retentar

  Fora do experimento de marketing

  A mensagem não foi enviada porque o usuário faz parte de um grupo de controle de experimento da Meta.

  O que fazer: Comportamento esperado do experimento de mensagens de marketing. Use outro canal para falar com esse contato.

• 131000 Mensagens
  Aguardar e retentar

  Erro desconhecido no envio

  Falha genérica de entrega, sem causa específica retornada.

  O que fazer: Retente depois de alguns minutos. Se persistir, abra um ticket no Direct Support com o fbtrace_id.

• 131005 Mensagens
  Corrigir e reenviar

  Acesso negado

  A permissão exigida não foi concedida ou foi removida.

  O que fazer: Valide o token no Access Token Debugger e reautorize as permissões do endpoint.

• 131008 Mensagens
  Corrigir e reenviar

  Parâmetro obrigatório ausente

  A requisição não trouxe um campo obrigatório.

  O que fazer: Compare o payload com a referência do endpoint e inclua os campos que faltam.

• 131009 Mensagens
  Corrigir e reenviar

  Valor de parâmetro inválido

  Um ou mais valores enviados não são aceitos pelo endpoint.

  O que fazer: Confira os valores suportados na referência. Em número de telefone, valide o formato internacional.

• 131016 Mensagens
  Aguardar e retentar

  Serviço temporariamente indisponível

  Um serviço da plataforma está fora do ar no momento.

  O que fazer: Consulte a página de status da WhatsApp Business Platform e retente depois.

• 131021 Mensagens
  Corrigir e reenviar

  Remetente igual ao destinatário

  O número de origem e o de destino são o mesmo.

  O que fazer: Corrija o destinatário para um número diferente do remetente.

• 131026 Mensagens
  Não retentar

  Mensagem não entregável

  O número não tem WhatsApp, o usuário não aceitou os Termos e a Política mais recentes, ou usa uma versão antiga do aplicativo.

  O que fazer: Confirme o número por outro canal e peça que o contato atualize o app e aceite os termos atuais.

• 131047 Mensagens
  Corrigir e reenviar

  Janela de 24 horas expirada

  Passaram-se mais de 24 horas desde a última resposta do cliente, então mensagens livres não são mais permitidas.

  O que fazer: Use um template aprovado para reabrir a conversa. É o erro mais comum em operações de atendimento.

• 131049 Mensagens
  Aguardar e retentar

  Entrega barrada pela Meta

  A mensagem não foi entregue para preservar a saúde do ecossistema — normalmente o limite de templates de marketing por usuário.

  O que fazer: Aguarde pelo menos 24 horas antes de reenviar. Insistir só gera o mesmo erro.

• 131051 Mensagens
  Corrigir e reenviar

  Tipo de mensagem não suportado

  O tipo de mensagem enviado não é aceito pela API.

  O que fazer: Consulte os tipos suportados e reenvie em um formato válido.

• 131063 Mensagens
  Corrigir e reenviar

  Marketing desabilitado na Cloud API

  O template é de marketing, mas a conta está com mensagens de marketing desativadas na configuração da Cloud API.

  O que fazer: Reative o envio de marketing na Cloud API, ou envie pela Marketing Messages API.

• 134011 Mensagens
  Corrigir e reenviar

  Termos de pagamentos pendentes

  O envio falhou porque falta aceitar os termos do WhatsApp Payments na conta comercial.

  O que fazer: Aceite os termos pelo link informado na própria mensagem de erro e reenvie.

• 135000 Mensagens
  Corrigir e reenviar

  Erro genérico de parâmetros

  Erro desconhecido relacionado aos parâmetros da requisição.

  O que fazer: Revise a sintaxe da chamada contra a referência do endpoint. Se continuar, acione o suporte da Meta.

• 131052 Mídia
  Não retentar

  Falha ao baixar a mídia

  Não foi possível baixar a mídia enviada pelo cliente.

  O que fazer: Veja o detalhe no webhook de messages e peça o arquivo por outro caminho.

• 131053 Mídia
  Corrigir e reenviar

  Falha ao enviar a mídia

  A mídia da mensagem não pôde ser carregada — frequentemente por tipo de arquivo não suportado.

  O que fazer: Confirme o MIME type e o tamanho do arquivo contra a lista de mídias suportadas antes de reenviar.

• 33 Conta e número
  Corrigir e reenviar

  Número comercial excluído

  O número usado na requisição foi apagado da conta.

  O que fazer: Verifique se o phone number ID está correto e se o número segue ativo na conta comercial.

• 131037 Conta e número
  Corrigir e reenviar

  Nome de exibição não aprovado

  O número usado não tem display name aprovado.

  O que fazer: Ajuste o nome de exibição no WhatsApp Manager e aguarde a aprovação da Meta.

• 131042 Conta e número
  Corrigir e reenviar

  Problema de faturamento

  Erro no método de pagamento. Causas comuns: conta de pagamento não vinculada, linha de crédito estourada ou inativa, fuso ou moeda não definidos, conta suspensa.

  O que fazer: Revise a configuração de cobrança da conta comercial no WhatsApp Manager.

• 131045 Conta e número
  Corrigir e reenviar

  Erro de registro do número

  O envio falhou por um problema no registro do número — inclusive certificado inválido.

  O que fazer: Refaça o processo de registro do número antes de tentar enviar de novo.

• 131057 Conta e número
  Aguardar e retentar

  Conta em modo de manutenção

  A conta comercial está em manutenção. Um motivo possível é um upgrade de throughput em andamento.

  O que fazer: Aguarde a manutenção terminar e retente.

• 133000 Conta e número
  Corrigir e reenviar

  Falha no desregistro anterior

  Uma tentativa anterior de desregistrar o número não foi concluída.

  O que fazer: Desregistre o número novamente antes de registrá-lo.

• 133004 Conta e número
  Aguardar e retentar

  Servidor temporariamente indisponível

  Instabilidade nos servidores da Meta.

  O que fazer: Consulte a página de status da plataforma e retente em alguns minutos.

• 133005 Conta e número
  Corrigir e reenviar

  PIN de duas etapas incorreto

  O PIN de verificação em duas etapas informado está errado.

  O que fazer: Confirme o PIN. Para redefinir, desative a verificação em duas etapas e configure um PIN novo.

• 133006 Conta e número
  Corrigir e reenviar

  Número precisa ser verificado

  O número precisa passar pela verificação antes de ser registrado.

  O que fazer: Verifique e registre o número seguindo o fluxo de registro da plataforma.

• 133008 Conta e número
  Aguardar e retentar

  Tentativas demais de PIN

  Houve chutes demais no PIN de duas etapas desse número.

  O que fazer: Aguarde o tempo indicado no campo details antes de tentar novamente.

• 133009 Conta e número
  Aguardar e retentar

  PIN informado rápido demais

  O PIN de duas etapas foi enviado antes do intervalo mínimo permitido.

  O que fazer: Respeite o intervalo indicado no campo details antes de reenviar.

• 133010 Conta e número
  Corrigir e reenviar

  Número não registrado

  O número não está registrado na WhatsApp Business Platform.

  O que fazer: Registre o número antes de usar a API com ele.

• 133015 Conta e número
  Aguardar e retentar

  Exclusão do número em andamento

  O número que você tenta registrar foi excluído há pouco e a exclusão ainda não terminou.

  O que fazer: Espere cerca de 5 minutos e repita a requisição.

• 2494100 Conta e número
  Aguardar e retentar

  Número em manutenção

  O número comercial está em modo de manutenção.

  O que fazer: Tente novamente em alguns minutos.

• 2388012 Onboarding
  Corrigir e reenviar

  Número já existe na conta

  O número que você tenta migrar já está presente na sua conta do WhatsApp.

  O que fazer: Use um número que ainda não esteja cadastrado na conta de destino.

• 2388091 Onboarding
  Corrigir e reenviar

  Número não elegível para código

  As APIs de verificação de posse do número não valem para esse caso, porque o número não está em migração.

  O que fazer: Siga o fluxo normal de registro e verificação do número.

• 2388093 Onboarding
  Corrigir e reenviar

  Número não elegível para verificação

  Mesma situação do 2388091: o número não está em processo de migração.

  O que fazer: Registre e verifique o número pelo caminho padrão.

• 2388103 Onboarding
  Corrigir e reenviar

  Falha na migração do número

  Erro guarda-chuva da migração. Causas possíveis: webhooks não configurados no destino, nome de exibição não aprovado, conta sem linha de crédito, número em outro Business Manager, WABA de destino não aprovada, ou pedido de "Mensagens para" pendente.

  O que fazer: Leia a mensagem específica que acompanha o código — ela aponta qual das condições falhou — e corrija antes de repetir.

• 2593079 Onboarding
  Acionar suporte

  WABA já marcada para migração

  A conta comercial já foi marcada para migrar para outro solution ID.

  O que fazer: O modelo OBO foi descontinuado. Acione o suporte da Meta para resolver.

• 2593085 Onboarding
  Acionar suporte

  WABA não elegível para transferência

  A conta não pode ser transferida no modelo OBO — em geral porque já pertence ao cliente, ou porque ele ainda não aceitou a solicitação.

  O que fazer: Peça que o cliente aceite a solicitação no Meta Business Suite, ou acione o suporte.

• 2593107 Onboarding
  Corrigir e reenviar

  Limite de sincronizações excedido

  A API de sincronização já foi chamada o número máximo de vezes para esse número — uma vez para contatos e uma para histórico.

  O que fazer: Faça o offboarding do cliente e refaça o onboarding para liberar novas sincronizações.

• 2593108 Onboarding
  Corrigir e reenviar

  Sincronização fora da janela

  A sincronização de contatos e histórico só pode ser iniciada em até 24 horas após o onboarding.

  O que fazer: Refaça o onboarding do usuário e sincronize dentro da janela de 24 horas.

• 1752041 Onboarding
  Não retentar

  Requisição de onboarding duplicada

  Esse cliente já foi convidado ao onboarding por algum parceiro — só o primeiro a chamar a API consegue registrar o pedido.

  O que fazer: Nenhuma ação necessária: todas as contas comerciais elegíveis do cliente entram no processo automaticamente.

• 132068 Flows
  Corrigir e reenviar

  Flow bloqueado

  O Flow está em estado bloqueado e não pode ser enviado.

  O que fazer: Corrija o Flow no WhatsApp Manager antes de enviá-lo de novo.

• 132069 Flows
  Aguardar e retentar

  Flow em throttling

  O Flow está limitado porque já foram enviadas 10 mensagens com ele na última hora.

  O que fazer: Corrija o Flow e aguarde a janela de uma hora antes de novos envios.

• 100 Marketing API
  Corrigir e reenviar

  Parâmetro inválido

  A requisição trouxe parâmetros não suportados ou escritos errado. Na Marketing Messages API, também aparece quando a mensagem não é um template.

  O que fazer: Confira a grafia e os parâmetros aceitos pelo endpoint. Nessa API, o tipo precisa ser template de marketing.

• 131055 Marketing API
  Corrigir e reenviar

  Método não permitido

  Só templates de marketing são aceitos nesse endpoint — templates de utilidade ou autenticação são recusados.

  O que fazer: Reenvie usando um template categorizado como marketing.

• 134100 Marketing API
  Corrigir e reenviar

  Somente mensagens de marketing

  Tentativa de enviar template de utilidade ou autenticação por uma API que só aceita marketing.

  O que fazer: Use um template com categoria MARKETING.

• 134101 Marketing API
  Aguardar e retentar

  Template ainda sincronizando

  O template foi criado há pouco e a sincronização com anúncios pode levar até 10 minutos.

  O que fazer: Aguarde 10 minutos e reenvie.

• 134102 Marketing API
  Acionar suporte

  Template indisponível para uso

  A sincronização do template não foi concluída, ou a conta não é elegível para essa API.

  O que fazer: Verifique o status de elegibilidade da conta. Se estiver como ONBOARDED e o erro persistir, acione o suporte.

• 1 Plataforma
  Aguardar e retentar

  Requisição inválida ou erro de servidor

  Erro genérico: requisição malformada ou problema no servidor da Meta.

  O que fazer: Cheque a página de status da plataforma. Sem incidente, revise o formato da requisição contra a referência.

• 2 Plataforma
  Aguardar e retentar

  Indisponibilidade temporária

  A API está fora do ar ou sobrecarregada no momento.

  O que fazer: Consulte a página de status e retente depois.

• 200005 Plataforma
  Não retentar

  Insights de template indisponíveis

  Os insights de template ainda não estão disponíveis para essa conta comercial.

  O que fazer: Não é possível habilitar no momento — o recurso depende de liberação da Meta.

• 200006 Plataforma
  Não retentar

  Insights não podem ser desativados

  Operação inválida: uma vez habilitados, os insights de template não podem ser desligados.

  O que fazer: Nenhuma ação possível — o comportamento é definitivo.

• 200007 Plataforma
  Corrigir e reenviar

  Insights de template não habilitados

  Os insights de template não foram habilitados para essa conta comercial.

  O que fazer: Habilite os insights seguindo o fluxo de confirmação de analytics de template.

Referência mantida pela OniSell com base na documentação oficial da Meta para a WhatsApp Cloud API, revisada em julho de 2026. Os códigos e os comportamentos podem mudar sem aviso — em caso de divergência, vale sempre o que estiver na documentação da Meta.