Códigos de erros da Meta
Erro 131049 - Envio de Template Messenger de Marketing
A mensagem que aparece é a seguinte:
Meta recusou enviar esse modelo (Marketing) para manter o engajamento saudável do ecossistema.
Tente novamente mais tarde ou utilize um modelo do tipo Utilidade.
Para saber mais acesse esse link: https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates#user-marketing-template-message-limits
Ao receber este código de erro, não tente enviar a mensagem novamente. Esse problema está relacionado ao limite de mensagens de marketing que o destinatário recebeu. Tente enviar uma mensagem do tipo utilidade ou espere um tempo maior para enviar mensagens novamente, já que o limite talvez esteja em vigor por diferentes períodos.
Porque esse erro ocorre:
Esse erro ocorre quando você tenta enviar um modelo de mensagem para iniciar ou reiniciar um atendimento. Vale ressaltar que isso não é um erro da plataforma, mas sim uma ação da Meta, sobre a qual não temos controle.
Em alguns casos, a Meta decide que um número de telefone já recebeu muitas mensagens de marketing e, como medida para manter um ambiente saudável para os usuários do WhatsApp, ela interrompe temporariamente o envio de novas mensagens de marketing para esse número.
Infelizmente, não podemos evitar essa ação da Meta, mas ela é aplicada com o objetivo de preservar uma boa experiência para os usuários do WhatsApp.
Veja algumas soluções para esse erro:
Embora o bloqueio temporário de mensagens de marketing pela Meta seja uma medida que não podemos controlar diretamente, há algumas estratégias que você pode adotar para minimizar o impacto e garantir que a comunicação com seus clientes continue fluindo de forma eficiente:
Varie os tipos de mensagem: Ao invés de enviar apenas mensagens de marketing, utilize outro tipo de mensagens, como de Utilidade.
Ajuste o volume de envio: Evite o envio excessivo de mensagens do tipo marketing em um curto período de tempo para o mesmo número. Isso ajuda a reduzir a chance de a Meta bloquear os envios futuros.
Aguarde o desbloqueio: Se um número for bloqueado, aguarde o período determinado pela Meta (geralmente de algumas horas a dias) para que o envio de mensagens seja liberado novamente.
Erro 131056 - Limite de volume de envios de mensagens atingido
A mensagem que aparece é a seguinte:
Foram enviadas muitas mensagens do número de telefone do remetente para o mesmo número de telefone do destinatário em um curto período.
Porque esse erro ocorre:
O erro de envio de mensagens acontece principalmente quando muitas mensagens são enviadas para o mesmo contato em um curto período de tempo.
A plataforma está funcionando corretamente, mas a Meta (responsável pelo WhatsApp) pode bloquear temporariamente o envio de mensagens de marketing se identificar que um número está recebendo um volume excessivo de mensagens em pouco tempo.
Isso ocorre porque a Meta tem o objetivo de evitar que os usuários do WhatsApp recebam muitas mensagens de marketing de forma indiscriminada, o que pode prejudicar a experiência deles na plataforma. Quando um número de telefone recebe muitas mensagens desse tipo, a Meta decide pausar o envio de novas mensagens para aquele número por um tempo, para manter um ambiente mais saudável para todos os usuários.
Veja algumas soluções para esse erro:
Reduza a quantidade de mensagens enviadas para cada contato: Evite enviar muitas mensagens de marketing para o mesmo número em um curto período de tempo. Dê intervalos entre os envios e tente não enviar uma quantidade excessiva de mensagens de uma só vez. Isso ajuda a evitar que a Meta bloqueie temporariamente o envio.
Varie os tipos de mensagens enviadas: Em vez de enviar apenas mensagens de marketing, alterne para outros tipos de mensagens, como mensagens do tipo utilidade. A Meta tem regras mais flexíveis para esses tipos de comunicação e elas não costumam ser bloqueadas com a mesma frequência.
Monitore a entrega das mensagens: Acompanhe o status de entrega das suas mensagens na plataforma. Se você perceber que está ocorrendo o bloqueio de envios, tente reduzir o volume de mensagens e aguarde o período de desbloqueio automático da Meta.
Erro 130472 - Experimento da Meta
Se você tentou enviar uma mensagem e recebeu o erro 130472, não se preocupe: isso não significa que sua conta foi bloqueada ou que há um erro na sua configuração.
A mensagem que aparece é a seguinte:
O número do usuário faz parte de um experimento do WhatsApp, não é possível iniciar esta conversa. Escolha uma das opções abaixo.
🔎 Por que esse erro ocorre?
Este erro ocorre porque a Meta (Facebook) selecionou aleatoriamente cerca de 1% dos números de telefone conectados à WhatsApp Cloud API globalmente para participarem de um experimento controlado.
O objetivo do teste é avaliar o impacto do recebimento de mensagens de marketing na experiência do usuário final.
O que isso significa na prática? Para os números selecionados neste teste, o envio de modelos de mensagem da categoria Marketing pode ser bloqueado ou limitado temporariamente, mesmo que sua conta (WABA) esteja:
✅ Corretamente configurada;
✅ Com saldo disponível;
✅ Com templates aprovados;
✅ Sem nenhuma infração às políticas da Meta.
ℹ️ Pontos Importantes:
Não é um erro da plataforma ou do BSP: O bloqueio vem direto da API da Meta.
Não é punição: Não está relacionado à qualidade do seu número ou denúncias.
Não há "Opt-out": Como é um teste aleatório e automático, não é possível solicitar a remoção manual do número deste grupo de experimento
⏳ O que a Meta está testando?
A Meta utiliza esses experimentos para calibrar seus algoritmos e políticas. Eles estão medindo:
O impacto na satisfação do usuário ao receber menos marketing.
Taxas de entrega, leitura, bloqueio e denúncia.
Ajustes nos limites de mensagens de marketing.
Nota: Esses testes são temporários, mas não possuem um prazo público definido para encerramento.
💡 Soluções e Alternativas
Se você precisa falar com um contato que caiu neste experimento, existem formas legítimas de contornar a restrição de marketing:
1. Utilize Modelos de "Utilidade" O bloqueio é focado em Marketing. Tente iniciar a conversa utilizando um Modelo de Mensagem da categoria Utilidade (ex: confirmação de pedido, envio de boleto, aviso de agendamento). Esses modelos geralmente são entregues independentemente do experimento.
2. Aguarde o usuário iniciar o contato (Janela de 24h) A restrição se aplica ao envio ativo da empresa (Business-Initiated). Se o cliente enviar uma mensagem para você primeiro, uma janela de serviço de 24h se abre. Dentro desse período, você pode responder e conversar livremente, sem as restrições do experimento.
3. Use canais alternativos para "desbloquear" o WhatsApp Se o assunto for urgente, entre em contato por outro meio (Ligação, SMS ou E-mail) e peça para o cliente mandar um "Oi" no WhatsApp. Isso abrirá a janela de conversação e permitirá que você prossiga o atendimento pela plataforma.
Erro 130497 - Conta Comercial Impedida de Enviar Mensagens
O erro 130497 indica que a conta do WhatsApp Business está sofrendo uma restrição geográfica. Esse bloqueio ocorre quando a Meta não consegue validar a localização da empresa, geralmente devido a um perfil incompleto ou configurado incorretamente no Meta Business Manager.
Por que isso acontece?
Diferente do que se imagina, a Meta não identifica o país de origem automaticamente apenas pelo prefixo do número de telefone (ex: +55).
Se o campo "País" estiver em branco no cadastro da Business Manager, o sistema aplica restrições de cross-country messaging (mensagens entre países), o que impede o envio de mensagens mesmo em fluxos nacionais (de Brasil para Brasil).
🛠️ Como Resolver
Siga o passo a passo abaixo para regularizar o cadastro da empresa junto à Meta:
Acesse o Business Manager da Meta;
Navegue até Configurações do negócio > Informações da empresa;
Localize o campo País e verifique se ele está preenchido corretamente (ex: Brasil);
Caso esteja vazio ou incorreto, clique em editar, selecione o país correto e salve as alterações;
Aguarde o período de propagação da configuração pela Meta.
Resultado esperado
Após a atualização e propagação dos dados no perfil da Business Manager, o envio de mensagens tende a ser normalizado automaticamente.
Erro 131042 - META
A mensagem que aparece é a seguinte:
A Meta recusou enviar sua mensagem, isso está relacionado à tentativa de faturar conversas no cartão de crédito.
Saiba como adicionar um cartão de crédito neste link: https://web.facebook.com/business/help/488291839463771?_rdc=1&_rdr#
Porque esse erro ocorre:
O Erro 131042 ocorre quando a Meta enfrenta dificuldades para processar o pagamento por meio do cartão cadastrado na conta do portfólio empresarial. Esse problema geralmente está relacionado a um bug interno no sistema da Meta, que impede a realização do débito mesmo quando o cartão está válido e funcional.
Veja como solucionar esse erro:
Confirme os dados do cartão:
Verifique se as informações do cartão cadastradas na Business Manager estão corretas.
Certifique-se de que o cartão possui saldo suficiente para cobrir o débito.
No Gerenciador de Negócios, siga estas etapas para resolver falhas de pagamento:
Acesse Contas > Contas do WhatsApp > Configurações de pagamento.
Verifique o saldo disponível. Por exemplo, se houver um saldo de 8 dólares, tente realizar o pagamento desse valor.
Caso o pagamento do valor total não seja concluído devido a uma falha, ajuste o valor manualmente:
Edite o campo de pagamento e insira um valor menor, como 7 dólares.
Realize o pagamento com o valor reduzido. Assim que a transação for reconhecida, a Meta liberará o envio de mensagens normalmente.
Atualize o método de pagamento:
No Gerenciador de Negócios, acesse Contas > Contas do WhatsApp > Configurações de pagamento.
Na página Configurações de pagamento, clique em Adicionar forma de pagamento.
Siga as instruções para adicionar as informações de pagamento e clique em Avançar.
Adicione as informações do cartão e clique em Salvar.
Erro 131026 - Número não registrado no Whats
A mensagem que aparece é a seguinte:
Não foi possível entregar a mensagem. O número de telefone do destinatário não está registrado no WhatsApp ou o destinatário não aceitou os novos Termos de Serviço e a nova Política de Privacidade.
Porque esse erro ocorre:
O Erro 131026 ocorre quando uma tentativa de enviar uma mensagem para um número de WhatsApp falha porque o número informado não está registrado no WhatsApp. Isso significa que o destinatário não tem uma conta ativa vinculada ao número fornecido.
As causas mais comuns são:
Número sem conta no WhatsApp: O número não está associado a nenhuma conta ativa no WhatsApp.
Mudança de número pelo usuário: O destinatário pode ter alterado o número registrado no WhatsApp e não atualizou a informação com sua empresa.
Erro ao digitar o número: O número foi inserido incorretamente, com dígitos a mais, a menos ou no formato errado.
Desativação da conta pelo usuário: O destinatário pode ter desativado a conta temporária ou permanentemente.
Veja algumas soluções para esse erro:
Verifique o número informado:
Tente realizar uma chamada para o número no WhatsApp, seja pelo aplicativo ou utilizando o link wa.me/[número], para confirmar se o número está registrado no WhatsApp.
Certifique-se de que o número está correto e no formato internacional, incluindo o código do país (ex.: +55 para Brasil).
Verifique se o número foi editado, ex: inserir o 9.
Confirme com o cliente se o número registrado é o mesmo utilizado no WhatsApp.
Se o problema persistir, você pode realizar um segundo passo para verificar se a falha está relacionada ao Template de Mensagem (TM) ou ao número:
Envie a mesma TM para outro número ativo no WhatsApp:
Escolha um número que você sabe que está registrado no WhatsApp.
Envie a mesma mensagem (TM).
Se a mensagem for enviada com sucesso: O problema está no número original (não registrado no WhatsApp).
Se a mensagem não for enviada: O problema pode estar na TM (modelo de mensagem) ou na configuração da conta. Tente enviar outro TM (modelo de mensagem).
Erro 131000 - Erro desconhecido
A mensagem que aparece é a seguinte:
Falha ao enviar a mensagem devido a um erro desconhecido.
Por que esse erro acontece?
O Erro 131000 ocorre quando há um problema técnico ao tentar enviar uma mensagem pelo WhatsApp através da API da Meta. Geralmente, este erro está relacionado a configurações incorretas, falhas de comunicação entre a plataforma da Meta e o serviço utilizado, ou até mesmo instabilidades nos servidores da Meta.
Veja algumas soluções para esse erro:
Verifique se há relatos de instabilidade ou manutenção no status da API da Meta
Verifique a conexão com a sua internet.
Tente enviar outra mensagem.
Observação: Caso esse erro ocorra logo após a conexão do número na API Oficial, exclua todas as informações relacionadas no portfólio empresarial e conecte o número novamente.
Erro 135000 - Falha ao enviar mensagem
A mensagem que aparece é a seguinte:
Falha ao enviar a mensagem devido a um erro desconhecido com seus parâmetros de solicitação.
Por que esse erro acontece?
O erro 135000 ocorre quando o atendente tenta enviar um modelo de mensagem em um atendimento, mas, por algum motivo, o envio falha. Isso pode estar relacionado a problemas de configuração ou validação do modelo pela Meta.
Veja como solucionar esse erro:
Uma alternativa é solicitar a um usuário com permissão de super administrador que sincronize os modelos de mensagem com a Meta.
Siga os passos abaixo para corrigir esse erro:
Acesse os Modelos de Mensagem:
Localize o modelo de mensagem que você está tentando enviar no painel de "Modelos de Mensagem de Atendimento".
Duplique o modelo de mensagem:
Crie uma cópia do modelo que apresentou o erro, mantendo o mesmo conteúdo ou realizando ajustes, se necessário.
Aguarde a aprovação da Meta:
Após duplicar o modelo, envie-o para aprovação e aguarde até que a Meta libere o novo modelo.
Teste o envio novamente:
Use o modelo duplicado para tentar enviar a mensagem.
Prevenção de problemas futuros:
Se o modelo duplicado funcionar corretamente, repita o processo de duplicação para os outros modelos que possam apresentar problemas no futuro. Isso ajuda a manter a comunicação fluida e evitar interrupções.
Erro 131047 - Mais de 24 h sem contato
A mensagem que aparece é a seguinte:
Mais de 24 horas se passaram desde que o destinatário respondeu pela última vez ao número do remetente. Envie uma mensagem iniciada pela empresa usando um modelo de mensagem.
Por que esse erro acontece?
O erro 131047 ocorre porque as políticas do WhatsApp limitam o tempo em que uma empresa pode responder a uma mensagem de um cliente. Após 24 horas desde a última interação do cliente, o WhatsApp bloqueia o envio de mensagens que não sejam iniciadas pela empresa utilizando um modelo de mensagem aprovado.
Essa regra visa manter o ambiente de mensagens respeitoso, evitando interações não desejadas pelos usuários.
Veja como solucionar esse erro:
Envie um modelo de mensagem aprovado para retomar o atendimento.
Observação: Se o número do contato for editado durante uma conversa, esse erro poderá ocorrer. Por exemplo, caso o contato solicite a troca do número ou haja a necessidade de adicionar o nono dígito, e o usuário edite os dados enquanto a conversa está ativa, isso pode causar o erro
Erro 131048 - Parâmetro ausente ou inválido
A mensagem que aparece é a seguinte:
Falha ao enviar a mensagem devido a um limite de envios que poder ser feitos deste número de telefone.
Por que esse erro acontece?
O erro Meta 131048 ocorre quando há um parâmetro ausente ou inválido na sua mensagem, ou quando você atingiu um limite de envio devido a uma baixa qualidade de mensagens, com potencial atividade de spam, ou limite de taxa de envio. Para resolver, você deve verificar se todos os dados necessários estão presentes e corretos, e reduzir a frequência de envio e o conteúdo repetitivo.
Causas Comuns
Parâmetro Ausente ou Inválido:A mensagem que você está tentando enviar não inclui todas as informações necessárias ou contém dados incorretos.
Limite de Qualidade/Spam Atingido:O WhatsApp pode restringir o envio se sua conta tiver uma baixa classificação de qualidade devido a clientes que bloqueiam ou relatam suas mensagens como spam, ou se o número de mensagens enviadas exceder o limite diário.
Veja como solucionar esse erro:
Confirme se todos os dados exigidos estão presentes e no formato correto.
Se o erro for por excesso de mensagens, diminua a quantidade de mensagens enviadas de um determinado número.
No WhatsApp Manager, verifique o status da qualidade da sua conta para garantir que as mensagens não estão sendo frequentemente bloqueadas ou marcadas como spam.
Tente não enviar mensagens idênticas e repetitivas, pois isso pode ser interpretado como spam.
Erro 132001 - Modelo não existe
A mensagem que aparece é a seguinte:
O modelo não existe no idioma especificado ou não foi aprovado.
Por que esse erro acontece?
O erro 13201 ocorre quando você tenta enviar um modelo de mensagem que não está registrado ou não é reconhecido pela API do WhatsApp. Isso pode acontecer pelos seguintes motivos:
O modelo de mensagem foi excluído no Gerenciador de Negócios do WhatsApp.
O nome do modelo foi digitado incorretamente.
O modelo ainda está em processo de aprovação pela Meta e, portanto, não está disponível para uso.
O modelo foi rejeitado pela Meta e, por isso, não pode ser usado.
Veja como solucionar esse erro:
Uma alternativa é solicitar a um usuário com permissão de super administrador que sincronize os modelos de mensagem com a Meta.
Crie um novo modelo de mensagem e aguarde a aprovação de Meta.
Reenvie para aprovação caso esteja reprovado ou em análise.
Siga as diretrizes para modelos de mensagem.
Erro 131031 - Conta restrita ou bloqueada
A mensagem que aparece é a seguinte:
A conta do WhatsApp Business associada ao app foi restringida ou desabilitada por violar uma política da plataforma.
Por que esse erro acontece?
O erro 131031 ocorre quando a conta do WhatsApp Business está restrita ou bloqueada pela Meta. Isso geralmente indica que a conta violou alguma política ou regra de uso do WhatsApp Business. Entre as causas mais comuns, estão:
Violações das políticas da Meta: envio de mensagens não autorizadas ou inadequadas.
Reclamações de usuários: um alto número de bloqueios ou denúncias de spam por parte dos destinatários.
Atividades suspeitas: uso inadequado da API, como envio de mensagens em massa ou automatizações excessivas.
Veja como solucionar esse erro:
Acesse o portfólio empresarial e verifique, no menu 'Página Inicial do Suporte', se há alguma mensagem da Meta.
Como chegar lá:
Faça login na sua conta da Business Manager.
No menu lateral, clique em ''
", em seguida clique em 'Página Inicial do Suporte para empresas.Verifique se há notificações ou mensagens relevantes da Meta relacionadas ao erro.
Revise as políticas de uso:
Certifique-se de que a conta está cumprindo as Políticas Comerciais e as Políticas de Mensagens da Meta.
Evite enviar mensagens não solicitadas ou que possam ser percebidas como spam pelos destinatários.
Responda às notificações da Meta:
Se houver uma notificação ou solicitação de ação no Gerenciador de Negócios, siga as instruções fornecidas.
Muitas vezes, a Meta solicita informações adicionais ou ajustes nas práticas de envio para reativar a conta.
Corrija possíveis práticas inadequadas:
Reduza o envio de mensagens para listas extensas de contatos que não interagiram recentemente com sua empresa.
Priorize mensagens relevantes e alinhadas às necessidades dos clientes.
Certifique-se de que o opt-in (consentimento do cliente para receber mensagens) esteja documentado.
Erro 100 - Mensagem não suportada
A mensagem que aparece é a seguinte:
Solicitação POST não suportada. O objeto com o ID 'messages' não existe, não pode ser carregado devido a permissões ausentes, ou não suporta esta operação. Por favor, leia a documentação da Graph API em https://developers.facebook.com/docs/graph-api.
Por que esse erro acontece?
Parâmetros Inválidos ou Ausentes: O erro pode ser desencadeado por parâmetros incorretos ou faltantes na requisição. Por exemplo, tentar acessar um recurso com um ID inválido ou sem fornecer todos os parâmetros obrigatórios. Desenvolvedores do Facebook
Recurso Inexistente ou Inacessível: Tentar acessar um recurso que não existe ou ao qual o aplicativo não tem permissão pode resultar nesse erro.
Permissões Insuficientes: O aplicativo pode não ter as permissões necessárias para executar a ação desejada, como enviar mensagens para determinados usuários.
Problemas com URLs: Ao enviar mensagens que incluem links, URLs malformadas ou que não atendem aos requisitos da Meta podem causar o erro.
Veja como solucionar esse erro:
Verifique os Parâmetros da Requisição: Assegure-se de que todos os parâmetros exigidos estão presentes e corretamente formatados.
Confirme as Permissões do Aplicativo: Garanta que o aplicativo possui todas as permissões necessárias para realizar a ação desejada. Pode ser feito o processo de dar permissão.
Valide os Recursos: Certifique-se de que os recursos que está tentando acessar existem e estão acessíveis ao aplicativo.
Teste as URLs: Se estiver enviando mensagens com links, utilize ferramentas como o Facebook Sharing Debugger para validar as URLs.
Mensagem “Mensagem não suportada pela API” O que significa e como agir - Erro 131051
Ao visualizar uma conversa na plataforma, você pode encontrar o aviso:
"Mensagem não suportada pela API"
Essa mensagem aparece quando o contato envia um tipo de conteúdo que não é compatível com a API oficial da Meta (usada na integração do WhatsApp, Instagram ou Messenger). Ou seja, a plataforma não consegue exibir ou processar esse conteúdo porque a Meta não disponibiliza suporte para esse formato via API.
Alguns exemplos comuns de conteúdos que podem gerar essa mensagem:
Em quais casos essa mensagem pode aparecer?
Ao visualizar uma conversa na plataforma, você pode encontrar o aviso:
Esse comportamento é esperado e controlado pela Meta, e não pode ser corrigido ou alterado pela equipe da plataforma.
Mesmo que a mensagem apareça como “não suportada”, a conversa não é perdida — o restante do conteúdo trocado permanece normalmente acessível.
Esse tipo de limitação pode variar de acordo com atualizações da API oficial. A equipe da plataforma acompanha constantemente essas mudanças para garantir compatibilidade com os tipos de mensagens permitidos.
Considerações finais
Informe ao cliente que o conteúdo enviado não é compatível com a integração oficial.
Peça que ele reenvie a mensagem em outro formato, como texto, imagem ou documento padrão.
Não se trata de um erro da plataforma, e sim de uma limitação da API oficial da Meta.
Se o contato estiver tentando enviar algo com frequência que resulte nesse erro, vale instruí-lo a evitar reações, figurinhas animadas ou formatos não convencionais.
O que fazer quando essa mensagem aparecer?
Reações a mensagens (ex: emojis de curtir ou reagir a uma mensagem no WhatsApp);
Figurinhas animadas (stickers personalizados não compatíveis);
Notas de voz enviadas como áudio temporário;
Arquivos ou formatos muito recentes ainda não suportados pela API;
Mensagens enviadas por bots ou recursos automatizados externos à Meta.
Atualizado