Durante o uso do módulo de atendimento do CRM de Vendas PipeRun pelo canal de WhatsApp, você pode encontrar códigos de erro que impedem o envio de mensagens ao cliente. 

Este artigo apresenta esses códigos, comuns no WhatsApp API Cloud META, e as soluções recomendadas para resolver cada problema. Ao entender o motivo de cada falha, você poderá corrigir os erros com mais agilidade, garantindo a continuidade das integrações e a qualidade do atendimento aos seus usuários.

A Meta atualiza frequentemente a documentação sobre os códigos de erro. Se o erro que você encontrou não estiver listado neste artigo, consulte a documentação oficial da Meta por meio deste link.

TÓPICOS DO ARTIGO

  1. Erros de autorização
  2. Erros de limite de uso
  3. Erros de política ou bloqueio
  4. Erros de mensagem e conteúdo
  5. Erros de entrega
  6. Erros gerais

ERROS DE AUTORIZAÇÃO

Este erros estão relacionados a conexão do WhatsApp com o módulo de atendimento.

Será necessário ativar novamente sua conta do WhatsApp. Entre em contato com o time de suporte para que eles ajudem você nesse processo.

Código do erro: 0 — AuthException
Descrição: Não foi possível conectar sua conta do WhatsApp.
Possível causa: O acesso entre o módulo de atendimento e o WhatsApp expirou ou foi removido.
Como resolver: Refaça a conexão da conta do WhatsApp no módulo de atendimento de forma que seja gerado um novo token de autenticação.

Código do erro: 3 — Método de API
Descrição: Você não tem permissão para fazer essa ação.
Possível causa: Sua conta do WhatsApp não está liberada para este tipo de envio.
Como resolver: Peça ao responsável pela conta para revisar as permissões e liberar o acesso.

Código do erro: 10 — Permissão negada
Descrição: A permissão necessária não está ativa.
Possível causa: A permissão foi removida ou o número usado não está autorizado.
Como resolver: Verifique se o número do WhatsApp está autorizado e, se preciso, refaça a conexão.

Código do erro: 190 — O token de acesso expirou
Descrição: Sua conexão com o WhatsApp perdeu a validade.
Possível causa: O código de acesso venceu ou foi removido.
Como resolver: Gere um novo token de acesso e reconecte sua conta para continuar usando.

Código do erro: 200–299 — Permissão da API
Descrição: Sua conta não tem acesso para realizar essa ação.
Possível causa: Falta de autorização ou escopo de acesso não liberado.
Como resolver: Peça ao responsável pela conta para revisar as permissões e liberar o acesso.

Código do erro: 131005 — Access denied
Descrição: Permissão negada para executar a ação.
Possível causa: O login usado perdeu acesso ou as permissões da conta foram alteradas.
Como resolver: Desconecte a conta atual e reconecte novamente com o mesmo usuário que fez a integração original.

Código do erro: 401 ou 403 — Unauthorized / Forbidden
Descrição: O sistema não conseguiu autenticar sua conta do WhatsApp.
Possível causa: O token de acesso está vencido ou foi removido da Meta.
Como resolver: Gere um novo token de acesso e repita a integração no módulo de atendimento.

ERROS DE LIMITE DE USO

Em geral estes erros se referem ao volume de mensagens enviadas simultaneamente e podem ocorrer no envio de mensagens em massa ou abertura de muitos atendimentos ao mesmo tempo.

Para resolver, aguarde alguns minutos e tente enviar as mensagens mais tarde.

Código do erro: 4 — Muitas chamadas de API
Descrição: O sistema atingiu o limite de chamadas da API.
Possível causa: Foram feitas muitas solicitações em pouco tempo.
Como resolver: Aguarde alguns minutos e reduza a frequência de envios.

Código do erro: 80007 — Problemas com limite de volume
Descrição: A conta atingiu o limite de volume de mensagens.
Possível causa: Muitas mensagens foram enviadas em pouco tempo.
Como resolver: Aguarde um tempo antes de tentar novamente ou reduza a quantidade de mensagens enviadas.

Código do erro: 130429 — Limite de volume atingido
Descrição: O limite de transferência de dados da API foi atingido.
Possível causa: Volume alto de envio em pouco tempo.
Como resolver: Aguarde antes de tentar novamente ou reduza a frequência de mensagens.

Código do erro: 131048 — Limite de taxa de spam atingido.
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 consideradas indesejadas.
Como resolver: Revise o conteúdo enviado e reduza a frequência. Se necessário, melhore a qualidade das mensagens.

