⚠️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: https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/
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.
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:
Recomendação para Tech Providers
Ao abrir um chamado:
Selecione o Business Manager (BM) relacionado à sua conta.
Escolha a opção Fazer uma pergunta.
Selecione categorias relacionadas a:
Tech Provider
WhatsApp Business Platform (WABA)
Integrações da API Oficial
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
Atualizado