Passar para o conteúdo principal

Principais motivos de falhas no envio

Este artigo descreve os principais motivos de falha no envio de mensagens pelo WhatsApp

Atualizado há mais de 2 meses

Como identificar que o envio de uma mensagem falhou?

Antes de falar dos principais erros, precisamos falar primeiro de como identificar que o disparo de uma mensagem falhou. Identificar isso é bem simples e você pode ver em dois locais diferentes.

Dentro da própria campanha, na aba de atividades

  1. Acesse seu painel da Martz

  2. Vá no menu "Campanhas"

  3. Clique na campanha que deseja analisar

  4. Clique na aba "Atividades"

  5. Visualize as atividades nesta aba, podendo filtrar por data da ação e por status de envio

  6. Ao identificar uma mensagem com falha (status "Falha"), logo abaixo do status da mensagem aparece um link "Ver detalhes"

  7. Clique no "Ver detalhes" da mensagem que deseja, irá abrir um pop-up com os detalhes do motivo de erro no envio

No menu "Atividades"

Similarmente à aba de "Atividades" dentro da tela de detalhes da campanha, os detalhes de cada mensagem podem ser acessados através da tela de "Atividades", no menu lateral do seu painel. A diferença é que, nesta tela, você pode ver as atividades de todas as suas campanhas, não apenas de uma só.

  1. Acesse o sei painel da Martz

  2. No menu lateral do painel, clique em "Atividades", na seção "Executar"

  3. Visualize as mensagens que deseja, podendo filtrar por campanha, status de envio e período de datas

  4. Ao identificar uma mensagem com falha (status "Falha"), logo abaixo do status da mensagem aparece um link "Ver detalhes"

  5. Clique no "Ver detalhes" da mensagem que deseja, irá abrir um pop-up com os detalhes do motivo de erro no envio

Principais mensagens de falha no envio por WhatsApp

Uma vez identificada uma mensagem com erro no envio, o pop-up de detalhes vai exibir o detalhe da causa da falha exatamente da forma como a Meta informa à Martz (por isso, inclusive, a mensagem fica em inglês). No próprio pop-up tem, também, um link de documentação da Meta com a lista de erros possíveis na entrega de mensagens:

A mensagem de erro da Meta é composta por um código numérico, um título e uma mensagem de detalhe. Pelo código do erro é possível pesquisar na documentação acima.

Erros que não são possíveis contornar/resolver

Nesta seção vamos listar os principais erros que, quando aparecem, não tem o que fazer. Eles significam que aquela mensagem não foi nem vai conseguir ser enviada para aquele destinatário, nem se tentar de novo.

This message was not delivered to maintain healthy ecosystem engagement

Este erro significa que a Meta escolheu não entregar esta mensagem, sem mais detalhes.

Message undeliverable

Significa que não foi possível entregar a mensagem por um dos motivos abaixo:

  • O número de telefone do destinatário não é um número do WhatsApp.

  • O destinatário não aceitou nossos novos Termos de Serviço e Política de Privacidade.

  • O destinatário está usando uma versão antiga do WhatsApp; é necessário usar uma versão igual ou superior a:

    • Android: 2.21.15.15

    • SMBA: 2.21.15.15

    • iOS: 2.21.170.4

    • SMBI: 2.21.170.4

    • KaiOS: 2.2130.10

    • Web: 2.2132.6

User’s number is part of an experiment

A Meta ocasionalmente realiza experimentos para avaliar o impacto das mensagens na experiência e no engajamento do usuário do WhatsApp. Essas são práticas padrão de Meta, com o fim de ajudar a aprimorar a experiência de mensagens tanto para você quanto para seus clientes. Também significa que a Meta escolheu não enviá-la e não há o que possa ser feito.

WhatsApp provided number needs display name approval before message can be sent

Esta mensagem de erro já diz tudo (em tradução livre): este número de WhatsApp precisa de aprovação do nome de exibição antes que a mensagem possa ser enviada.

Significa que, no processo de configuração deste número de WhatsApp, optou-se por "nome de exibição" ao invés do número. Neste caso, é necessário aguardar a Meta aprovar o nome de exibição definido para este número antes de conseguir utilizá-lo.

Erros para os quais existe uma ação a ser tomada

Por outro lado, alguns erros podem e devem ser tratados, de forma que mesmo que não permita enviar novamente uma mensagem específica, possa permitir voltar a disparar outras.

Business eligibility payment issue

Este erro significa que as mensagens não estão sendo entregues porque há alguma pendência de pagamento dentro da sua BM. Geralmente ocorre quando há um saldo pendente de pagamento porque o cartão de crédito foi bloqueado, expirou, ou o banco emissor do cartão recusou a tentativa de cobrança da Meta.

Para resolver, é necessário entrar na sua BM, nas formas de pagamento, e pagar o saldo em aberto (pode ser necessário cadastrar um novo cartão).

Para encontrar o link dessa área da sua BM, você pode:

  1. Acessar seu painel da Martz

  2. Clicar no nome do seu usuário, no canto superior direito da tela

  3. Clicar em "Configurações"

  4. Clicar em "WhatsApp"

  5. Clicar na aba "Telefones Oficiais"

  6. Clicar em cima do número de telefone pelo qual está tendo falha no envio

  7. Na tela de detalhes desse número, clicar no botão "Métodos de pagamento"

  8. Fazer login/estar logado com uma conta de administrador da BM onde esse número de WhatsApp está configurado

Spam rate limit hit

Esta mensagem não pôde ser enviada porque há restrições quanto ao número de mensagens que podem ser enviadas deste número de telefone. Isso pode ter ocorrido porque muitas mensagens anteriores foram bloqueadas ou sinalizadas como spam pelos destinatários.

O que precisa ser feito, neste caso, é melhorar a saúde do seu número. Para isso, é importante que:

  • Confira as campanhas em que utiliza esse número para disparo e verifique se podem estar permitindo envio de mensagens durante a madrugada (mensagens de marketing nesses horários são mais sujeitas a report de Spam pelos usuários)

  • Confira o conteúdo das mensagens que estão sendo disparadas por este número. Verifique se o conteúdo delas não pode estar deixando o cliente na dúvida da legitimidade do disparo.

  • Evite usá-lo por um tempo para campanhas de Marketing. Considere usá-lo para campanhas mais operacionais, como Status do Pedido, Código de Rastreio, Pedido Aprovado. Esse tipo de uso tem muito menos risco de ser denunciado pelo cliente.

  • Confira sua BM, nos detalhes desse número, por mais informações que a Meta possa ter colocado lá.

É necessário melhorar a saúde do número novamente para que as restrições sejam retiradas e o uso possa voltar como era.

Re-engagement message

Esta mensagem de erro geralmente aparece durante o uso do módulo de "Atendimento" e significa que, naquela conversa, a janela de 24 horas durante a qual você pode conversar com seu cliente sem um novo custo se encerrou.

Isso significa que, se quiser entrar em contato com o cliente novamente, precisa enviar uma nova mensagem paga (via template) ou esperar que o cliente entre em contato novamente.

Observação: Este artigo é apenas um guia geral. As políticas do WhatsApp Business podem ser atualizadas periodicamente, por isso, é importante consultar a documentação oficial da Meta para obter informações mais recentes e detalhadas.

Respondeu à sua pergunta?