O WhatsApp API Oficial proporciona grandes vantagens para empresas que buscam uma comunicação eficiente e escalável com clientes. No entanto, erros de retorno podem ocorrer, indicando problemas no envio ou processamento de mensagens, conforme informado pela Meta.
1. Message Undeliverable
Esse é um dos erros mais comuns e ocorre quando a mensagem não pôde ser entregue ao destinatário. A causa mais frequente para esse problema é que o número de telefone do destinatário está incorreto ou inativo, mas pode ocorrer nos seguintes cenários:
O destinatário bloqueou a sua empresa;
O contato pode não ter aceitado os novos Termos de Serviço e Política de Privacidade do WhatsApp;
O contato pode estar utilizando uma versão antiga do WhatsApp.
2. Rate Limit Exceeded
Esse erro acontece quando o limite de envio de mensagens é ultrapassado. A API do WhatsApp possui restrições para evitar abusos, e cada conta tem um limite diário baseado no seu "tier" (nível de envio), ou seja na qualidade que a Meta atribui a sua conta. Esse nível pode ser aumentado com base em boas práticas e no volume de mensagens enviadas.
Recomendamos esperar algum tempo antes de tentar enviar novas mensagens para evitar atingir o limite novamente.
3. Spam rate limit reached
Nesse caso, a mensagem não foi enviada pois foi atingido o limite de envios permitidos para o número de telefone da conta. Isso pode ocorrer quando mensagens anteriores foram bloqueadas ou marcadas como spam por alguns destinatários
4. Invalid Phone Number
Esse erro indica que o número de telefone para o qual você está tentando enviar uma mensagem não está cadastrado no WhatsApp.
Recomendamos verificar se o número foi inserido corretamente com o código do país e DDD, e confirmar se o número está registrado no WhatsApp, caso contrário, entre em contato com o cliente por outros meios para atualizar o contato.
5. Access Denied
Esse erro pode surgir quando há um problema de permissão na conta que está tentando enviar a mensagem. Pode estar relacionado a permissões de acesso na API ou até à conta de negócio no Facebook Business. Recomendamos verificar se o token de acesso que você está usando ainda é válido.
Confira as permissões associadas à conta e certifique-se de que a conta do Facebook Business está em ordem e autorizada para usar o WhatsApp API.
6. Media loading error
Esse erro aparece quando você tenta enviar um tipo de conteúdo não suportado pelo WhatsApp, como formatos de mídia não permitidos (ex: certos tipos de arquivos ou mensagens fora do padrão).
Recomendamos que seja revisado o tipo de mídia que você está tentando enviar e garanta que é suportado pela API (imagens, vídeos, documentos, áudio, etc.).
7. Paused model
O modelo foi pausado devido à baixa qualidade e não pode ser enviado em mensagens, recomendamos nesse caso excluir o template e recria-lo.
8. Model disabled
Isso significa que o seu template foi desativado, pois foi pausado várias vezes por causa da baixa qualidade e, por esse motivo, foi desativado de forma permanente.
Recomendamos recriar o modelo de template e utilizar a funcionalidade de Opt- Out para dar a opção ao seus contatos de não receber mais mensagens desse teor caso queira. Clique Aqui você pode saber mais a respeito das regras de envio.
9. The user number is part of an experiment
Esse erro no envio da mensagem ocorre quando o cliente faz parte de um experimento da Meta, lançado em junho, que impede cerca de 1% dos usuários do WhatsApp de receber mensagens de marketing. Nesse caso, a mensagem não será enviada e vocês não serão cobrados.
Nossa recomendação é recriar o template na categoria UTILITY. Se o erro continuar, entre em contato com o lead por outro canal, como ligação, e peça que ele envie uma mensagem para o seu número, o que liberará a conversa.
10. This message was not delivered to maintain healthy ecosystem engagement.
O erro informado está ligado a uma nova regra da Meta, que limita a quantidade de mensagens ou templates de marketing que alguns números podem receber por dia, agora 2 mensagens de marketing em sequência sem receber resposta. Quando esse limite é atingido, as tentativas adicionais falham essa política é interna da Meta e busca evitar que os usuários sejam sobrecarregados com mensagens e para manter o ecossistema de engajamento saudável.
Exemplo:
Envio da mensagem #1 de Marketing às 10h da manhã (abrindo a janela de conversa).
Envio da mensagem #2 de Marketing dentro da mesma janela, às 12h.
Se a pessoa não responder nenhuma das duas mensagens (seja por resposta rápida ou mensagem comum), os próximos disparos não serão entregues até que a janela seja encerrada.
