--- title: "Principais erros de retorno da Meta no WhatsApp API Oficial" description: "Neste artigo, vamos explorar os principais erros de retorno da Meta no WhatsApp API Oficial, com explicações detalhadas sobre o que cada erro significa e como proceder." url: https://ajuda.duotalk.io/pt/articles/151-principais-erros-de-retorno-da-meta-no-whatsapp-api-oficial collection: "Inbox de atendimento" updated: 2026-10-21 language: pt --- # Principais erros de retorno da Meta no WhatsApp API Oficial Neste artigo, vamos explorar os principais erros de retorno da Meta no WhatsApp API Oficial, com explicações detalhadas sobre o que cada erro significa e como proceder. 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](https://ajuda.duotalk.io/pt/articles/126.md) 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: 1. Envio da mensagem #1 de Marketing às 10h da manhã (abrindo a janela de conversa). 2. 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. ### **Como lidar com esse erro?** Não há uma solução imediata, mas sim uma mudança de estratégia: 1. **Não tente reenviar imediatamente:** tentar reenviar a mensagem de marketing logo em seguida geralmente resultará no mesmo erro. 2. **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). 3. **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. 4. **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. 5. **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. ### 11\. Something went wrong 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. > **Success:** [**Clique aqui**](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/) para saber mais sobre os erros que podem ocorrer no WhatsApp API Oficial de acordo com a Meta.