Código do erro: 131056 — Limite de volume de emparelhamento atingido (conta comercial, conta de consumidor).
Descrição: Foram enviadas várias mensagens seguidas para o mesmo número.
Possível causa: O sistema entende isso como excesso.
Como resolver: Espere um tempo antes de tentar falar novamente com o mesmo contato.

Código do erro: 133016 — Limite de taxa de registro/exclusão de contas excedido.
Descrição: O número atingiu o limite de tentativas de registro ou exclusão em pouco tempo.
Possível causa: Muitas tentativas seguidas de registrar ou excluir o número.
Como resolver: Aguarde o desbloqueio automático e tente novamente depois.

ERROS DE POLÍTICA OU BLOQUEIO

Este erros ocorrem normalmente porque a empresa descumpriu algum dos termos da política do WhatsApp ou esta com sua conta bloqueada.

Código do erro: 368 — Bloqueado temporariamente por violações de políticas
Descrição: Sua conta de WhatsApp foi bloqueada temporariamente.
Possível causa: A conta violou alguma regra do WhatsApp.
Como resolver: Revise as políticas da WhatsApp e ajuste o envio de mensagens para evitar novos bloqueios.

Código do erro: 131031 — Conta bloqueada
Descrição: Sua conta de WhatsApp foi bloqueada.
Possível causa: Violação de políticas ou dados incorretos (ex.: PIN errado).
Como resolver: Consulte a API de Status de Integridade, que pode fornecer mais insights sobre o(s) motivo(s) para o bloqueio da conta.

Código do erro: 130497 — A conta comercial está impedida de enviar mensagens a usuários neste país
Descrição: Sua conta não pode enviar mensagens para números de determinados países.
Possível causa: Alguns países são incompatíveis com o envio de mensagens de determinadas categorias de empresas.
Como resolver: Confira em quais países sua conta está autorizada a enviar mensagens.

ERROS DE MENSAGEM E CONTEÚDO

Código do erro: 131051 — Tipo de mensagem não suportado
Descrição: O WhatsApp não aceita o tipo de mensagem enviada.
Possível causa: Envio de um formato que a plataforma não reconhece (ex.: mídia ou botão inválido).
Como resolver: Tente enviar uma mensagem simples de texto ou outro formato permitido.

Código do erro: 131052 — Erro ao baixar mídia
Descrição: Não foi possível carregar o arquivo recebido.
Possível causa: O arquivo pode ter sido apagado ou o link expirou.
Como resolver: Peça ao cliente para reenviar o arquivo ou envie novamente pelo módulo de atendimento.

Código do erro: 132000 — Erro no uso do modelo de mensagem (template)
Descrição: O modelo de mensagem (template) não corresponde às informações enviadas.
Possível causa: Faltam variáveis ou o modelo não foi aprovado pela Meta.
Como resolver: Verifique se o modelo foi criado e aprovado no WhatsApp Business Manager antes de usar.

Código do erro: 131047 — Mensagem fora da janela de 24 horas
Descrição: O cliente não respondeu há mais de 24 horas.
Possível causa: O WhatsApp só permite mensagens livres dentro das primeiras 24h após a última resposta.
Como resolver: Use uma mensagem de modelo (template) aprovada para retomar a conversa.

Código do erro: 131049 — Mensagem não entregue
Descrição: O WhatsApp optou por não entregar a mensagem.
Possível causa: Envio em massa, mensagens repetitivas ou qualidade baixa de envio.
Como resolver: Aguarde um tempo antes de reenviar e evite mensagens automáticas repetidas.

ERROS DE ENTREGA

Código do erro: 131021 — Mesmo número de envio e destino
Descrição: Tentativa de enviar mensagem para o próprio número.
Possível causa: O número do remetente e do destinatário são iguais.
Como resolver: Teste a mensagem com outro número de telefone.

Código do erro: 131026 — A mensagem não pode ser entregue
Descrição: A mensagem não pôde ser entregue.
Possível causa: O número não está no WhatsApp, o cliente não aceitou os novos termos ou está usando uma versão antiga do aplicativo.
Como resolver: Entre em contato com o cliente por outro canal e peça que ele atualize o WhatsApp e aceite os termos de uso.

ERROS GERAIS

Código do erro: 1 ou 400 — Requisição inválida
Descrição: O sistema recebeu uma solicitação com dados incorretos.
Possível causa: Algum campo da mensagem foi preenchido errado.
Como resolver: Verifique se todos os campos obrigatórios estão preenchidos corretamente no módulo de atendimento.

