> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/codigos-de-erros-da-meta.md).

# Códigos de Erros

Ao integrar ou utilizar serviços da Meta, alguns códigos de erro podem ser retornados pela plataforma. Neste artigo, você encontrará a descrição desses códigos, organizados em ordem numérica, com orientações para entender suas causas e possíveis soluções.

## Erro 100: Mensagem Não Suportada

<figure><img src="/files/cH8YVpkUkH48nctrqlC7" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro geralmente acontece quando há problemas nos parâmetros enviados na requisição ou nas permissões necessárias para executar a ação na API da Meta. Ele pode ocorrer quando o sistema tenta acessar um recurso inexistente, utiliza dados inválidos ou quando o aplicativo não possui as permissões necessárias.

**Causas mais comuns**

* **Parâmetros inválidos ou ausentes:** a requisição enviada para a API contém parâmetros incorretos, incompletos ou em formato inválido. Por exemplo, ao tentar acessar um recurso utilizando um ID inválido ou sem informar todos os campos obrigatórios.
* **Recurso inexistente ou inacessível:** a tentativa de acessar um recurso que não existe ou que não está disponível para o aplicativo.
* **Permissões insuficientes:** o aplicativo pode não possuir as permissões necessárias para executar determinada ação, como enviar mensagens ou acessar determinados dados.
* **Problemas com URLs:** quando a mensagem contém links, URLs malformadas ou que não seguem os requisitos da Meta podem impedir o processamento da requisição.

**Como resolver**

* **Verifique os parâmetros da requisição:** confirme se todos os parâmetros obrigatórios estão presentes e se os dados enviados estão no formato correto.
* **Confirme as permissões do aplicativo:** verifique se o aplicativo possui todas as permissões necessárias para realizar a ação desejada. Caso necessário, revise ou conceda as permissões no painel da Meta: [Processo Para Conceder Permissão](/guide/documentacao/ajustes/conta/processo-de-dar-permissao-para-reconectar-o-numero.md)
* **Valide os recursos utilizados:** certifique-se de que os recursos ou IDs informados realmente existem e que estão acessíveis para o aplicativo.
* **Teste as URLs utilizadas:** se a mensagem contiver links, valide as URLs para garantir que estão corretamente formatadas. Ferramentas de verificação da Meta podem ajudar a identificar problemas com os links antes do envio: [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/)

## Erro 130472: Experimento da Meta

<figure><img src="/files/0LtiCuXjTjVAK8ZNNnIp" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro pode ocorrer porque a Meta selecionou aproximadamente 1% dos números de telefone conectados ao WhatsApp Cloud API no mundo para participarem de um experimento controlado. O objetivo desse teste é avaliar como o recebimento de mensagens de marketing impacta a experiência dos usuários finais no WhatsApp.

**O que isso significa na prática?**

Para os números incluídos nesse experimento, o envio de modelos de mensagem da categoria Marketing pode ser temporariamente limitado ou bloqueado, mesmo que sua conta WABA (WhatsApp Business Account) esteja:

* corretamente configurada;
* com saldo disponível;
* com templates aprovados pela Meta;
* sem qualquer infração às políticas da plataforma.

A restrição não está relacionada a erro de configuração ou penalização da conta, mas sim a um teste conduzido pela própria Meta.

**O que a Meta está avaliando?**

A Meta realiza esse tipo de experimento para ajustar seus algoritmos e políticas de envio de mensagens. Entre os pontos analisados estão:

* o impacto de mensagens de marketing na satisfação do usuário;
* taxas de entrega, leitura, bloqueio e denúncias;
* possíveis ajustes nos limites de envio de mensagens de marketing.

{% hint style="info" %}
Esses experimentos são temporários, porém a Meta não divulga um prazo oficial para o encerramento do teste.
{% endhint %}

**Soluções e alternativas**

Se você precisar se comunicar com um contato que esteja incluído nesse experimento, algumas estratégias podem ajudar:

