HSM - Falha no envio de mensagens

Quando a mensagem de HSM é enviada, pode apresentar algumas falhas, como:

• Se o número de telefone não é válido:
  • Número de telefone incorreto.
  • Número de origem e destino são iguais.
  • Número de telefone tem alguma restrição para recebimentos.
  • Número bloqueado.
• Mensagem não entregue:
  • O número de telefone do destinatário não está registrado no WhatsApp.
  • O destinatário não aceitou os novos Termos de Serviço e a nova Política de Privacidade.
  • O tipo de arquivo enviado não é aceito pela Meta, em versões mais antigas do WhatsApp.
  • O destinatário está usando uma versão antiga do WhatsApp. É preciso usar as seguintes versões do WhatsApp ou posteriores:
    • Android: 2.21.15.15
    • SMBA: 2.21.15.15
    • iOS: 2.21.170.4
    • SMBI: 2.21.170.4
    • KaiOS: 2.2130.10
• O rate limit foi atingido:
  • Foi atingida a capacidade de transitar mensagens na API. Recomenda-se enviar novamente a mensagem.
• Elementname não é válido:
  • O element name pode estar errado.
  • O modelo não existe no idioma especificado ou não foi aprovado.
• Tipo do anexo não é válido:
  • Tipo do anexo não é válido pela Meta.
• Erro genérico:
  • Pode apresentar qualquer tipo de erro. Para saber o por que do erro, entre em contato com o nosso suporte.

Erros genéricos podem ocorrer, por exemplo, porque o destinatário faz parte de um experimento da Meta, onde 1% dos usuários do WhatsApp não receberão mensagens de marketing de nenhuma empresa. Para mais detalhes sobre este experimento, acesse o artigo da Meta.

Outro motivo comum de falha é o Código de Erro 131049 - "A Meta escolheu não entregar a mensagem para manter um engajamento saudável no ecossistema", em que o WhatsApp limita o número de mensagens de marketing que o consumidor recebe de uma empresa em determinado período. As regras da Meta estipulam duas (2) mensagens da categoria marketing em uma janela de 24 horas. Após o envio sequencial é necessário aguardar a interação por parte do consumidor para evitar falhas de envio e possíveis impactos na qualidade do número. Para mais detalhes sobre essa limitação, acesse o artigo da Meta. Consulte os motivos da falha ao exportar o relatório de WhatsApp - Envios de Mensagem (Relatórios > Geral > WhatsApp > HSM).