> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.notificacoesinteligentes.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Status e Falhas na API Oficial: Causas e Soluções

A API Oficial do WhatsApp Business oferece mais estabilidade, segurança e escalabilidade para empresas. No entanto, durante o uso da plataforma, podem surgir alertas, limitações ou falhas relacionadas à conta, número ou políticas da Meta.

Neste artigo, você entenderá os principais status da conta, erros mais comuns e como agir para manter sua operação saudável e em conformidade com as diretrizes da Meta.
---

### Entendendo os sinais da Meta: Status da conta, status de envio e qualidade do número

Ao acessar a plataforma em **WhatsApp Oficial > Contas do WhatsApp**, a conta vinculada pode está com o status não verificada.

Abaixo, explicamos os principais motivos para esse status e como solucionar:

###### Status da conta: "Não verificado"

 Quando uma conta na API Oficial do WhatsApp aparece com o status **“Conta não verificada”**, isso geralmente significa que a empresa ainda não concluiu o processo de verificação comercial no Meta Business Manager ou que a conta do WhatsApp Business ainda não foi aprovada pela Meta.

A seguir, veja como verificar tanto o **status da conta do WhatsApp** quanto o **status de verificação da empresa** dentro da Meta.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_1a3s8uo.png =957xauto)


Para verificar o **status da conta**, acesse:
* Acesse o[ **Meta Business Manager**](https://business.facebook.com/)
* Vá em **Configurações**
* **Contas do WhatsApp** e acesse a conta utilizada no NI
* Em *Summary*, verifique o status da verificação da conta.
 ![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_17dymgt.png =802xauto)

Para verificar o **status da empresa**, acesse:
* Acesse o[ **Meta Business Manager**](https://business.facebook.com/)
* Vá em **Configurações**
* Clique em **Informações da empresa**
* Se não estiver verificada, faça a verificação da empresa.

**__Atenção!__** __Durante esse processo, **a Meta solicitará o envio de documentos da empresa para análise**. **Recomendamos contar com o suporte do seu gestor de tráfego ou responsável pela conta para auxiliar no preenchimento e envio correto das informações**.__

Neste artigo, você encontra mais detalhes sobre todo o processo: [__Como verificar sua empresa no Meta Business Suite__](https://business.facebook.com/business/help/2058515294227817).

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_1l9eub5.png =788xauto)

---

Para verificar o status de envio do número e sua classificação de qualidade, acesse:
**WhatsApp Oficial > Números de telefone**
Caso o número apresente status de envio como bloqueado ou limitado, ou esteja com classificação de qualidade moderada ou baixa, confira abaixo as possíveis causas e como solucionar cada situação.

###### Status de envio: "Limitado".
Esse status indica que a Meta aplicou restrições temporárias na velocidade ou no volume de envio da conta.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_1373qlu.png)
**Principais causas:**
* Alto volume de bloqueios por usuários.
* Denúncias de spam.
* Baixa taxa de resposta.
* Envio para listas frias ou não qualificadas.
* Excesso de mensagens promocionais.
* Conteúdo repetitivo.
* Disparos em massa em curto período.
* Número recém-conectado.

**Impactos mais comuns:**
* As mensagens podem apresentar maior lentidão no envio.
* A Meta pode reduzir temporariamente o volume de disparos da conta.
* Aplicar restrições no envio de templates, para iniciar novas conversas.

**Como evitar limitações:**
* Faça aquecimento gradual da instância.
* Use listas segmentadas.
* Priorize contatos com consentimento.
* Evite spam.
* Distribua grandes volumes entre múltiplos números.
* Revise templates regularmente no Meta Business Manager.
---

###### Status de envio: “Bloqueado”
Quando o status de envio aparece como bloqueado, significa que o número está temporariamente ou permanentemente impedido de enviar mensagens pela API Oficial.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_1y0brbt.png)

**Principais causas:**
* Ausência de método de pagamento cadastrado na conta da Meta
* Problemas com o cartão vinculado, como saldo insuficiente, limite indisponível, cartão vencido ou bloqueado, falhas na cobrança ou pendências financeiras
* Bloqueio aplicado pela Meta por violação das políticas da plataforma
* Restrição por comportamento considerado inadequado, como spam ou excesso de denúncias .

**Como resolver:**
* Para verificar se há um método de pagamento válido e ativo, acesse o Meta Business Manager em **Configurações > Contas do WhatsApp > Selecione a conta vinculada > Summary/Role > Configurações de pagamento**.
* Para verificar o status do número, acesse **Configurações > Contas do WhatsApp > Selecione a conta vinculada > Phone Numbers**.
* Em casos de conexão via Coexistence, também é recomendado verificar diretamente no aplicativo WhatsApp Business se existe alguma notificação, alerta ou solicitação de ação pendente relacionada ao número.

---

###### Qualidade do número: Moderada ou baixa
A qualidade do número reflete a experiência dos usuários com suas mensagens.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_1oy11bk.png)

**Principais causas:**
* Bloqueios e denúncias frequentes.
* Falta de consentimento.
* Conteúdo excessivamente promocional (spam).
* Baixo engajamento.
* Disparos agressivos.

 **Consequências de qualidade baixa ou moderada:**
* Redução de alcance.
* Limite diário menor.
* Menor velocidade de envio.
* Suspensão temporária.
* Restrições em campanhas.

**Como manter qualidade alta:**
* Trabalhe com leads quentes.
* Personalize mensagens.
* Evite listas frias.
* Monitore bloqueios.
* Faça higiene frequente das bases.
* Verifique os status de qualidade dos templates pelo menos uma vez por semana.

---

