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.
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.
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.
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
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.
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.
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.).
O modelo foi pausado devido à baixa qualidade e não pode ser enviado em mensagens, recomendamos nesse caso excluir o template e recria-lo.
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.
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.
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.
Não tente reenviar imediatamente: tentar reenviar a mensagem de marketing logo em seguida geralmente resultará no mesmo erro.
Aguarde e tente novamente: a restrição é temporária. Tente reenviar a mensagem após um período de tempo maior (horas ou até o dia seguinte).
Priorize mensagens de utilidade: se a comunicação for urgente e não estritamente promocional (como atualizações de pedidos, lembretes de agendamento, etc.), use templates de utilidade, pois eles não são afetados por esse limite.
Incentive a resposta: quando um usuário responde a uma mensagem de marketing, isso abre uma janela de 24 horas de conversação, permitindo o envio de mais mensagens (incluindo mais um template de marketing) dentro dessa janela. Incentive a interação.
Revise a estratégia de frequência:
Personalize mais as mensagens;
Envie conteúdo de valor e relevante;
Segmente melhor seu público para enviar marketing apenas para quem tem maior probabilidade de engajar.
Esse retorno específico é classificado pela Meta como uma falha genérica no envio da mensagem, geralmente relacionada a um erro desconhecido no momento da tentativa de envio. Nesse caso, a Meta não traz um motivo técnico claro, e por isso pode gerar dúvidas. Em alguns casos, ele pode estar ligado a instabilidades temporárias da própria Meta, ao histórico de conversas do contato ou até ao estado da sessão ativa no WhatsApp. Recomendamos atualizar a página e tentar o envio novamente.
