⚠️Limitações e Erros

✉️ 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: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/

---

✅ 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