### Como identificar e interpretar falhas no envio de mensagens

Ao disparar um template ou uma mensagem na central de atendimento, apareceu o símbolo “!” e a mensagem não foi enviada?
Para visualizar a causa, basta passar o mouse sobre o símbolo, e será exibida uma mensagem informando o motivo da falha no envio.
![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_iygste.png)

Os motivos mais comuns são: 

* **Erro no método de pagamento da Meta**
Geralmente, isso ocorre devido a cartão vencido, saldo insuficiente ou ausência de um método de pagamento configurado.

Para resolver, acesse o caminho abaixo na Meta e verifique se a forma de pagamento cadastrada está correta e ativa:
[Meta Business](https://business.facebook.com/) > Configurações > Contas do WhatsApp > Configurações de pagamento.

* **Bloqueado pela Meta para manter um engajamento saudável do ecossistema.**
Isso indica uma limitação temporária aplicada pela Meta, geralmente relacionada ao envio excessivo de templates para contatos com baixa interação.

Para melhorar esse cenário, recomendamos:
* Aguardar um período antes de realizar novos disparos
* Revisar a qualidade e relevância dos templates utilizados
* Ajustar o conteúdo das mensagens para aumentar o engajamento
* Monitorar taxas de bloqueio, denúncias e resposta
* Reduzir a frequência de campanhas promocionais
* Garantir que os contatos tenham consentido em receber comunicações
Com boas práticas de envio e melhora no desempenho da conta, a Meta pode restabelecer gradualmente a capacidade de disparo.

*  **Número do destinatário indisponível**
Essa falha acontece quando:
* O telefone não possui WhatsApp
* Aplicativo desatualizado
* Usuário não aceitou termos
* Empresa foi bloqueada

---
# Desafios comuns na integração do WhatsApp Business
Durante a conexão do número à API Oficial ou Coexistence, alguns bloqueios ou falhas podem surgir devido a requisitos técnicos, elegibilidade do número ou regras da Meta.

### QR Code inválido ou falha no escaneamento
Se o QR Code apresentar erro ou o processo retornar automaticamente, isso geralmente está relacionado a **falhas de autenticação, aplicativo desatualizado, problemas de conexão ou verificação em duas etapas ativa.**

**Recomendações:**
* Atualizar o aplicativo WhatsApp Business
* Manter o aplicativo aberto durante toda a configuração
* Garantir internet estável
* Confirmar corretamente o PIN de segurança
* Verificar permissões no Meta Business Manager
---
#### Número sem elegibilidade para conexão
Alguns números podem não estar aptos para integração imediata, **principalmente quando recém-registrado, possuem pouco histórico de uso ou passaram por múltiplos recadastros recentes.**

![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/image_4ucuh0.png =406xauto)
**Recomendação:**
* Utilize o número por pelo menos 7 dias
* Idealmente mantenha uso ativo por 1 a 2 meses
* Evite excluir e registrar repetidamente
* Construa reputação orgânica
---

### Número já vinculado a outro provedor
Se o número já foi integrado anteriormente a outro provedor, plataforma ou conta do WhatsApp Business, a Meta exige a remoção completa desse vínculo antes de permitir uma nova conexão.
![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/geminigeneratedimagee5w4rle5w4_jowtjw.png =388xauto)


**Como resolver:**
* Remova o vínculo da conta ou provedor anterior
* Reinstale o aplicativo WhatsApp Business, se necessário
* Registre novamente o número no aplicativo
* Utilize o número por um período para reconstruir histórico de uso
* Aguarde nova elegibilidade antes de tentar reconectar

**Importante:**
Múltiplas tentativas consecutivas de exclusão e recadastro podem impactar negativamente a elegibilidade do número. Sempre que possível, mantenha um histórico de uso estável antes de iniciar uma nova tentativa de integração.

---
### Funcionalidade indisponível em alguns países
A integração via Coexistence/API Oficial pode apresentar restrições regionais definidas pela Meta, o que significa que números registrados em determinadas localidades podem não ser elegíveis para conexão.
![](https://storage.crisp.chat/users/helpdesk/website/-/7/8/6/4/786467ca5128f400/geminigeneratedimagel930oql930_cwz0k0.png =452xauto)


**Regiões com restrições mais frequentes:**
* União Europeia, Reino Unido, Austrália, Japão, Rússia, Filipinas, Coreia do Sul, Turquia e África do Sul

**Recomendação:**
Para garantir maior compatibilidade, priorize números de países atualmente suportados pela integração, como **Brasil, Estados Unidos, Índia, México, Indonésia, Hong Kong ou Singapura**.

**Importante:**
Essas limitações são determinadas exclusivamente pela Meta e podem sofrer alterações conforme políticas regionais, regulamentações locais ou atualizações na disponibilidade da tecnologia.

---

###### Saiba mais sobre o WABA

Confira os próximos passos para **configurar e criar templates no Waba, acesse os artigos:**
* [__Guia Essencial do WABA: Janela de Atendimento e Boas Práticas na Meta__](https://ajuda.notificacoesinteligentes.com/pt-br/article/guia-essencial-do-waba-janela-de-atendimento-e-boas-praticas-na-meta-13w77tz/)
* [__Usabilidade do WABA no Notificações Inteligentes__](https://ajuda.notificacoesinteligentes.com/pt-br/article/usabilidade-do-waba-no-notificacoes-inteligentes-1snwie7/)
* [WhatsApp API Oficial: Configuração e Gerenciamento](https://ajuda.notificacoesinteligentes.com/pt-br/article/whatsapp-api-oficial-configuracao-e-gerenciamento-2l6yso/)

