Erros de envio de mensagens do WhatsApp
Visão geral
Quando a Meta recusa uma mensagem enviada pelo Opa! Suite no WhatsApp API, a mensagem aparece na conversa com um ícone vermelho de alerta ao lado do balão. Para ver o motivo, passe o mouse sobre o ícone.
O motivo vem da Meta e o Opa! Suite o traduz para o português. Quando o código não é reconhecido, aparece Mensagem não enviada ao cliente. Em canais pela 360dialog, o motivo aparece em inglês, com o texto original da Meta. A mensagem com falha não é reenviada automaticamente: depois de corrigir a causa, envie de novo.
Procure na tabela abaixo o texto exibido no tooltip (use a busca do navegador, Ctrl+F, com o começo da frase) e clique em Ver solução.
Encontre o erro
| Motivo exibido no Opa! Suite | Código | O que significa | Solução |
|---|---|---|---|
| Mensagem não enviada por falha no pagamento. Acesse Facebook > Gerenciador de Negócios > Contas do WhatsApp, verifique pendências e recarregue o saldo de sua conta para retomar os envios. | 131042 | A Meta não conseguiu cobrar a conta. | Ver solução |
| Janela de 24h fechada (Requer novo envolvimento via template). | 131047 | Mensagem livre fora da janela de 24 horas. | Ver solução |
| O contato ainda não iniciou uma conversa com sua empresa pelo WhatsApp selecionado. | 131062 | O contato nunca conversou com esse número. | Ver solução |
| Mensagem não enviada. A Meta suspendeu o recebimento de templates de marketing para este cliente. Por favor, tente novamente usando um template utilitário. | 131049 | O contato atingiu o limite de marketing da Meta. | Ver solução |
| Mensagem não enviada. O número que você tentou chamar não consegue receber templates de Marketing no momento. Por favor, tente novamente usando um template utilitário. | 130472 | O contato faz parte de um experimento da Meta. | Ver solução |
| O usuário bloqueou o recebimento de mensagens de marketing. | 131050 | O contato pediu para não receber marketing. | Ver solução |
| Mensagem não enviada. O cliente não tem conta de WhatsApp. | 131026 | O número não tem WhatsApp ou não recebe a mensagem. | Ver solução |
| O remetente e o destinatário não podem ser o mesmo. | 131021 | Envio para o próprio número da empresa. | Ver solução |
| Incompatibilidade na contagem de parâmetros do modelo. | 132000 | Faltam ou sobram variáveis. | Ver solução |
| Parâmetro obrigatório ausente. | 131008 | Faltou preencher uma informação obrigatória, como uma variável. | Ver solução |
| O valor do parâmetro é inválido. | 131009 | Uma informação foi preenchida com valor inválido. | Ver solução |
| Modelo não existe ou não foi aprovado. | 132001 | Modelo excluído, pendente ou em outro idioma. | Ver solução |
| Texto traduzido do modelo é longo demais. | 132005 | O texto com as variáveis passou do limite. | Ver solução |
| Conteúdo do modelo viola política. | 132007 | O texto descumpre uma política do WhatsApp. | Ver solução |
| Formato do parâmetro do modelo incorreto. | 132012 | Variável em formato diferente do esperado. | Ver solução |
| Modelo pausado por baixa qualidade. | 132015 | O modelo foi pausado por baixa qualidade. | Ver solução |
| Modelo desabilitado permanentemente. | 132016 | O modelo foi pausado várias vezes. | Ver solução |
| O modelo ainda está sincronizando (Aguarde 10 min). | 134101 | Modelo recém-aprovado. | Ver solução |
| Parâmetro inválido (Deve ser mensagem de template). | 100 | A requisição tem parâmetro não suportado ou incorreto. | Ver solução |
| Tipo de mensagem não compatível. | 131051 | Formato de mensagem não suportado. | Ver solução |
| Erro de download de mídia enviada pelo usuário. | 131052 | Arquivo do cliente em formato não suportado. | Ver solução |
| Erro de carregamento de mídia na mensagem. | 131053 | Arquivo enviado em formato não suportado. | Ver solução |
| Muitas chamadas de API (Limite do App). | 4 | Limite de requisições atingido. | Ver solução |
| Limite de volume da conta WhatsApp Business atingido. | 80007 | A conta atingiu o limite de volume. | Ver solução |
| Limite de taxa de transferência de dados atingido. | 130429 | Muitas mensagens por segundo. | Ver solução |
| Limite de taxa de spam atingido. | 131048 | Muitas mensagens bloqueadas ou denunciadas. | Ver solução |
| Limite de volume de emparelhamento atingido (Muitas mensagens em curto período). | 131056 | Muitas mensagens para o mesmo contato em pouco tempo. | Ver solução |
| Bloqueado temporariamente por violações de políticas. | 368 | Conta restrita por violação de política. | Ver solução |
| Conta bloqueada (Violação de política ou dados incorretos). | 131031 | Conta bloqueada ou dados não verificados. | Ver solução |
| Conta impedida de enviar mensagens a usuários neste país. | 130497 | Restrição de envio para o país do contato. | Ver solução |
| Conta em modo de manutenção. | 131057 | Manutenção temporária na conta. | Ver solução |
| AuthException. Não foi possível autenticar o usuário. | 0 | Falha na autenticação com a Meta. | Ver solução |
| Método de API. Problema de recursos ou permissões. | 3 | Recurso ou permissão indisponível. | Ver solução |
| Permissão negada ou removida. | 10 | Permissão da integração removida. | Ver solução |
| O token de acesso expirou. | 190 | A conexão com a Meta expirou. | Ver solução |
| Erro de permissão da API. | 200 | Permissão da integração ausente. | Ver solução |
| Acesso negado. | 131005 | Permissão negada pela Meta. | Ver solução |
| Número de telefone comercial inválido ou excluído. | 33 | O número da empresa não está ativo na Meta. | Ver solução |
| Número de telefone não registrado. | 133010 | O número da empresa não foi registrado. | Ver solução |
| Certificado incorreto (Falha ao enviar mensagem). | 131045 | Erro no registro do número. | Ver solução |
| Nome de exibição precisa ser aprovado. | 131037 | O nome de exibição não foi aprovado. | Ver solução |
| API desconhecida. Solicitação inválida ou erro do servidor. | 1 | Erro do lado da Meta. | Ver solução |
| Serviço de API temporariamente indisponível (Sobrecarga). | 2 | Instabilidade na Meta. | Ver solução |
| Serviço temporariamente indisponível. | 131016 | Instabilidade na Meta. | Ver solução |
| Ocorreu um erro desconhecido. | 131000 | Falha sem motivo informado. | Ver solução |
| Erro genérico do usuário. | 135000 | Falha sem motivo informado. | Ver solução |
| Mensagem não enviada ao cliente | — | Motivo não identificado pelo Opa! Suite. | Ver solução |
Falha no pagamento
Em inglês: Business eligibility - Payment issue (131042).
Causa
A Meta não conseguiu cobrar os envios da conta do WhatsApp: cartão sem limite, bloqueado, vencido, recusado ou com pagamento pendente. Enquanto houver pendência, a Meta não aceita novas mensagens.
Como resolver
- Se a sua conta é paga diretamente à Meta, acesse o portfólio empresarial da Meta (antigo Gerenciador de Negócios), abra Contas do WhatsApp → Configurações de pagamento, confira as pendências e cadastre ou atualize o cartão. O passo a passo está em Adicionar uma forma de pagamento na conta do WhatsApp na Meta.
- Se o canal é pela 360dialog, adicione saldo na conta. Veja Inserir saldo no hub da 360Dialog.
- Depois de regularizar, envie de novo as mensagens que falharam.
Janela de 24 horas fechada
Em inglês: Re-engagement message (131047).
Causa
A empresa tentou enviar uma mensagem livre (texto, áudio, arquivo) para um contato que não envia mensagem há mais de 24 horas, ou que nunca conversou com esse número. Fora da janela de atendimento, a Meta só aceita modelos de mensagem.
Como resolver
- Envie um modelo de mensagem aprovado pelo ícone de modelos do atendimento.
- Aguarde o contato responder. A resposta abre uma nova janela de 24 horas.
- Continue a conversa normalmente.
Mais detalhes em Janela de atendimento do WhatsApp.
Limite de mensagens de marketing
Causa
A Meta limita quantos modelos de marketing cada contato recebe, considerando as mensagens promocionais de todas as empresas e o quanto o contato interage com elas (131049). O envio também falha quando o contato faz parte de um experimento da Meta que suspende marketing (130472, em inglês Failed to send a message because this user's phone number is part of an experiment) ou quando ele mesmo bloqueou mensagens de marketing da sua empresa (131050).
Como resolver
- Se o conteúdo for informativo (fatura, aviso, confirmação), envie um modelo da categoria Utilidade.
- Para marketing, tente de novo mais tarde. Não reenvie em sequência para o mesmo contato.
- Se o seu WhatsApp é do Broker Opa! Suite, ative a entrega otimizada de marketing. Veja Ativar a entrega otimizada de mensagens de marketing.
- Para o erro 131050, respeite a escolha do contato e não envie mais marketing para ele.
Contato sem WhatsApp
Causa
O número do contato não tem conta no WhatsApp, está incorreto ou não consegue receber a mensagem (131026, em inglês Message undeliverable). Também acontece quando o destinatário é o próprio número da empresa (131021, Recipient cannot be sender).
Verificações
- O número tem código do país e DDD corretos?
- O contato usa uma versão atualizada do WhatsApp?
Como resolver
- Corrija o número no cadastro do contato.
- Confirme com o contato, por outro canal, se ele usa WhatsApp nesse número.
- Peça para o contato atualizar o aplicativo, se for o caso.
Problemas no modelo de mensagem
Causa
O modelo de mensagem enviado não está pronto para uso ou foi preenchido de forma diferente do que foi aprovado:
- 132000 (Template Param Count Mismatch): a quantidade de variáveis enviadas é diferente da do modelo.
- 131008 e 131009: faltou uma informação obrigatória ou ela foi preenchida com um valor inválido.
- 132001 (Template does not exist): o modelo foi excluído, ainda não foi aprovado ou não existe no idioma escolhido.
- 132005 (Template Hydrated Text Too Long): o texto, com as variáveis preenchidas, ficou longo demais.
- 132007 (Template Format Character Policy Violated): o conteúdo descumpre uma política do WhatsApp.
- 132012 (Template Parameter Format Mismatch): uma variável foi preenchida em formato diferente do esperado.
- 132015 e 132016: o modelo foi pausado por baixa qualidade ou desabilitado de vez, depois de ser pausado várias vezes.
- 134101: o modelo acabou de ser aprovado e ainda está sincronizando.
- 100: a requisição enviada à Meta tem um parâmetro não suportado ou incorreto.
Como resolver
- Confira o status do modelo na lista de modelos de mensagem do canal no Opa! Suite.
- Preencha todas as variáveis, com valores no formato esperado e sem deixar campos vazios.
- Se o modelo foi rejeitado, pausado ou desabilitado, ajuste o texto e crie um novo modelo. Veja Criação de modelos de mensagem do WhatsApp.
- Para o erro 134101, aguarde cerca de 10 minutos e envie de novo.
Mídia ou tipo de mensagem não suportado
Causa
O arquivo ou o tipo de mensagem não é aceito pelo WhatsApp: 131051 (Unsupported message type), 131052 (Media download error, arquivo enviado pelo cliente) ou 131053 (Media upload error, arquivo enviado pela empresa).
Como resolver
- Envie o arquivo em um formato comum (JPG ou PNG para imagem, MP4 para vídeo, PDF para documento) e dentro do tamanho permitido pelo WhatsApp.
- Se o arquivo veio do cliente, peça para ele reenviar em outro formato.
Limite de envio atingido
Causa
A conta enviou mais mensagens do que a Meta permite em um intervalo: excesso de requisições (4, API Too Many Calls), limite de volume da conta (80007, Rate limit issues), muitas mensagens por segundo (130429, Rate limit hit), muitas mensagens para o mesmo contato em pouco tempo (131056, pair rate limit hit) ou excesso de mensagens bloqueadas e denunciadas (131048, Spam rate limit hit).
Como resolver
- Aguarde alguns minutos e envie de novo.
- Divida os envios em massa em lotes menores e espaçados.
- Para o erro 131048, confira a qualidade do número no Gerenciador do WhatsApp e revise os modelos com muitos bloqueios. Veja Cartilha de boas práticas do WhatsApp API.
Conta bloqueada ou restrita
Causa
A Meta restringiu a conta do WhatsApp por violação de política (368, Temporarily blocked for policies violations), bloqueou a conta por violação ou por não conseguir verificar os dados da empresa (131031, Account has been locked), impediu envios para o país do contato (130497) ou colocou a conta em manutenção temporária (131057).
Verificações
- Há aviso da Meta no e-mail cadastrado no portfólio empresarial?
- O Gerenciador do WhatsApp mostra restrição ou qualidade baixa no número?
Como resolver
- Leia o aviso da Meta para saber qual política foi descumprida. Veja Políticas de uso do WhatsApp Business.
- Se não concordar com a decisão, peça uma revisão à Meta. Veja Abrir um chamado com o suporte da Meta.
- Para manutenção (131057), aguarde e tente mais tarde.
- Se precisar de ajuda, fale com o suporte do Opa! Suite.
Permissão ou autenticação
Causa
A conexão entre o Opa! Suite e a Meta perdeu permissão ou expirou: 0 (AuthException), 3 (API Method), 10 (Permission Denied), 190 (Access token has expired), 200 (API Permission) ou 131005 (Access denied). Costuma acontecer quando a permissão do aplicativo é removida no portfólio empresarial.
Como resolver
- Confira, no portfólio empresarial, se a conta do WhatsApp continua com acesso liberado para a integração.
- Fale com o suporte do Opa! Suite para refazer a conexão do canal.
Número da empresa não registrado
Causa
O número da empresa não está ativo na plataforma do WhatsApp: número inválido ou excluído (33), número não registrado (133010, Phone number Not Registered), erro no registro (131045, Incorrect certificate) ou nome de exibição ainda não aprovado (131037).
Como resolver
- Confira o status do número e do nome de exibição no Gerenciador do WhatsApp.
- Fale com o suporte do Opa! Suite para concluir ou refazer o registro do número.
Instabilidade ou erro desconhecido
Causa
A Meta não conseguiu processar a mensagem por instabilidade ou erro interno: 1 (API Unknown), 2 (API Service), 131016 (Service unavailable), 131000 (Something went wrong) ou 135000 (Generic user error). A mensagem Mensagem não enviada ao cliente aparece quando a Meta não informou um motivo que o Opa! Suite reconheça.
Como resolver
- Consulte a página de status dos produtos empresariais da Meta.
- Aguarde alguns minutos e envie de novo.
- Se o erro continuar, fale com o suporte do Opa! Suite informando o horário do envio e o contato.
Boas práticas
- Confira a forma de pagamento ou o saldo antes de envios em massa.
- Use modelos de mensagem aprovados e específicos, preenchendo todas as variáveis.
- Envie marketing só para quem aceitou e espace os disparos.
- Acompanhe o e-mail do portfólio empresarial e a qualidade do número no Gerenciador do WhatsApp.
Conteúdos relacionados
- Janela de atendimento do WhatsApp
- Preços das mensagens do WhatsApp API
- Adicionar uma forma de pagamento na conta do WhatsApp na Meta
- Ativar a entrega otimizada de mensagens de marketing
- Políticas de uso do WhatsApp Business
- Criar um modelo de mensagem do WhatsApp
- Códigos de erro da API de Nuvem do WhatsApp (Meta)