API oficial vs API não oficial do WhatsApp
A API oficial é a WhatsApp Cloud API da Meta, acessada pela própria Meta ou por parceiros como Tech Providers; a não oficial conecta o número imitando o WhatsApp Web, em geral lendo um QR code. Os termos do app WhatsApp Business proíbem usar aplicativos que interajam com o serviço sem consentimento por escrito da Meta, e as diretrizes citam "clientes não oficiais" e "automação" entre as condutas que levam a restrição. A não oficial costuma ser mais barata e não paga tarifa por mensagem; a oficial cobra mensagens pela tabela da Meta, mas tem regras claras, limites publicados e suporte. Nenhuma das duas impede bloqueio de quem viola as políticas.
Atualizado em
O que é API oficial e API não oficial do WhatsApp?
API oficial: a WhatsApp Business Platform, hoje na forma da Cloud API, hospedada pela Meta. A empresa conecta o número pelo cadastro da Meta, aceita os termos da plataforma e envia mensagens por uma API documentada. Pode fazer isso direto ou por um parceiro da Meta, como um Tech Provider.
API não oficial: um serviço que conecta o número como se fosse um navegador com o WhatsApp Web aberto, normalmente lendo um QR code. O software lê e envia mensagens por essa sessão. Não há contrato com a Meta para esse uso.
O que os termos da Meta dizem sobre conexões não oficiais?
Três documentos oficiais tratam do assunto:
- Termos do app WhatsApp Business: a empresa não pode, diretamente ou por automação, "develop or use any applications that interact with our Business App Services without our prior written consent" (desenvolver ou usar aplicativos que interajam com o serviço sem consentimento prévio por escrito). Os mesmos termos permitem ao WhatsApp limitar, suspender ou encerrar contas que os violem.
- Diretrizes de mensagens do WhatsApp: entre os comportamentos abusivos estão usar "unofficial clients, bulk messaging, auto-messaging, auto-dialing, or automation to harm WhatsApp or our users" (clientes não oficiais, mensagens em massa, mensagens automáticas ou automação para prejudicar o WhatsApp ou os usuários).
- Política de mensagens comerciais: vale para quem usa a plataforma oficial e prevê limitar ou remover o acesso de quem a viola.
Ou seja: a conexão não oficial depende de um uso que os termos do app não autorizam. A oficial é o caminho previsto pela Meta, mas também tem regras e punições.
A API oficial evita o bloqueio do número?
Reduz o risco ligado ao tipo de conexão, mas não elimina o bloqueio. A Meta publica uma escala de punições para a plataforma oficial: avisos, bloqueios temporários de envio de templates ou de todas as mensagens, travamento da conta e, em último caso, desativação. Violações graves, como golpes, podem levar à remoção imediata. Enviar mensagem sem consentimento ou gerar muitas denúncias leva a restrições em qualquer rota.
A diferença é que, na oficial, as regras e os limites estão escritos, há notificação de violações por webhook e existe pedido de revisão. Na não oficial, não há esse canal.
Comparação lado a lado
| API oficial (Cloud API) | API não oficial (sessão do WhatsApp Web) | |
|---|---|---|
| Previsto nos termos da Meta | ✓ | ✗ os termos do app proíbem aplicativos que interajam com o serviço sem consentimento por escrito |
| Como conecta | Cadastro da Meta (Embedded Signup) | QR code, como o WhatsApp Web |
| Custo por mensagem | Tabela da Meta, por categoria e país | Sem tarifa da Meta; depende do fornecedor |
| Limites publicados | ✓ vazão e limite de destinatários documentados | Não há limites oficiais |
| Templates e janela de 24h | Obrigatórios para iniciar conversa fora da janela | Não se aplicam |
| Grupos | Groups API para contas oficiais; não disponível para números do app em coexistência | Depende do fornecedor |
| Mudanças da Meta | Anunciadas no changelog oficial | Dependem do funcionamento do WhatsApp Web; mudanças nele podem afetar a conexão |
| Suporte e contestação | Canal de revisão e notificações de violação | Não há canal com a Meta |
Qual é mais estável?
Na oficial, a Meta documenta a vazão: até 80 mensagens por segundo por número por padrão, podendo subir até 1.000. Números em coexistência com o app têm vazão fixa de 20 por segundo. O limite de destinatários fora da janela de atendimento começa em 250 por dia e sobe com o uso. Mudanças vêm em changelog.
Na não oficial, o serviço depende de como o WhatsApp Web funciona naquele momento. Quando a Meta muda o login, a criptografia ou a detecção de automação, a conexão pode cair até o fornecedor se adaptar.
Quando cada uma faz sentido?
A não oficial pode fazer sentido para testes, uso pessoal, protótipos ou quando grupos são essenciais e você aceita o risco dos termos.
A oficial faz mais sentido quando o número é importante para o negócio, quando há equipe e IA atendendo, quando você precisa de previsibilidade e quando a empresa tem exigências de conformidade, como a LGPD.
Com a coexistência, você tem a API oficial sem abandonar o app do celular. Veja também como funciona a API oficial do WhatsApp, WhatsApp Business app vs API e os preços da FlashConnect.
Fontes
Os fatos sobre outras empresas e sobre a Meta saem das páginas oficiais abaixo, na data indicada. Preços e recursos mudam: confira na fonte antes de decidir. Se algo aqui estiver desatualizado, avise pelo WhatsApp que corrigimos.
- WhatsApp: Terms for WhatsApp Business App (acesso em 23/10/2026)
- WhatsApp: Messaging Guidelines (acesso em 23/10/2026)
- WhatsApp Business Messaging Policy (acesso em 23/10/2026)
- Meta for Developers: Policy and spam enforcement (acesso em 23/10/2026)
- Meta for Developers: Throughput (acesso em 23/10/2026)
- Meta for Developers: Messaging limits (acesso em 23/10/2026)
- Meta for Developers: Groups API (acesso em 23/10/2026)
- Meta for Developers: Onboard WhatsApp Business app users (coexistência) (acesso em 23/10/2026)
- Meta for Developers: Pricing on the WhatsApp Business Platform (acesso em 23/10/2026)
- Meta for Developers: pricing updates for service and utility messages (acesso em 23/10/2026)
Perguntas frequentes
API não oficial do WhatsApp é proibida?
Os termos do app WhatsApp Business proíbem desenvolver ou usar aplicativos que interajam com o serviço sem consentimento prévio por escrito da Meta, e as diretrizes citam clientes não oficiais entre os comportamentos abusivos. O WhatsApp pode limitar, suspender ou encerrar contas que violem os termos.
Com a API oficial meu número nunca é bloqueado?
Não. A API oficial reduz o risco ligado ao tipo de conexão, mas a Meta restringe e bloqueia quem viola as políticas, por exemplo enviando mensagem sem consentimento ou recebendo muitas denúncias. A punição vai de avisos a bloqueios temporários e desativação.
Por que a API oficial cobra por mensagem?
A Meta cobra as mensagens da plataforma oficial conforme a categoria e o país, pela tabela publicada por ela. Desde 1º de outubro de 2026, segundo a Meta, as mensagens de atendimento também passaram a ser cobradas, com 1.000 gratuitas por número por mês.
Dá para usar grupos com a API oficial?
A Meta tem a Groups API para contas oficiais, mas ela não está disponível para números que também estão no app WhatsApp Business. Em coexistência, os grupos não passam pela API.
Como saber se um serviço usa a API oficial?
Na oficial, a conexão é feita pelo cadastro da Meta, com login no Facebook, e o número aparece no Gerenciador do WhatsApp da sua empresa. Se a conexão é só ler um QR code como no WhatsApp Web, é uma sessão não oficial.
A FlashConnect usa a API oficial?
Sim. A FlashConnect é Tech Provider da Meta, com App Review aprovado em 3 de outubro de 2026, e conecta o número pela WhatsApp Cloud API, com coexistência para manter o app no celular.
Quer usar a FlashConnect?
O acesso está sendo liberado por convite. Fale com a gente no WhatsApp.
Pedir convite no WhatsApp