Falhas no envio de Mensagens Ativas 8 de julho de 2025 16:57 Atualizado Índice O que são as falhas no envio? Onde encontro as falhas no envio? O que significam os erros apresentados no relatório? O que são as falhas no envio? São erros informados pela Meta que impediram a entrega de mensagens aos contatos. Onde encontro as falhas no envio? Para acessar o detalhamento, siga os passos abaixo: Como acessar: Acesse o portal; Em seguida, escolha o chatbot; Depois acesse a aba de “Análise”; Dentro de Análise, clique no menu "Mensagens Ativas". No fim do relatório, existe uma seção específica com o detalhamento dos erros, “Falhas no envio”. O que significam os erros apresentados no relatório? Abaixo serão detalhados os possíveis erros: Grupo de Erro Código Mensagem Detalhe Possíveis Soluções Erros de autorização 0 Houve um problema de autenticação. Isso geralmente significa que seu token de acesso expirou ou é inválido. Tente gerar um novo token de acesso. Não foi possível autenticar o usuário do aplicativo. Normalmente, isso significa que o token de acesso incluído expirou, foi invalidado, ou o usuário do aplicativo alterou uma configuração para impedir que todos os aplicativos acessem seus dados. Recomendamos que você obtenha um novo token de acesso. Erros de autorização 3 Sua aplicação não tem permissão para realizar esta ação. Verifique se as permissões necessárias para enviar mensagens via WhatsApp estão ativas para seu aplicativo. Problema de capacidade ou permissões. Use o depurador de token de acesso para verificar se o seu aplicativo recebeu as permissões necessárias pelo endpoint. Saiba como fazer a depuração aqui. Erros de autorização 10 Permissão negada. A permissão para executar esta ação não foi concedida ou foi removida. Verifique as configurações de permissão do seu aplicativo. A permissão não foi concedida ou foi removida. Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões necessárias pelo endpoint. Se necessário, consulte as informações sobre erros de autenticação e autorização aqui. O número de telefone usado para definir a chave pública da empresa deve estar na lista de permissões. Erros de autorização 190 Seu token de acesso expirou. Você precisa gerar um token novo para continuar. Seu token de acesso expirou. Obtenha um novo token de acesso. Erros de autorização 200-299 Erro de Permissão da API. A permissão necessária não foi concedida ou foi revogada. Verifique as permissões do seu aplicativo. A permissão não foi concedida ou foi removida. Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões necessárias pelo endpoint. Se necessário, consulte aqui as informações sobre erros de autenticação e autorização. Erros de integridade 368 Sua conta foi temporariamente bloqueada por violar as políticas do WhatsApp. Verifique as políticas da plataforma para entender o motivo e como resolver. A Conta Comercial do WhatsApp associada ao aplicativo foi restringida ou desativada por violar uma política da plataforma. Consulte o documento de Aplicação de Políticas para saber mais sobre violações de políticas e como resolvê-las. Erros de integridade 130497 Sua conta comercial não tem permissão para enviar mensagens a usuários neste país. Consulte os países permitidos para sua categoria de negócios nas políticas da Meta. A Conta Comercial do WhatsApp está restrita ao envio de mensagens para usuários em determinados países. Confira nas Políticas da Meta aqui os detalhes sobre a permissão e a restrição de envio de mensagens para determinados países em sua categoria de negócios. Erros de integridade 131031 A conta foi bloqueada por violação de política ou falha na verificação de dados (como um PIN de duas etapas incorreto). Verifique as políticas do WhatsApp e o status da sua conta para mais detalhes. A Conta Comercial do WhatsApp associada ao aplicativo foi restringida ou desativada por violar uma política da plataforma, ou não conseguimos verificar os dados incluídos na solicitação com os dados definidos na Conta Comercial do WhatsApp (por exemplo, o PIN de duas etapas incluído na solicitação está incorreto). Consulte o documento de Aplicação de Políticas para saber mais sobre violações de políticas e como resolvê-las. Você também pode conferir aqui o documento sobre o status de integridade de envio de mensagens para informações adicionais sobre o motivo do bloqueio da conta. Outros erros 1 Erro desconhecido. Pode ser um problema temporário no servidor do WhatsApp ou um erro em sua solicitação. Verifique o status da API e confira se sua solicitação está correta. Solicitação inválida ou possível erro do servidor. Confira aqui as informações sobre o status da API. Se não houver interrupções no servidor, verifique a referência do endpoint e verifique se sua solicitação está formatada corretamente e atende a todos os requisitos do endpoint. Outros erros 2 Serviço da API indisponível. O serviço pode estar temporariamente fora do ar ou sobrecarregado. Verifique o status da API e tente novamente mais tarde. Temporário devido a tempo de inatividade ou sobrecarga. Confira aqui as informações sobre o status da API antes de tentar novamente. Outros erros 33 Seu número de telefone comercial foi excluído ou é inválido. Verifique se o número de telefone fornecido está correto. O número de telefone comercial foi excluído. Verifique se o número de telefone comercial está correto. Outros erros 100 Parâmetro inválido. Sua solicitação contém parâmetros (informações enviadas) que não são suportados ou têm erros de digitação. Verifique a documentação para corrigir possíveis erros. A solicitação incluiu um ou mais parâmetros não suportados ou com erros ortográficos. Consulte a referência do endpoint para determinar quais parâmetros são suportados e como são escritos. Ao definir a chave pública da empresa, ela deve seguir as instruções descritas aqui. Verifique se não há incompatibilidade entre o ID do número de telefone que você está registrando e um ID de número de telefone armazenado anteriormente. Verifique se seu parâmetro está de acordo com as restrições de comprimento para o tipo. Outros erros 130472 O número do usuário faz parte de um experimento. A mensagem não foi enviada porque o número de destino está participando de um teste do WhatsApp. A mensagem não foi enviada como parte de um experimento. Consulte Experimento de Mensagem de Marketing. Outros erros 131000 Algo deu errado. A mensagem não pôde ser enviada devido a um erro desconhecido. Tente novamente. Se o erro persistir, entre em contato com o suporte. A mensagem falhou ao ser enviada devido a um erro desconhecido. Ao definir uma chave pública de negócios, houve falha no cálculo da assinatura, na chamada do endpoint do GraphQL ou o endpoint do GraphQL retornou um erro. Tente novamente. Se o erro persistir, abra um ticket aqui. Outros erros 131005 Acesso negado. Sua aplicação não tem permissão para executar esta ação. Verifique as permissões concedidas. A permissão não foi concedida ou foi removida. Use o depurador de token de acesso para verificar se seu aplicativo recebeu as permissões necessárias pelo endpoint. Consulte as informações sobre erros de autenticação e autorização aqui. Outros erros 131008 Parâmetro obrigatório ausente. Sua solicitação não incluiu uma informação necessária para o envio. Verifique a documentação para descobrir o que está faltando. Falta algum parâmetro obrigatório na solicitação. Consulte a referência do endpoint para determinar quais parâmetros são necessários. Outros erros 131009 O valor de um parâmetro é inválido. Uma ou mais informações enviadas em sua solicitação não são válidas. Verifique a documentação para obter os valores corretos. Um ou mais valores de parâmetro são inválidos. Consulte a referência do endpoint para determinar quais valores são suportados para cada parâmetro e consulte Números de Telefone para saber como adicionar um número de telefone a uma Conta Comercial do WhatsApp. Outros erros 131016 Serviço indisponível. Um serviço do WhatsApp está temporariamente indisponível. Verifique o status da API e tente novamente mais tarde. Um serviço está temporariamente indisponível. Confira aqui as informações sobre o status da AP antes de tentar novamente. Outros erros 131021 O destinatário não pode ser o remetente. Você está tentando enviar uma mensagem para o mesmo número que a está enviando. Altere o número do destinatário. O número de telefone do remetente e do destinatário é o mesmo. Envie uma mensagem para um número de telefone diferente do remetente. Outros erros 131026 A mensagem não pôde ser entregue. Isso pode acontecer porque o número do destinatário não é um número do WhatsApp, ele não aceitou os novos termos de serviço ou está usando uma versão desatualizada do aplicativo. Peça ao usuário para verificar esses pontos. Não foi possível entregar a mensagem. Os motivos podem incluir:* 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; deve usar a seguinte versão do WhatsApp ou superior: + 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 Usando um método de comunicação que não seja o WhatsApp, peça ao usuário do WhatsApp para:* Confirmar que ele pode realmente enviar uma mensagem para o número de telefone da sua empresa no WhatsApp. * Confirmar que aceitou nossos Termos de Serviço mais recentes (Configurações > Ajuda ou Configurações > Informações do aplicativo solicitará que aceite os termos/políticas mais recentes, se ainda não o tiver feito) * Atualizar para a versão mais recente do cliente WhatsApp. Outros erros 131037 O nome de exibição do seu número de teste (começando com 555) precisa ser aprovado antes que você possa enviar mensagens. Altere o nome de exibição para um aprovado. O número de telefone comercial 555 usado para enviar a solicitação não tem um nome de exibição aprovado. Altere o nome de exibição do número de telefone comercial 555. Consulte nosso artigo da Central de Ajuda (aqui) para saber como fazer a alteração. Outros erros 131042 Problema de pagamento. Ocorreu um erro com seu método de pagamento. Verifique se sua conta de pagamento está configurada corretamente, ativa e sem problemas pendentes. Houve um erro relacionado ao seu método de pagamento. Confira as informações sobre cobrança aqui e verifique se você fez as configurações corretamente. Problemas comuns:* A conta de pagamento não está anexada a uma Conta Comercial do WhatsApp * A linha de crédito está acima do limite * A linha de crédito (Conta de Pagamento) não está definida ou ativa * A Conta Comercial do WhatsApp foi excluída * A Conta Comercial do WhatsApp está suspensa * Fuso horário não definido * Moeda não definida * A solicitação de Mensagens (Em nome de) está pendente ou foi recusada * Excedeu o limite do nível gratuito de conversas sem um método de pagamento válido Outros erros 131045 Certificado incorreto. Ocorreu uma falha de envio da mensagem devido a um erro de registro de número de telefone. Tente registrar o número novamente. Houve falha no envio da mensagem devido a um erro de registro de número de telefone. Acesse as informações de registro aqui antes de tentar novamente. Outros erros 131047 Mensagem de reengajamento. Passaram-se mais de 24 horas desde a última resposta do cliente. Para iniciar uma nova conversa, você deve usar um modelo de mensagem. Passaram-se mais de 24 horas desde que o destinatário respondeu pela última vez ao número do remetente. Envie ao destinatário uma mensagem iniciada pela empresa usando um modelo de mensagem. Outros erros 131049 A Meta (empresa controladora do WhatsApp) optou por não entregar esta mensagem para manter a qualidade do serviço. Não tente novamente imediatamente A Meta entende que essa mensagem não promove um um envolvimento saudável no ecossistema. Por esse motivo ela não foi entregue. Não tente novamente imediatamente se receber este código de erro. Em vez disso, tente aguardar intervalos de tempo cada vez maiores para enviar a mensagem novamente, até que seja entregue. O limite pode estar em vigor por períodos de tempo diferentes. Consulte mais informações sobre limites de modelo de mensagens aqui. Outros erros 131050 O usuário parou de receber mensagens de marketing. O destinatário optou por não receber mais mensagens de marketing da sua empresa. Não envie novas mensagens para este usuário. Não foi possível entregar a mensagem. Este destinatário optou por parar de receber mensagens de marketing no WhatsApp da sua empresa. Não tente enviar mensagens para este usuário novamente. Para receber notificações sempre que um usuário do WhatsApp solicitar a pausa ou retomada da entrega de mensagens de modelo de marketing da sua empresa, inscreva-se no webhook user_preferences. Outros erros 131051 Tipo de mensagem não suportado. O tipo de mensagem que você está tentando enviar (por exemplo, texto, imagem, áudio) não é suportado. Verifique os tipos de mensagem permitidos. Tipo de mensagem não suportado. Confira em Mensagens os tipos de mensagem suportados. Depois disso, tente novamente usando um tipo de mensagem suportado. Outros erros 131052 Erro no download da mídia. Não foi possível baixar o arquivo de mídia enviado pelo usuário. Peça ao usuário para enviar o arquivo por outro meio. Não foi possível baixar a mídia enviada pelo usuário. Não foi possível baixar a mídia incluída na mensagem do usuário do WhatsApp. Para mais informações, consulte o valor `error.error_data.details` em quaisquer webhooks de **mensagens** acionados quando esta mensagem foi recebida. Peça ao usuário do WhatsApp para enviar o arquivo de mídia usando um método que não seja o WhatsApp. Outros erros 131053 Erro no upload da mídia. Não foi possível fazer o upload do arquivo de mídia. Verifique se o formato do arquivo (por exemplo, JPG, PNG, MP4) é suportado. Não foi possível fazer o upload da mídia usada na mensagem. Não foi possível fazer o upload da mídia por um ou mais motivos, como um tipo de mídia não suportado. Para mais informações, consulte o valor `error.error_data.details` em quaisquer webhooks de **mensagens** acionados quando esta mensagem falha ao ser enviada. Recomendamos que você verifique os arquivos de mídia que estão causando erros e confirme se eles são de fato suportados. No UNIX, por exemplo, você pode usar a linha de comando `file -I rejected-file.mov` para determinar o tipo MIME. Você pode então confirmar se o tipo MIME é suportado. Consulte a documentação sobre a WhatsApp Cloud API aqui. Outros erros 131057 Conta em modo de manutenção. Sua conta do WhatsApp Business está em manutenção, como uma atualização de capacidade de produtividade. Tente novamente mais tarde. A Conta Comercial está em modo de manutenção A Conta Comercial do WhatsApp está em modo de manutenção. Um motivo para isso pode ser que a conta esteja passando por uma atualização de taxa de transferência de dados. Outros erros 132000 Incompatibilidade na contagem de parâmetros do modelo. O número de variáveis em seu modelo de mensagem não corresponde ao que foi enviado. Você deve preencher todos os campos variáveis do seu modelo. O número de valores de parâmetros variáveis incluídos na solicitação não correspondeu ao número de parâmetros variáveis definidos no modelo. Confira as Diretrizes para modelos de mensagens aqui e garanta que a solicitação inclua todos os valores de parâmetros variáveis que foram definidos no modelo. Outros erros 132001 O modelo não existe. Verifique se o nome do modelo e o idioma estão corretos e se ele foi aprovado pelo WhatsApp. O modelo não existe no idioma especificado ou o modelo não foi aprovado. Verifique se o modelo foi aprovado e se o nome do modelo e a localidade do idioma estão corretos. Você deve seguir as diretrizes de modelo de mensagem. Outros erros 132005 Texto hidratado do modelo muito longo. O texto traduzido do seu modelo de mensagem é muito longo. Verifique as traduções do seu modelo no Gerenciador do WhatsApp. O texto traduzido é muito longo. Confira o Gerenciador do WhatsApp para verificar se seu modelo foi traduzido. Você deve seguir as diretrizes de modelo de mensagem aqui. Outros erros 132007 O conteúdo do seu modelo de mensagem viola uma política do WhatsApp. Confira as diretrizes para entender o motivo da violação. O conteúdo do modelo viola uma política do WhatsApp. Consulte as diretrizes de modelo de mensagem aqui para determinar os possíveis motivos da violação. Outros erros 132012 Incompatibilidade de formato de parâmetro do modelo. O formato das variáveis em seu modelo de mensagem está incorreto. Verifique se o formato das informações que você está enviando corresponde ao que foi definido no modelo. Valores de parâmetros variáveis formatados incorretamente. Os valores dos parâmetros variáveis incluídos na solicitação não estão usando o formato especificado no modelo. Confira as diretrizes de modelo de mensagem aqui. Outros erros 132015 O modelo está pausado devido à baixa qualidade e não pode ser enviado. Edite o modelo para melhorar sua qualidade e tente novamente após a aprovação. O modelo está pausado devido à [baixa qualidade](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating), por isso não pode ser enviado em uma mensagem de modelo. [Edite o modelo] Siga as orientações para melhorar a qualidade do modelo e tente novamente assim que for aprovado. Outros erros 132016 O modelo foi permanentemente desativado depois de ter sido pausado muitas vezes por baixa qualidade. Crie um novo modelo com conteúdo diferente. O modelo foi pausado muitas vezes devido à [baixa qualidade](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines#quality-rating) e agora está permanentemente desativado. Crie um novo modelo com conteúdo diferente. Outros erros 132068 O fluxo está bloqueado. Corrija o fluxo para continuar. O fluxo está em estado de bloqueio. Corrija o Fluxo Outros erros 132069 O fluxo está limitado. Já foram enviadas 10 mensagens usando este fluxo na última hora. Corrija o fluxo. O fluxo está em estado de limitação e 10 mensagens usando este fluxo já foram enviadas na última hora. Corrija o Fluxo Outros erros 133000 Cancelamento de registro incompleto. Uma tentativa anterior de cancelar o registro do número falhou. Tente cancelar o registro novamente antes de registrar. Uma tentativa anterior de cancelamento de registro falhou. Siga os passos a seguir antes de registrar: Link 01 Link 02 Outros erros 133004 Servidor temporariamente indisponível. Verifique a página de status da API do WhatsApp e tente novamente. O servidor está temporariamente indisponível. Consulte as informações na página de status da WhatsApp Business API aqui e verifique o valor `details` da resposta antes de tentar novamente. Outros erros 133005 O PIN da verificação em duas etapas está incorreto. Verifique se o PIN está correto ou redefina-o. PIN de verificação em duas etapas incorreto. Confira se o PIN de verificação em duas etapas incluído na solicitação está correto. Para redefinir o PIN de verificação em duas etapas: 1. Segue esses passos descritos aqui e aqui. 2. Envie uma solicitação POST que inclua o novo PIN para o endpoint [Número de Telefone]. Detalhes aqui. Outros erros 133006 Necessária nova verificação do número de telefone. Verifique o número de telefone antes de tentar registrá-lo. O número de telefone precisa ser verificado antes do registro. Verifique o número de telefone antes de registrá-lo. Outros erros 133008 Muitas tentativas de adivinhar o PIN da verificação em duas etapas. Aguarde o tempo especificado e tente novamente. Muitas tentativas de adivinhar o PIN de verificação em duas etapas para este número de telefone. Tente novamente após o tempo especificado no valor da resposta `details`. Outros erros 133009 O PIN da verificação em duas etapas foi adivinhado muito rápido. Verifique a resposta para saber quando pode tentar novamente. O PIN da verificação em duas etapas foi inserido muito rapidamente. Verifique o valor da resposta `details` antes de tentar novamente. Outros erros 133010 O número de telefone não está registrado. Registre o número de telefone na Plataforma do WhatsApp Business antes de tentar novamente. Número de telefone não registrado na Plataforma do WhatsApp Business. Verifique os links a seguir, antes de tentar novamente: Link 01 Link 02. Outros erros 133015 Aguarde alguns minutos antes de registrar este número. O número foi excluído recentemente e o processo não foi concluído. Aguarde 5 minutos e tente novamente. O número de telefone que você está tentando registrar foi excluído recentemente e a exclusão ainda não foi concluída. Aguarde 5 minutos antes de tentar novamente a solicitação. Outros erros 135000 Erro genérico do usuário. Houve uma falha de envio da mensagem devido a um erro desconhecido nos parâmetros da sua solicitação. Verifique a sintaxe da sua solicitação ou entre em contato com o suporte. Houve uma falha de envio da mensagem devido a um erro desconhecido com os parâmetros da sua solicitação. Consulte a referência do endpoint para determinar se você está consultando o endpoint usando a sintaxe correta. Entre em contato com o suporte ao cliente se continuar recebendo este código de erro em resposta. Erros de sincronização 2593107 Limite de solicitações de sincronização excedido. Você só pode sincronizar contatos e histórico de mensagens uma vez. Desfaça a integração e, em seguida, refaça a integração do cliente para tentar novamente. Você excedeu o número máximo de vezes para chamar a API de sincronização para este número de telefone. Você só pode chamar este endpoint uma vez para sincronizar os contatos do número de telefone comercial e uma vez para sincronizar seu histórico de mensagens. Consulte Integração de usuários de aplicativos de negócios. Desintegre o cliente comercial e reintegre-o. Erros de sincronização 2593108 Solicitação de sincronização feita fora da janela de tempo permitida. A sincronização só pode ser feita dentro de 24 horas após a integração do usuário. Desfaça a integração e depois refaça a integração do usuário para tentar novamente. A solicitação de sincronização só pode ser feita dentro de 24 horas após a integração Você só pode iniciar a sincronização de contatos e histórico de mensagens de um usuário de aplicativo do WhatsApp Business integrado dentro de 24 horas após a integração do usuário. Consulte Integração de usuários de aplicativos de negócios. Desfaça a integração do usuário e depois refaça a integração. Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃 Artigos relacionados Mensagens Ativas - Códigos de erro Envio de Mensagens Ativas do WhatsApp no Blip Desk Como funciona o redirecionamento entre subbots? Configurando o atendimento via chat no Salesforce Monitore a Saúde do seu Número WABA