> For the complete documentation index, see [llms.txt](https://doc.whazing.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.whazing.com.br/canais-disponiveis/api-oficial/limitacoes-e-erros.md).
# Limitações e Erros
#### ⚠️ Considerações importantes
* A API oficial **não oferece suporte a grupos**.
* A API oficial **não exibe a foto do contato**.
* Você tem **24 horas** para responder uma mensagem do cliente via Whazing.
* No modo COEX tem algumas mensagens que não chegam na api oficial, somente aparece no celular
## ✉️ Envio de mensagens com API Oficial via Whazing
O Whazing permite o envio de mensagens utilizando a **API Oficial do WhatsApp**, porém essa integração possui **regras e limitações definidas pela Meta** que precisam ser compreendidas para evitar erros e mensagens rejeitadas.
***
## ✅ O que é possível fazer
* Enviar **mensagens de texto**
* Enviar **arquivos** (imagens, vídeos, áudios e documentos)
* Utilizar a API integrada ao Whazing, com segurança e estabilidade
***
## ⚠️ Pontos de atenção importantes
* A API Oficial **não valida se o número possui WhatsApp**
* É responsabilidade do usuário garantir que:
* O número esteja **correto**
* Utilize **DDD + 9º dígito**, quando necessário
* O envio respeite a **janela de atendimento de 24 horas**
***
## 📊 Regras e limites da API Oficial
### 1️⃣ Início de conversas (Templates)
Para **iniciar uma conversa com um cliente**, é obrigatório utilizar uma:
📩 **Mensagem de modelo (Template)**
Essas mensagens:
* Precisam ser **aprovadas previamente pela Meta**
* São obrigatórias quando:
* Não existe conversa ativa
* A janela de 24 horas já foi encerrada
***
### 2️⃣ Janela de atendimento de 24 horas
* Após o cliente enviar uma mensagem, abre-se uma **janela de 24 horas**
* Dentro desse período, é permitido enviar:
* Mensagens de texto
* Arquivos
* Fora desse prazo:
* ❌ Mensagens livres não são entregues
* ✅ Apenas **Templates aprovados** podem ser enviados
***
### 3️⃣ Imagens PNG com fundo transparente
* Imagens em **PNG com transparência** podem sofrer alterações
* O WhatsApp converte automaticamente esse formato para **JPEG**
* Isso pode resultar em:
* Fundo branco
* Perda de transparência
***
***
## ❌ Mensagem com “X” vermelho (mensagem rejeitada)
Quando uma mensagem aparece com um **“X” vermelho**, significa que ela **foi rejeitada pela Meta**.
### Motivos mais comuns
* ⏰ Envio fora da **janela de 24 horas**
* 📎 Arquivo em **formato não suportado**
* 📄 Conteúdo incompatível com as políticas da Meta
***
## 🔍 Verificando o erro via Webhook
Quando o webhook está ativo, é possível visualizar o **motivo exato da rejeição** da mensagem.
➡️ Neste exemplo, o erro ocorreu porque foi enviado um **arquivo em formato não suportado**.
***
### Outro exemplo de erro retornado pela Meta
***
## 🔀 Limitações da Coexistência (WhatsApp Business App + API Oficial)
A **Coexistência** ocorre quando o mesmo número é utilizado **simultaneamente** no:
* WhatsApp Business App
* API Oficial do WhatsApp
### Limitações da Coexistência
* ❌ **Não suporta mensagens em grupos**
* ⚠️ **Não é recomendada para alto volume de envios**
* 🔐 Exige autenticação via **QR Code**
***
## 🚦 Limite de envio – SOMENTE para Coexistência
⚠️ **Este limite se aplica exclusivamente ao modo de Coexistência**
Quando um número está em **Coexistência**, a Meta impõe um limite fixo de envio:
📌 **20 mensagens por segundo (20 mps)**
Esse limite existe para:
* Evitar conflitos entre o app WhatsApp Business e a API
* Preservar a estabilidade do número
* Reduzir riscos de bloqueios ou restrições
### ❗ Importante
* ✔️ **API Oficial sem Coexistência**
* **Não possui limite fixo de 20 mps**
* Os limites variam conforme:
* Qualidade do número
* Histórico de uso
* Tier de envio definido pela Meta
***
## 📚 Documentação oficial da Meta
A Meta possui outras regras e limitações que podem variar conforme o tipo de conta e uso.
🔗 Consulte sempre a documentação oficial:
***
Você pode adicionar a seguinte seção na documentação da API Oficial (WABA) do Whazing:
***
## 🔗 Links Úteis para Suporte e Gestão da API Oficial (Meta WhatsApp)
### Verificar Qualidade da Conta
A Meta disponibiliza uma página para acompanhar a qualidade da conta, restrições, violações de políticas e possíveis limitações relacionadas ao WhatsApp Business.
👉 [Meta Account Quality](https://www.facebook.com/accountquality?utm_source=chatgpt.com)
***
### Suporte Oficial da Meta para Parceiros e Tech Providers
Caso seja necessário abrir um atendimento diretamente com a Meta, utilize o canal oficial de suporte empresarial:
👉 [Meta Direct Support](https://business.facebook.com/direct-support?utm_source=chatgpt.com)
#### Recomendação para Tech Providers
Ao abrir um chamado:
1. Selecione o **Business Manager (BM)** relacionado à sua conta.
2. Escolha a opção **Fazer uma pergunta**.
3. Selecione categorias relacionadas a:
* Tech Provider
* WhatsApp Business Platform (WABA)
* Integrações da API Oficial
4. Descreva detalhadamente o problema, incluindo:
* ID da WABA
* ID do Número
* Business Manager (BM)
* Prints de erro (quando aplicável)
* Horário aproximado da ocorrência
#### Quando utilizar este suporte
* Erros de aprovação da WABA
* Problemas de verificação empresarial
* Restrições de envio
* Bloqueios de qualidade
* Limites de mensagens
* Problemas com templates
* Questões relacionadas ao programa Tech Provider
* Problemas na API Oficial do WhatsApp
> Este canal costuma ser o meio mais eficaz para suporte relacionado a contas Tech Provider e WhatsApp Business Platform (WABA).
***
💡 **Dica:** Antes de abrir um chamado, consulte a página de qualidade da conta. Muitas restrições e bloqueios já são exibidos diretamente no painel da Meta, agilizando o diagnóstico do problema.
***
## ✅ Resumo rápido
* ✔️ API Oficial é estável e segura
* ⏰ Janela de 24h é obrigatória
* 📩 Templates são exigidos para iniciar conversas
* ❌ Não funciona com grupos em Coexistência
* 🚦 **20 mensagens por segundo apenas em Coexistência**
* 📈 API Oficial sem Coexistência segue limites dinâmicos da Meta