1. **Utilize modelos da categoria Utilidade:** o bloqueio está focado principalmente em mensagens de Marketing. Sempre que possível, tente iniciar a conversa utilizando modelos da categoria Utilidade, como confirmação de pedido, envio de boleto ou lembretes de agendamento.
2. **Aguarde o usuário iniciar a conversa (janela de 24 horas):** a restrição se aplica ao envio iniciado pela empresa. Caso o cliente envie uma mensagem primeiro, será aberta uma janela de atendimento de 24 horas, na qual você poderá responder normalmente.
3. **Utilize canais alternativos para iniciar o contato:** se o assunto for urgente, você pode entrar em contato com o cliente por outros canais, como telefone, SMS ou e-mail, e solicitar que ele envie uma mensagem no WhatsApp.

{% hint style="info" %}
**Pontos importantes:**

* **Não é um erro da plataforma ou do provedor (BSP):** a restrição vem diretamente da API da Meta.
* **Não é uma penalização:** o bloqueio não está relacionado à qualidade do número ou a denúncias de usuários.
* **Não é possível solicitar remoção do teste:** como se trata de um experimento automático e aleatório da Meta, não há opção de opt-out para sair manualmente desse grupo.
  {% endhint %}

## Erro 130497: Conta Comercial Impedida de Enviar Mensagens

**Por que esse erro ocorre?**

O erro 130497 indica que a conta do WhatsApp Business está sujeita a uma restrição geográfica de envio de mensagens. Essa limitação ocorre quando a Meta não consegue validar corretamente a localização da empresa, geralmente devido a informações incompletas ou configuradas incorretamente no Meta Business Manager.

Diferente do que muitas pessoas imaginam, a Meta não identifica automaticamente o país da empresa apenas pelo prefixo do número de telefone (por exemplo, +55 para o Brasil). Quando o campo **"País"** não está preenchido ou está configurado incorretamente nas informações da empresa no **Business Manager**, o sistema pode aplicar restrições de envio entre países, mesmo quando a comunicação ocorre dentro do mesmo país.

**Como resolver**

1. Acesse o **Meta Business Manager**.
2. Vá até **Configurações do negócio**.
3. Selecione **Informações da empresa**.
4. Localize o campo **País** e verifique se ele está preenchido corretamente (por exemplo: **Brasil**).
5. Caso o campo esteja vazio ou incorreto, clique em **Editar**, selecione o país correto e **salve as alterações**.
6. Após a atualização, aguarde o período de propagação da configuração na Meta.

Após a atualização das informações da empresa no Business Manager e a propagação das alterações pela Meta, o envio de mensagens tende a ser normalizado automaticamente.

## Erro 131000: Erro Desconhecido

<figure><img src="/files/WcVnNG5AhAFxTXlQ9lu2" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131000 ocorre quando há uma falha técnica no processamento do envio de mensagens pela API do WhatsApp da Meta. Esse tipo de erro normalmente está relacionado a problemas temporários de comunicação entre os sistemas, configurações incorretas ou instabilidades momentâneas nos serviços da Meta.

**Possíveis causas**