Código do erro: 2 ou 503 — Serviço temporariamente indisponível
Descrição: O WhatsApp está com instabilidade momentânea.
Possível causa: Manutenção ou alto volume de uso.
Como resolver: Aguarde alguns minutos e tente novamente mais tarde.

Código do erro: 33 — O valor do parâmetro é inválido
Descrição: O número de telefone informado não pôde ser usado.
Possível causa: O número foi removido ou não é válido.
Como resolver: Revise o número de telefone e tente novamente.

Código do erro: 100 — Parâmetro inválido
Descrição: Alguns dados enviados não são aceitos.
Possível causa: Erro de digitação, formato incorreto ou chave inválida.
Como resolver: Revise as informações preenchidas (como telefone ou chave pública) e corrija antes de enviar novamente.

Código do erro: 130472 — O número do usuário faz parte de um experimento
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.
Como resolver: Não é possível enviar mensagens para este usuário durante o teste.

Código do erro: 131000 — Erro interno
Descrição: O WhatsApp encontrou um erro inesperado.
Possível causa: Falha temporária na plataforma.
Como resolver: Espere alguns minutos e envie novamente a mensagem.

Código do erro: 131005 — Acesso negado
Descrição: Você não tem acesso para realizar esta ação.
Possível causa: Permissão necessária removida ou vencida.
Como resolver: Reconecte sua conta ou peça para o responsável revisar as permissões.

Código do erro: 131008 — Parâmetro obrigatório ausente
Descrição: Faltam informações para enviar a mensagem.
Possível causa: Algum campo obrigatório não foi preenchido.
Como resolver: Preencha todos os campos necessários e tente novamente

Código do erro: 131009 — O valor do parâmetro é inválido
Descrição: Um dado enviado está incorreto.
Possível causa: Número de telefone ou informação em formato errado.
Como resolver: Corrija o dado informado e envie novamente.

Código do erro: 131016 — Serviço indisponível
Descrição: O WhatsApp está indisponível no momento.
Possível causa: O serviço de WhatsApp da Meta está temporariamente indisponível.
Como resolver: Antes de tentar de novo, consulte a página WhatsApp Business API Status para ver informações sobre o status da API.

Código do erro: 131037 — O nome de exibição do número fornecido pelo WhatsApp precisa ser aprovado antes que a mensagem possa ser enviada.
Descrição: O nome de exibição do seu número de WhatsApp ainda não foi aprovado.
Possível causa: nome de exibição da conta foi rejeitado.
Como resolver: Ajuste ou aguarde a aprovação do nome de exibição antes de enviar mensagens. Para saber mais, consulte o artigo Como alterar o nome de exibição no WhatsApp Business.

Código do erro: 131042 — Elegibilidade da empresa – Problema com pagamento
Descrição: Há um problema com a forma de pagamento da sua conta.
Possível causa: Falta de forma de pagamento, limite de crédito estourado ou conta suspensa.
Como resolver: Consulte Sobre a cobrança da sua conta do WhatsApp Business e verifique se a faturação está configurada corretamente.

Código do erro: 131045 — Certificado incorreto
Descrição: Ocorreu uma falha ao enviar a mensagem devido a um erro de registro do número de telefone.
Possível causa: A mensagem não foi enviada devido a um erro no registro do número do telefone.
Como resolver: Registre o número de telefone antes de tentar novamente.

Código do erro: 131053 — Erro de carregamento de mídia
Descrição: Não foi possível carregar a mídia usada na mensagem.
Possível causa: Arquivo em formato não compatível.
Como resolver: Use um formato de arquivo aceito pelo WhatsApp e tente novamente.

Código do erro: 131057 — Conta em modo de manutenção
Descrição: Sua conta de WhatsApp está em manutenção.
Possível causa: A conta pode estar passando por uma atualização de taxa de transferência.
Como resolver: Aguarde a manutenção terminar e tente novamente depois.

Código do erro: 132001 — Modelo não existe
Descrição: O modelo de mensagem não existe ou ainda não foi aprovado.
Possível causa: Nome do modelo incorreto ou idioma não configurado/aprovado.
Como resolver: Confirme se o modelo foi aprovado e se está escrito corretamente no idioma certo. Siga as diretrizes para modelos de mensagem.

Código do erro: 132005 - Texto hidratado do modelo longo demais
Possível causa: O conteúdo traduzido ou adaptado ficou maior do que o permitido.
Como resolver: Edite o modelo e reduza o texto antes de tentar novamente. Consulte Classificação de qualidade e status do modelo.

Código do erro: 132007 — Política de caracteres do formato do modelo violada
Descrição: O conteúdo do modelo não segue as regras do WhatsApp.
Possível causa: O texto viola políticas (ex.: uso de termos proibidos).
Como resolver: Revise as Razões de rejeição e ajuste o conteúdo conforme as políticas da plataforma.

