A API Oficial é a WhatsApp Business Platform da Meta, com contrato, cobrança por mensagem e regras públicas. A chamada "API não oficial" não é uma API: são bibliotecas que fazem engenharia reversa do WhatsApp Web para simular um aparelho conectado. Os WhatsApp Business Terms of Service proíbem essa conduta. A API Oficial zera o risco de banimento por automação não autorizada; qualidade, opt-in e política da Meta ainda podem restringir ou degradar o número.
Se você vende pelo WhatsApp no Brasil e já ouviu "API não oficial é mais barata" ou "API oficial é só para empresa grande", este guia organiza o que a documentação da Meta realmente diz (consulta da landing da WizeBot em 13 de julho de 2026) e o que isso muda no dia a dia do seu negócio.
O que é a API Oficial do WhatsApp
A API Oficial faz parte da WhatsApp Business Platform. Na prática, a maioria das empresas usa a Cloud API da Meta: você conecta um número de negócio, autentica na conta Meta Business, envia mensagens dentro das regras e recebe eventos por webhooks.
Com a API Oficial você trabalha com:
- Contrato e termos públicos da Meta
- Cobrança por mensagem (você paga à Meta; na WizeBot não há markup sobre essa tarifa)
- Templates aprovados para iniciar conversas fora da janela de atendimento
- Limites de envio documentados e qualidade do número monitorada
- Possibilidade de Official Business Account (selo azul), quando elegível
Em outras palavras: a automação deixa de ser um atalho fora do contrato e passa a ser uso autorizado da plataforma.
O que a "API não oficial" realmente é
O nome "API não oficial" gera confusão. Não existe uma API alternativa oficializada pela Meta com esse rótulo. O que circula no mercado são bibliotecas e serviços que fazem engenharia reversa do WhatsApp Web (ou fluxo parecido) para manter uma sessão como se fosse o celular do usuário.
Isso costuma aparecer como:
- Conexão por QR Code que "espelha" o WhatsApp Web
- Bots que caem quando a sessão expira ou o aparelho desconecta
- Disparos em massa sem template aprovado nem canal contratual com a Meta
Do ponto de vista técnico, você está simulando um cliente. Do ponto de vista contratual, isso entra no que os Termos do WhatsApp Business descrevem como conduta proibida.
O que os Termos da Meta realmente proíbem
Os WhatsApp Business Terms of Service deixam o ponto explícito. A empresa contratante não pode, direta ou indiretamente, por meios automatizados ou não:
- (e) fazer engenharia reversa de qualquer aspecto dos Business Services, ou fazer algo que possa descobrir o código-fonte
- (g) desenvolver ou usar aplicações que interajam com os Business Services sem consentimento prévio por escrito
- (h) criar software ou APIs que funcionem de forma substancialmente igual aos Business Services
É exatamente o tipo de comportamento que bibliotecas de automação do WhatsApp Web implementam. Em caso de violação, os mesmos Termos indicam que o WhatsApp pode limitar, estrangular, suspender ou encerrar a conta da empresa, conforme o tipo e a circunstância.
Importante ser preciso: a Meta não precisa citar o nome de cada biblioteca em documento oficial. O que existe é a descrição da conduta. Quem afirma que "a Meta bane automaticamente quem usa a biblioteca X" está indo além do que a Meta publicou. O risco contratual e operacional, porém, está no texto.
A Meta processa e usa o que você anuncia como prova
Desde 7 de dezembro de 2019, o WhatsApp afirma que tomará medidas legais contra quem estiver envolvido em abusos que violem os Termos (como envio automatizado ou em massa), mesmo quando a determinação se baseia em informações fora da plataforma.
O texto cita, como exemplo, alegações públicas de empresas sobre a capacidade de usar o WhatsApp de formas que violam os Termos. Em português claro: anunciar disparo em massa fora da API Oficial pode servir de evidência contra o fornecedor e, indiretamente, contra quem contratou.
Isso não é só aviso teórico. Em 4 de outubro de 2022, WhatsApp e Meta processaram as empresas por trás dos apps não oficiais HeyMods, HeyWhatsApp e Highlight Mobi (caso 4:22-cv-05711, Distrito Norte da Califórnia), alegando que levaram mais de 1 milhão de usuários a comprometer as próprias contas para spam comercial. O caso teve sentença em 17 de abril de 2024. Não divulgamos valor de condenação aqui porque a fonte da WizeBot não consolidou o teor financeiro da sentença; o que está confirmado são o número do caso, os réus e as datas.
A Meta também afirma que continua banindo contas com base em classificadores de machine learning. Ou seja: o risco não depende só de "alguém denunciar o QR".
Comparação prática (sem inventar SLA)
Use esta leitura lado a lado. A WizeBot não publica uptime inventado nem "99,9%" para a Cloud API: a Meta não publica SLA de uptime para esse produto na documentação usada nesta pesquisa.
Situação contratual
- API Oficial: contrato com a Meta
- Não oficial: viola as alíneas (e), (g) e (h) dos Business Terms
Risco de banimento por automação não autorizada
- API Oficial: o uso é autorizado; esse risco específico deixa de existir
- Não oficial: a conta pode ser banida temporária ou permanentemente, segundo a central de ajuda sobre apps não oficiais
Exposição a ação judicial da Meta
- API Oficial: nenhuma por esse tipo de uso autorizado
- Não oficial: declarada publicamente desde 07/12/2019
Velocidade de envio (throughput)
- API Oficial: padrão de 80 mensagens por segundo; a documentação da Meta indica possibilidade de upgrade até 1.000 msg/s
- Não oficial: sem garantia documentada; depende de simular um aparelho
Limite de envio
- API Oficial: tiers públicos (veja a seção seguinte)
- Não oficial: não documentado pela Meta
Selo de verificação
- API Oficial: Official Business Account (checkmark azul), quando elegível
- Não oficial: indisponível
Webhooks e qualidade do número
- API Oficial: oficiais, com aviso antes da degradação
- Não oficial: inexistentes no mesmo modelo
Custo
- API Oficial: tarifa por mensagem da Meta + plataforma de automação
- Não oficial: muitas vezes "sem custo de mensagem", mas o custo real é o risco operacional e jurídico
Para aprofundar o mesmo tema na landing da WizeBot, leia também API oficial vs não oficial do WhatsApp.
Limites de envio em 2026 (e o que muita gente ainda erra)
Na API Oficial, o limite de envio responde a esta pergunta: quantos usuários únicos você pode contatar fora da janela de atendimento, em um período móvel de 24 horas.
Os níveis públicos atuais são:
- 250 (padrão para todo business portfolio novo)
- 2.000 (substituiu o antigo tier de 1.000)
- 10.000
- 100.000
- Ilimitado
Dois erros comuns em conteúdos em português:
- Continuar falando do tier de 1.000 (ele não existe mais)
- Tratar o limite como se fosse por número isolado; hoje o limite é por business portfolio
Como chegar a 2.000: completar a verificação de negócio (Business Verification). Alternativamente, entregar 2.000 mensagens fora da janela, para números únicos, em um período móvel de 30 dias, com templates de alta qualidade.
Acima de 2.000, o aumento é automático quando as duas condições acontecem ao mesmo tempo: manter alta qualidade em todos os números e templates, e ter usado pelo menos metade do limite atual nos últimos 7 dias. Atendidas as duas, a Meta sobe um nível em até 6 horas.
Throughput padrão: 80 msg/s, com caminho de upgrade até 1.000 msg/s conforme a documentação da Meta.
Flagged e Restricted não são banimento
Muita gente no mercado mistura três coisas diferentes:
- Banimento por uso de app/automação não autorizada
- Degradação de qualidade do número na API Oficial
- Restrição por política de mensagens (por exemplo, envio sem opt-in)
Na API Oficial, estados como Flagged e Restricted são degradações temporárias de alcance/qualidade, não o mesmo que "número banido para sempre". A diferença prática: regras públicas, sinais medidos e avisos antes de perder alcance.
Por isso a frase correta é esta: a API Oficial elimina o risco de banimento por automação não autorizada. Ela não transforma o número em um canal imune a reclamações, bloqueios ou envio sem consentimento.
Opt-in, qualidade e por que QR/gambiarra dói no ICP
Se o seu time depende de QR Code para "manter o bot no ar", você já conhece a dor:
- Sessão cai no fim de semana e o atendimento para
- Número pessoal misturado com operação comercial
- Medo constante de perda de histórico e de clientes no meio do funil
- Disparo agressivo que gera bloqueio e denúncia
Na API Oficial, o jogo muda para opt-in, qualidade da conversa e templates. Quem pede mensagem e entrega valor tende a manter qualidade alta. Quem compra lista fria e dispara sem contexto tende a cair em restrição, mesmo na Cloud API.
Isso vale para o ICP típico da WizeBot: PME brasileira que quer automação estável, não gambiarra frágil.
Exemplos no Brasil
Infoprodutor (Hotmart, Kiwify e similares)
Recuperação de carrinho abandonado, lembrete de boleto/Pix e onboarding do aluno pedem previsibilidade. Perder o número no meio de um lançamento custa mais do que a assinatura de uma plataforma oficial.
E-commerce (Shopify e lojas próprias)
Status de pedido, pós-venda e remarketing com template aprovado funcionam melhor com webhook e métricas de qualidade do que com sessão de WhatsApp Web.
Atendimento com Pix e boleto
Cobrança e confirmação de pagamento precisam de confiança e continuidade. Um bot que desconecta no QR no horário de pico vira fila, chargeback de reputação e time manual de plantão.
Nesses cenários, a pergunta útil não é "qual biblioteca está na moda", e sim "qual modelo a Meta autoriza e documenta".
Quando migrar e qual é o custo real
Migre quando pelo menos um destes sinais aparecer:
- Seu canal comercial depende de WhatsApp todos os dias
- Você já teve sessão caindo, número instável ou medo de banimento
- Precisa de disparo com template, métricas e escala acima de gambiarra
- Quer separar operação pessoal de operação da empresa
O custo real tem duas camadas:
- Assinatura da plataforma (automação, fluxos, multiatendimento, etc.)
- Mensagens cobradas pela Meta (sem markup da WizeBot)
Na WizeBot, os planos confirmados em 4 de setembro de 2026 em Planos são:
- Básico: R$ 197/mês (anual R$ 148/mês)
- Pro: R$ 297/mês (anual R$ 223/mês)
- Elite: R$ 397/mês (anual R$ 298/mês)
- Instância extra: R$ 97/mês
Sobre tarifas de mensagem da Meta (card de outubro/2026 em BRL), use o post de referência da WizeBot para a tabela completa: marketing R$ 0,3217; utilidade, autenticação e serviço R$ 0,0350; e 1.000 mensagens de serviço grátis por número/mês. Detalhes e contexto em tabela de preços WhatsApp Business API 2026 e na página custo por mensagens.
Como a WizeBot entra nesse cenário
A WizeBot é construída sobre a API Oficial da Meta. Você conecta o seu WABA, opera com regras públicas e usa automação sem depender de QR Code de sessão não autorizada.
Se ainda está comparando caminhos, comece pela landing diferença API oficial vs não oficial, confira preços de mensagem no blog e na calculadora de custos, e tire dúvidas na Central de Ajuda.
Próximo passo
Teste a WizeBot por 7 dias sem cartão em https://v2.wizebot.com.br/sign-up e escolha o plano em https://wizebot.com.br/planos. Vem pra #Wizebot.