* Instabilidade temporária nos servidores da Meta: [**status da API da Meta**](https://metastatus.com/)**;**
* Falhas de comunicação entre a plataforma utilizada e a API do WhatsApp;
* Configurações incorretas na integração com a API.

**Como resolver**

* **Verifique o status da API da Meta:** confirme se há relatos de instabilidade ou manutenção nos serviços da Meta que possam estar afetando o envio de mensagens.
* **Verifique sua conexão com a internet:** certifique-se de que a conexão utilizada para acessar a plataforma está funcionando corretamente.
* **Tente enviar a mensagem novamente:** em muitos casos, esse erro é temporário e pode ser resolvido ao realizar uma nova tentativa de envio após alguns instantes.

{% hint style="info" %}
Se esse erro ocorrer logo após a conexão de um número na API Oficial, pode ser necessário reconfigurar a integração.

Nesse caso:

1. Acesse o **portfólio empresarial (Meta Business Manager)**.
2. Exclua as informações relacionadas à conexão do número.
3. Realize novamente o processo de conexão do número à API Oficial.

Após a reconexão, o envio de mensagens tende a voltar ao funcionamento normal.
{% endhint %}

## Erro 131026: Número Não Registrado no WhatsApp

<figure><img src="/files/uRu0taP5tXFEsrCq5OyS" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131026 ocorre quando há uma tentativa de envio de mensagem para um número que não está registrado no WhatsApp. O sistema não consegue entregar a mensagem porque o número informado não possui uma conta ativa na plataforma.

**Causas mais comuns**

* **Número não possui conta no WhatsApp:** o número informado 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 utilizado no WhatsApp e não atualizou essa informação com sua empresa.
* **Erro ao digitar o número:** o número pode ter sido inserido incorretamente, com dígitos a mais, a menos ou no formato incorreto.
* **Conta desativada:** o usuário pode ter desativado temporariamente ou permanentemente sua conta do WhatsApp.

**Como resolver**

1. **Verifique se o número está correto:** confirme se o número foi informado corretamente, se está no formato internacional incluindo o código do país (ex.: **+55** para Brasil) e se contém o nono dígito, quando aplicável. Confirme com o cliente se o número utilizado é o mesmo registrado no WhatsApp.
2. **Verifique se o número possui WhatsApp:** você pode validar isso tentando iniciar uma conversa diretamente pelo aplicativo WhatsApp ou utilizando o link **<https://wa.me/\\[número>]**. Se o número não estiver registrado no WhatsApp, a conversa não poderá ser iniciada.
3. **Teste o envio para outro número:** envie o mesmo Template de Mensagem (TM) para outro número que você sabe que está ativo no WhatsApp. Se a mensagem for enviada com sucesso, o problema está no número original. Se a mensagem não for enviada, o problema pode estar relacionado ao template de mensagem ou à configuração da conta.

## Erro 131031: Conta Restrita ou Bloqueada

<figure><img src="/files/6loOoXNf2uqVn9wlxucU" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131031 ocorre quando a conta do WhatsApp Business está restrita ou bloqueada pela Meta. Essa situação normalmente indica que a conta pode ter violado alguma política ou regra de uso do WhatsApp Business. Quando isso acontece, a Meta pode limitar temporariamente ou bloquear o envio de mensagens até que a situação seja analisada ou regularizada.

**Causas mais comuns**

* **Violação das políticas da Meta:** envio de mensagens que não seguem as diretrizes do WhatsApp Business, como conteúdo inadequado ou comunicação não autorizada pelos usuários.
* **Reclamações de usuários:** um número elevado de bloqueios ou denúncias de spam por parte dos destinatários pode impactar negativamente a qualidade da conta e levar a restrições.
* **Atividades consideradas suspeitas:** uso inadequado da API, como envio excessivo de mensagens em massa ou automações agressivas, pode fazer com que a Meta aplique restrições preventivas na conta.

**Como resolver**

Para entender o motivo da restrição e verificar possíveis orientações da Meta, siga os passos abaixo:

1. Acesse o **Meta Business Manager**.
2. Na barra lateral esquerda, clique no ícone de **menu**.
3. Clique em **Página Inicial do Suporte para Empresas**.
4. Verifique se há notificações, alertas ou mensagens da Meta relacionadas à conta ou ao erro.

<figure><img src="/files/g6BPS21FhpaLzjmHljQJ" alt="" width="563"><figcaption></figcaption></figure>

**Boas práticas para regularizar a conta**

* **Revise as políticas de uso:** certifique-se de que sua conta está em conformidade com as Políticas Comerciais e as Políticas de Mensagens da Meta. Evite enviar mensagens não solicitadas ou conteúdos que possam ser interpretados como spam pelos destinatários.
* **Responda às notificações da Meta:** verifique se há notificações ou solicitações de ação no Gerenciador de Negócios. Caso existam, siga as orientações fornecidas pela Meta. Em muitos casos, a Meta pode solicitar informações adicionais ou ajustes nas práticas de envio.
* **Corrija possíveis práticas inadequadas:** reduza o envio de mensagens para listas grandes de contatos que não interagiram recentemente com sua empresa, priorize mensagens relevantes e garanta que o opt-in (consentimento do cliente para receber mensagens) esteja devidamente coletado e documentado.

## Erro 131042: Falha no Processamento de Pagamento

<figure><img src="/files/JVtJYCNGfOUpTiiYj7sL" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131042 ocorre quando a Meta enfrenta dificuldades para processar o pagamento utilizando o cartão cadastrado na conta do portfólio empresarial (Business Manager). Na maioria dos casos, o problema está relacionado a falhas no processamento do pagamento pela própria Meta, o que impede a realização do débito, mesmo quando o cartão cadastrado está válido e ativo.

**Possíveis causas**

* Inconsistências temporárias no sistema de cobrança da Meta;
* Falha ao processar o valor total pendente;
* Problemas com o método de pagamento configurado na conta.

**Como resolver**

1. **Confirme os dados do cartão:** verifique se as informações do cartão cadastradas no Business Manager estão corretas e atualizadas. Confirme se há saldo ou limite disponível para a cobrança.
2. **Tente realizar o pagamento manualmente:** no Gerenciador de Negócios, acesse **Contas > Contas do WhatsApp > Configurações de pagamento** e verifique o saldo pendente. Se houver um valor em aberto, tente realizar o pagamento manualmente. Caso o pagamento do valor total não seja processado, tente ajustar o valor manualmente para um valor ligeiramente menor e realize a cobrança novamente.
3. **Atualize ou adicione um novo método de pagamento:** acesse **Contas > Contas do WhatsApp > Configurações de pagamento**, clique em **"Adicionar forma de pagamento"**, insira os dados do cartão e clique em **"Salvar"**. Após atualizar ou adicionar um novo método de pagamento, aguarde alguns minutos para que a Meta processe a alteração.

## Erro 131047: Mais de 24h Sem Contato

<figure><img src="/files/Vza4heJfuqcjUKaxuxpC" alt=""><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131047 ocorre quando uma empresa tenta enviar uma mensagem fora da janela de atendimento de 24 horas do WhatsApp. De acordo com as políticas do WhatsApp, após 24 horas desde a última mensagem enviada pelo cliente, a empresa não pode mais responder livremente na conversa. A partir desse momento, novas mensagens só podem ser enviadas utilizando um modelo de mensagem (template) previamente aprovado pela Meta.

Essa regra existe para evitar comunicações não solicitadas e preservar uma boa experiência para os usuários do WhatsApp.

**Como resolver**

Para retomar o atendimento, é necessário enviar um modelo de mensagem aprovado pela Meta. Após o cliente responder a essa mensagem, a janela de atendimento de 24 horas será reaberta, permitindo que a conversa continue normalmente.

{% hint style="info" %}
Esse erro também pode ocorrer se o número do contato for editado durante uma conversa ativa. Por exemplo, se durante o atendimento houver a necessidade de corrigir o número do cliente, como adicionar o nono dígito ou atualizar o telefone informado, o sistema pode interpretar a alteração como um novo contato sem histórico recente de interação, resultando no erro de janela de 24 horas.
{% endhint %}

## Erro 131048: Parâmetro Ausente ou Inválido

<figure><img src="/files/mg36SBYFVZPh43iwz2PU" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 131048 ocorre quando há algum problema na estrutura da mensagem enviada ou quando a conta atinge limitações relacionadas à qualidade ou ao volume de envio de mensagens. Esse erro pode acontecer quando parâmetros obrigatórios estão ausentes ou inválidos, ou quando a Meta identifica comportamentos que podem indicar envio excessivo de mensagens ou possível atividade de spam.

**Causas mais comuns**

* **Parâmetro ausente ou inválido:** a mensagem enviada pode não conter todas as informações necessárias ou pode incluir dados em formato incorreto, o que impede o processamento da requisição pela API da Meta.
* **Limite de qualidade ou spam atingido:** o WhatsApp pode aplicar restrições temporárias quando identifica que a conta possui baixa classificação de qualidade. Isso pode ocorrer quando muitos usuários bloqueiam o número ou denunciam as mensagens como spam.
* **Limite de taxa de envio:** também pode ocorrer quando há um volume muito alto de mensagens enviadas em um curto período, ultrapassando os limites definidos pela Meta.

**Como resolver**

* **Verifique os parâmetros da mensagem:** confirme se todos os campos obrigatórios da mensagem estão presentes e se os dados enviados estão no formato correto.
* **Reduza o volume de envios:** caso o erro esteja relacionado a limites de envio, diminua a quantidade de mensagens enviadas a partir do mesmo número em um curto intervalo de tempo.
* **Verifique a qualidade da conta:** no **WhatsApp Manager**, consulte o status de qualidade do número para verificar se há alertas relacionados a bloqueios ou denúncias por parte dos usuários.
* **Evite mensagens repetitivas:** evite enviar mensagens idênticas ou muito frequentes, pois esse comportamento pode ser interpretado pela Meta como spam.

## Erro 131049: Limite de Marketing por Destinatário

<figure><img src="/files/EEMCACqcVKHMR1N2oDdd" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro acontece quando você tenta enviar um modelo de mensagem para iniciar ou reiniciar uma conversa com o cliente. Não se trata de um erro da plataforma, mas sim de uma restrição aplicada diretamente pela Meta. Em determinadas situações, a Meta identifica que um número de telefone recebeu muitas mensagens de marketing em um curto período. Para preservar uma boa experiência para os usuários do WhatsApp, a Meta pode bloquear temporariamente o envio de novas mensagens de marketing para esse número.

A própria mensagem de erro retornada pela Meta inclui um link para a documentação oficial com mais detalhes sobre essa limitação: [documentação da Meta](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates#user-marketing-template-message-limits)

**Como agir ao receber esse erro**

Ao receber esse código de erro, não é recomendado tentar reenviar a mesma mensagem imediatamente. Você pode:

* Enviar uma **mensagem do tipo Utilidade**, se fizer sentido para a comunicação.
* **Aguardar um período maior antes de tentar novamente**, pois o limite aplicado pela Meta pode permanecer ativo por diferentes períodos de tempo.

**Boas práticas para evitar esse bloqueio**

* **Varie os tipos de mensagem:** evite enviar apenas mensagens de marketing. Sempre que possível, utilize também mensagens do tipo Utilidade, quando forem relevantes para o cliente.
* **Evite envios excessivos em curto período:** o envio frequente de mensagens de marketing para o mesmo número em um intervalo pequeno de tempo aumenta a probabilidade de bloqueio.
* **Aguarde o desbloqueio automático:** caso o bloqueio ocorra, será necessário aguardar o período determinado pela Meta, que pode variar de algumas horas até alguns dias.

## Erro 131051: Mensagem Não Suportada pela API

<figure><img src="/files/efyZEdP666uts8GMjkQV" alt=""><figcaption></figcaption></figure>

**O que significa essa mensagem?**

A mensagem **"Mensagem não suportada pela API"** aparece quando um contato envia um tipo de conteúdo que não é compatível com a API oficial da Meta, utilizada nas integrações com WhatsApp, Instagram ou Messenger. Nesses casos, a plataforma não consegue exibir ou processar o conteúdo recebido.

Esse comportamento é esperado e controlado diretamente pela Meta, não sendo algo que possa ser alterado ou corrigido pela plataforma. Mesmo que o conteúdo específico não possa ser exibido, a conversa não é perdida. Todas as demais mensagens trocadas permanecem normalmente disponíveis no histórico do atendimento.

**Exemplos de conteúdos que podem gerar essa mensagem**

* **Reações a mensagens** (como emojis de reação no WhatsApp);
* **Figurinhas animadas** ou stickers personalizados não compatíveis;
* **Áudios temporários** ou formatos específicos de notas de voz;
* **Arquivos ou formatos muito recentes**, ainda não suportados pela API oficial;
* **Mensagens enviadas por bots ou automações externas** que utilizam recursos não compatíveis com a integração.

**O que fazer quando essa mensagem aparecer?**

* Informe ao cliente que o formato do conteúdo enviado não é compatível com a integração oficial.
* Solicite que ele reenvie a informação em outro formato, como texto, imagem, áudio padrão ou documento.
* Oriente o contato a evitar o envio de reações, figurinhas animadas ou formatos não convencionais, caso o problema ocorra com frequência.

{% hint style="info" %}
Esse comportamento não indica um erro da plataforma, mas sim uma limitação da API oficial da Meta, responsável por definir quais tipos de conteúdo podem ser processados por integrações externas.
{% endhint %}

## Erro 131056: Limite de Volume de Envios Atingido

<figure><img src="/files/gtFBu57jjg85RJKsJMm2" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

Esse erro ocorre, principalmente, quando muitas mensagens de marketing são enviadas para o mesmo contato em um curto período de tempo. A plataforma continua funcionando normalmente, porém a Meta pode aplicar restrições temporárias no envio de mensagens de marketing para determinados números.

A Meta possui mecanismos de controle para evitar que usuários recebam um volume excessivo de mensagens de marketing. Quando o sistema identifica que um número recebeu muitas mensagens desse tipo em um intervalo curto, o envio de novas mensagens de marketing pode ser temporariamente pausado para aquele destinatário. Essa medida é aplicada automaticamente pela Meta.

**Como resolver**

* **Reduza a quantidade de mensagens enviadas para cada contato:** evite enviar muitas mensagens de marketing para o mesmo número em um curto intervalo de tempo.
* **Varie os tipos de mensagens enviadas:** em vez de utilizar apenas mensagens de marketing, sempre que possível utilize também mensagens do tipo Utilidade, que normalmente possuem regras de envio mais flexíveis.
* **Monitore o status de envio das mensagens:** acompanhe os relatórios ou status de entrega das mensagens. Caso identifique bloqueios frequentes, considere reduzir o volume de envios e aguardar o período de desbloqueio automático aplicado pela Meta.

## Erro 131060: Mensagem Indisponível (Coexistência e CTWA)

<figure><img src="/files/wkTBGcOAg8Gg6Nyw9dRu" alt=""><figcaption></figcaption></figure>

**O que está acontecendo?**

Ao operar canais de WhatsApp Business, especialmente em cenários que utilizam anúncios **Click-to-WhatsApp (CTWA)** em ambientes de **Coexistência (COEX)**, você pode se deparar com um aviso no atendimento indicando o erro 131060. Esse comportamento está relacionado a uma limitação conhecida da infraestrutura do WhatsApp.

O erro ocorre devido a um atraso na classificação da conversa pelos servidores do WhatsApp. Quando um cliente inicia uma conversa com um número de WhatsApp Business, o aplicativo precisa primeiro exibir uma mensagem de sistema de segurança, conhecida como **aviso azul**, que informa ao usuário que a conversa está sendo gerenciada por um serviço da Meta.

**Por que ocorre o erro?**

Se o cliente envia uma mensagem antes que o aviso azul apareça no aplicativo, o WhatsApp ainda trata aquela conversa como um chat comum do aplicativo Small and Medium Business (SMB). Nesse cenário:

* a plataforma recebe o evento de envio da mensagem,
* porém o conteúdo da mensagem não é compartilhado com a API Oficial (Cloud API).

Como resultado, a mensagem chega ao sistema sem conteúdo, gerando o erro 131060 no histórico da conversa.

**Por que isso acontece mais em anúncios (CTWA)?**

A maioria das ocorrências acontece em fluxos iniciados por Click-to-WhatsApp, quando o usuário clica em anúncios do Facebook ou Instagram que direcionam para o WhatsApp. Isso ocorre devido à combinação de alguns fatores:

* **Velocidade de ação:** o usuário clica no anúncio e a mensagem automática pré-definida é enviada quase imediatamente.
* **Primeiro contato com a empresa:** geralmente é a primeira vez que o cliente conversa com o número da empresa, e ele ainda não possui o contato salvo na agenda.
* **Processamento inicial da criptografia:** a criptografia de ponta a ponta e a identificação da conversa comercial ainda estão sendo processadas pela infraestrutura da Meta.

{% hint style="info" %}
Embora não exista uma confirmação oficial da Meta sobre todos os fatores envolvidos, observamos que dispositivos mais antigos, conexão de internet instável e alto volume de mensagens simultâneas podem aumentar a incidência desse comportamento.
{% endhint %}

**Como mitigar esse cenário**

De acordo com a orientação atual da Meta, a única forma de evitar esse comportamento em fluxos iniciados por anúncios Click-to-WhatsApp é migrar o número completamente para a Cloud API (API Oficial), deixando de utilizar o modo de Coexistência com o aplicativo físico do WhatsApp.

{% hint style="info" %}
**Posicionamento oficial da Meta:**

Nossa equipe técnica escalou esse comportamento diretamente para a equipe de produto da Meta. O retorno oficial foi que se trata de um comportamento conhecido da plataforma, ocorre devido ao atraso na exibição da mensagem de sistema, e o impacto é maior em números que utilizam Coexistência (COEX) com alto volume de tráfego.

A Meta informou que pretende documentar esse cenário oficialmente, revisar a descrição do erro e avaliar melhorias na arquitetura para reduzir ou eliminar essa limitação no futuro. Este artigo será atualizado caso novas orientações ou soluções sejam disponibilizadas pela Meta.
{% endhint %}

## Erro 132001: Modelo Não Existe

<figure><img src="/files/j3U3BHndOMj6woBAvnGl" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 132001 ocorre quando há uma tentativa de envio de um modelo de mensagem (template) que não está registrado ou não é reconhecido pela API do WhatsApp. O sistema não conseguiu localizar o modelo solicitado na base de templates disponíveis na Meta.

**Causas mais comuns**

* **Modelo de mensagem excluído:** o template pode ter sido removido no WhatsApp Manager (Gerenciador de Negócios) e, por isso, não está mais disponível para envio.
* **Nome do modelo incorreto:** o nome do modelo pode ter sido informado de forma incorreta, impedindo que a API identifique o template correspondente.
* **Modelo ainda em análise:** o template pode estar em processo de aprovação pela Meta e, enquanto estiver nesse status, não poderá ser utilizado para envio.
* **Modelo rejeitado:** se o modelo foi reprovado pela Meta, ele não poderá ser utilizado até que seja ajustado e aprovado novamente.

**Como resolver**

* **Sincronize os modelos de mensagem:** solicite a um usuário com perfil de **Administrador** que realize a sincronização dos modelos de mensagem com a Meta, garantindo que todos os templates estejam atualizados na plataforma.
* **Crie um novo modelo de mensagem:** se o modelo não existir mais ou estiver com problemas, crie um novo template e aguarde a aprovação da Meta.
* **Reenvie o modelo para aprovação:** caso o modelo esteja reprovado ou ainda em análise, revise o conteúdo conforme necessário e envie novamente para aprovação.
* **Siga as diretrizes da Meta para templates:** certifique-se de que o modelo atende às [diretrizes para modelos de mensagem](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/), evitando novas reprovações.

## Erro 135000: Falha ao Enviar Mensagem

<figure><img src="/files/9bvzxDHDMi5ElIiRjj5S" alt="" width="563"><figcaption></figcaption></figure>

**Por que esse erro ocorre?**

O erro 135000 pode ocorrer quando um atendente tenta enviar um modelo de mensagem (template) durante um atendimento e o envio falha. Esse problema geralmente está relacionado a inconsistências na sincronização ou validação do modelo de mensagem junto à Meta. Em alguns casos, o modelo pode estar aprovado na Meta, mas não estar corretamente sincronizado ou atualizado na plataforma, o que impede o envio.

**Como resolver**

Uma das formas mais comuns de resolver esse problema é realizar a sincronização dos modelos de mensagem com a Meta. Essa ação deve ser realizada por um usuário com perfil de **Administrador**.

Se o problema persistir, siga os passos abaixo:

1. **Acesse os Modelos de Mensagem:** localize o modelo que está sendo utilizado no painel de **Modelos de Mensagem de Atendimento**.
2. **Duplique o modelo de mensagem:** crie uma cópia do modelo que apresentou o erro. Você pode manter o mesmo conteúdo ou realizar pequenos ajustes, se necessário.
3. **Envie o novo modelo para aprovação:** após duplicar o modelo, envie-o para aprovação da Meta e aguarde até que ele seja aprovado.
4. **Teste o envio novamente:** depois da aprovação, utilize o modelo duplicado para realizar um novo teste de envio da mensagem.

{% hint style="info" %}
Se o modelo duplicado funcionar normalmente, pode ser útil duplicar outros modelos que apresentem comportamento semelhante, garantindo que todos estejam atualizados e sincronizados corretamente com a Meta. Isso ajuda a evitar falhas no envio e mantém o fluxo de comunicação funcionando sem interrupções.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flw.chat/guide/documentacao/faq/conexao-whatsapp/erros-e-problemas/codigos-de-erros-da-meta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