Código do erro: 132012 — Incompatibilidade no formato do parâmetro do modelo
Descrição: Algum campo do modelo foi preenchido de forma errada.
Possível causa: O formato da informação não segue o padrão esperado (ex.: data, número).
Como resolver: Revise os campos preenchidos e ajuste para o formato correto. Consulte Diretrizes de modelos de mensagem.

Código do erro: 132015 — Modelo pausado
Descrição: O modelo foi pausado por baixa qualidade.
Possível causa: Muitos usuários classificaram o modelo como ruim.
Como resolver: Melhore o texto do modelo, envie para aprovação e só depois volte a usá-lo. Consulte Diretrizes de modelos de mensagem.

Código do erro: 132016 — Modelo desabilitado
Descrição: O modelo foi desativado permanentemente por baixa qualidade.
Possível causa: O mesmo modelo teve muitas rejeições.
Como resolver: Crie um novo modelo com conteúdo diferente e mais adequado.

Código do erro: 132068 — Flow bloqueado
Descrição: O fluxo está bloqueado.
Possível causa: O fluxo de mensagens foi interrompido ou desativado.
Como resolver: Corrija o fluxo antes de enviar mensagens.

Código do erro: 132069 — Flow limitado
Descrição: O fluxo atingiu o limite de mensagens no período.
Possível causa: Já foram enviadas 10 mensagens no mesmo fluxo na última hora.
Como resolver: Aguarde e tente novamente depois ou reduza a frequência de envios.

Código do erro: 132069 — Flow limitado
Descrição: O cancelamento do registro não foi concluído.
Possível causa: Uma tentativa anterior de cancelamento falhou.
Como resolver: Cancele o registro do número novamente antes de registrá-lo

Código do erro: 133004 — Servidor temporariamente indisponível
Descrição: O servidor do WhatsApp está temporariamente indisponível.
Possível causa: Instabilidade da plataforma.
Como resolver: Aguarde alguns minutos e tente novamente mais tarde.

Código do erro: 133005 — Incompatibilidade do PIN na confirmação em duas etapas
Descrição: O PIN de confirmação em duas etapas está incorreto.
Possível causa: O código informado não corresponde ao PIN da conta.
Como resolver: Revise e insira o PIN correto. Se necessário, redefina o PIN de confirmação em duas etapas.

Código do erro: 133006 — Reverificação do número de telefone necessária
Descrição: O número precisa ser verificado novamente antes do registro.
Possível causa: O número não foi validado corretamente.
Como resolver: Verifique o número de telefone antes de registrá-lo.

Código do erro: 133008 — Muitas tentativas do PIN de confirmação em duas etapas
Descrição: Foram feitas muitas tentativas de inserir o PIN em duas etapas.
Possível causa: Tentativas repetidas e incorretas.
Como resolver: Aguarde o tempo indicado e depois tente novamente com o PIN correto.

Código do erro: 133009 — Tentativa muito rápida do PIN de confirmação em duas etapas
Descrição: O PIN foi inserido rápido demais.
Possível causa: Várias tentativas seguidas sem intervalo.
Como resolver: Aguarde alguns segundos antes de tentar novamente.

Código do erro: 133010 — Número de telefone não registrado
Descrição: O número não está registrado no WhatsApp Business.
Possível causa: Pode ter sido realizado alguma alteração no Gerenciador de negócios que alterou o registro do número.
Como resolver: Registre o número de telefone antes de tentar novamente.

Código do erro: 133015 — Aguarde alguns minutos antes de tentar registrar este número de telefone
Descrição: O número que você está tentando registrar foi excluído recentemente.
Possível causa: A exclusão ainda não foi concluída.
Como resolver: Aguarde 5 minutos e tente novamente.

Código do erro: 134011 — Os termos de serviço do Pagamentos no WhatsApp não foram aceitos
Descrição: Os termos de pagamento do WhatsApp não foram aceitos.
Possível causa: A conta ainda não aceitou os termos de serviço de pagamentos.
Como resolver: Acesse o link indicado na mensagem de erro e aceite os termos antes de tentar novamente.

Código do erro: 135000 — Erro genérico do usuário
Descrição: Houve um erro com os dados enviados.
Possível causa: Alguma informação não foi preenchida corretamente.
Como resolver: revise as informações enviadas e tente novamente. Se o problema continuar, entre em contato com o suporte.

Em caso de dúvidas, chame nossa equipe no chat. 😉