API oficial vs não oficial do WhatsApp: riscos e custos

A diferença entre a API oficial e a não oficial do WhatsApp está em quem autoriza o acesso ao número. Na oficial, é a própria Meta: o número é registrado na WhatsApp Cloud API, com termos, limites e cobrança publicados. Na não oficial, um software emula uma sessão do WhatsApp Web e fala com o WhatsApp como se fosse você no navegador, sem autorização da Meta e em violação das regras dela. O risco da não oficial é perder o número; o custo da oficial é bem menor do que as páginas de comparação costumam dizer.

Este artigo compara as duas por dentro, mostra o que a Meta diz sobre cada uma, desmonta a conta do "custo real" e explica quando ainda faz sentido usar a não oficial e como migrar sem perder o número nem o histórico.

Resposta curta: a diferença em uma frase

A API oficial é um contrato com a Meta. A não oficial é um truque técnico contra a Meta.

Isso soa duro, mas é o que decide tudo o que vem depois. Quando o acesso é autorizado, as regras são conhecidas: o que pode ser enviado, quando, para quem e a que custo. Quando o acesso é emulado, não há regra a cumprir, porque a Meta não reconhece aquele uso. O que existe é uma corrida entre quem detecta e quem disfarça, e o número do seu negócio é a aposta na mesa.

O resto do artigo é o detalhe dessa frase. Se você ainda não conhece a Cloud API, o pilar API oficial do WhatsApp: o que é e como funciona explica o básico; aqui o foco é a comparação.

Como cada uma funciona por dentro

Os dois caminhos entregam o mesmo resultado aparente: um sistema envia e recebe mensagens no WhatsApp. O que muda é a mecânica, e a mecânica é o que define o risco.

Não oficial: sessão do WhatsApp Web emulada

Ferramentas como Z-API, Evolution API e as bibliotecas em que elas se baseiam (Baileys e similares) funcionam como um WhatsApp Web sem navegador. Você escaneia um QR code, como faria no computador, e a partir dali um servidor do provedor mantém aquela sessão aberta. Ele lê o que chega, envia o que você manda e expõe isso para o seu sistema.

Para o WhatsApp, esse servidor é um "dispositivo vinculado" ao seu celular. A Meta não publica nem documenta esse protocolo. Quem o implementa faz engenharia reversa das mensagens que o app troca com os servidores, e toda vez que o app muda, a biblioteca precisa mudar atrás. É por isso que integrações não oficiais param de funcionar de uma hora para outra: não houve mudança no seu código, houve mudança no protocolo que ele imitava.

Três consequências práticas:

• Tudo passa pelo servidor do provedor, inclusive as conversas dos seus clientes, porque é ele que "é" o dispositivo vinculado.
• Não existe limite publicado, o que parece vantagem e não é. Sem limite publicado, o limite real é o ponto em que o sistema de detecção da Meta classifica o número como automação não autorizada.
• Envio para quem nunca falou com você é tecnicamente possível, porque a sessão emulada faz o que um humano faria no celular. É exatamente esse uso que a Meta descreve como "bulk messaging" proibido.

Oficial: Cloud API da Meta, com número registrado e contrato

A WhatsApp Cloud API é o serviço da própria Meta para empresas. O número é registrado numa conta do WhatsApp Business (WABA) dentro do seu portfólio no Business Manager, e o acesso é concedido por você, na janela da Meta, a um app aprovado. Esse app pode ser seu ou de um provedor: o Frame Conexa, por exemplo, é um Meta Tech Provider verificado, e o cliente autoriza o acesso pelo Embedded Signup sem sair do painel.

A partir daí a comunicação é direta com os servidores da Meta, por uma API documentada, versionada e com aviso prévio de mudança. Mensagens chegam por webhook (um aviso HTTP que a Meta manda para o seu sistema a cada evento), assinado para você conferir que veio dela. Envio é uma chamada HTTP com resposta clara: aceito, ou recusado com um código que diz o motivo.

O que muda de verdade em relação à sessão emulada é que a Meta sabe que você existe. Ela sabe qual empresa é dona do número, qual app fala por ele e qual é o histórico de qualidade daquele número. E é essa visibilidade que permite a ela publicar regras em vez de simplesmente bloquear.

Como saber se a API que você usa é oficial

Os sinais são objetivos e não dependem do que o provedor escreve no site:

• Oficial pede login no Facebook, não QR code. A conexão acontece numa janela da Meta, onde você escolhe o portfólio de negócios e o número. Se a integração começa com "escaneie este QR code com o WhatsApp", é sessão emulada.
• Oficial aparece no Business Manager. O provedor consta como parceiro com acesso à sua conta do WhatsApp Business, e você pode remover esse acesso de lá.
• Oficial gera cobrança da Meta. As mensagens de template que você envia aparecem na fatura da sua conta na Meta, com categoria e valor por mensagem. Se ninguém nunca pediu um cartão no Business Manager, não é a Cloud API.
• Oficial tem lista de parceiros pública. A Meta mantém o diretório de Solution Partners e o programa de Tech Providers; o provedor precisa ter passado por Business Verification e App Review.

O que a Meta diz sobre clientes não oficiais

Não é preciso interpretar. As três fontes da própria Meta dizem a mesma coisa, com palavras diferentes.

As WhatsApp Messaging Guidelines proíbem "usar clientes não oficiais, envio em massa, mensagens automáticas, discagem automática ou automação para prejudicar o WhatsApp ou nossos usuários", e listam as sanções: de um aviso à suspensão temporária ou permanente da conta.

A WhatsApp Business Messaging Policy, em português, diz que se você usa ou trabalha com um serviço que usa o WhatsApp e viola os termos, como o envio de mensagens em massa não autorizadas, a Meta tem o direito de restringir ou remover o seu acesso aos serviços do WhatsApp Business. A mesma política avisa que a violação pode custar o acesso a qualquer produto do WhatsApp no futuro. Note o "trabalha com um serviço": a responsabilidade é sua, não do provedor.

A Central de Ajuda do WhatsApp, na página sobre uso não autorizado de mensagens automáticas ou em massa, explica que a detecção combina aprendizado de máquina e denúncias de usuários, e indica a alternativa legítima: a WhatsApp Business Platform, que é o nome comercial da Cloud API.

O que a Meta não publica é uma estatística de banimentos por ferramenta. Qualquer número que você leia sobre "X% dos bloqueios vêm de automação" é de terceiros. O que se pode afirmar, porque está nas páginas dela, é o mecanismo: cliente não oficial é violação por definição, e a punição vai até a perda permanente do número. O que fazer quando isso acontece está em WhatsApp Business bloqueado: o que fazer.

Tabela comparativa: risco, custo, recursos, manutenção e dados

Duas linhas dessa tabela merecem atenção especial. A de envio em massa, porque é o motivo de a maioria escolher a não oficial e é também o motivo de a maioria perder o número. E a de custo por mensagem, porque é onde a comparação costuma ser distorcida.

O custo real: desmontando "R$ 70 por instância x milhares na oficial"

Páginas de comparação de alguns provedores não oficiais ainda apresentam a API oficial como algo caro e burocrático: taxa de adesão de milhares de reais, volume mínimo de milhares de mensagens por mês, contrato com um intermediário. Esse cenário existiu, anos atrás, quando o acesso passava obrigatoriamente por Solution Partners com contrato e crédito. Não é como a Cloud API funciona hoje, e a página de preços da Meta é pública.

O que a Meta cobra de verdade e o que é grátis

A Meta cobra por mensagem de template entregue, em três categorias: marketing, utilidade e autenticação. A tarifa depende da categoria e do país do destinatário. Não há taxa de adesão, não há volume mínimo e não há mensalidade da Meta. Receber mensagem nunca custa nada. Mensagem que a Meta recusa ou não entrega não é cobrada.

Pela tabela publicada pela Meta em setembro de 2026 para destinatário no Brasil, marketing fica na casa de 6 centavos de dólar por mensagem, e utilidade e autenticação abaixo de 1 centavo de dólar. Confira o rate card oficial antes de fazer conta: a tabela é interativa, muda sem aviso e o valor em reais depende da moeda de faturamento da sua conta. Os detalhes, com simulações por tipo de negócio, estão em quanto custa a WhatsApp Business API.

Hoje, responder um cliente que escreveu para você, dentro da janela de 24 horas, é gratuito. Isso muda em 1º de outubro de 2026: a partir dessa data a Meta passa a cobrar por mensagem também as respostas livres dentro da janela e os templates de utilidade enviados dentro dela, pela tarifa de utilidade do país do destinatário. Um artigo que compare custos sem citar essa data envelhece em semanas.

Atenção: vários provedores repetem que haverá uma franquia mensal de mensagens de serviço gratuitas antes dessa cobrança. A página oficial da Meta não menciona franquia nenhuma. Não conte com ela no orçamento até o rate card de outubro confirmar.

Preço fixo por número, sem acréscimo: o modelo do Tech Provider

A outra metade da conta é o que o provedor cobra. Aqui há dois modelos. O Solution Partner fatura o cliente diretamente, com linha de crédito da Meta, e por isso costuma cobrar um acréscimo por mensagem. O Tech Provider não pode fazer isso: pela regra da Meta, o cliente de um Tech Provider cadastra o próprio meio de pagamento na conta do WhatsApp Business e paga a Meta direto. O provedor cobra só pelo software.

É o modelo do Frame Conexa: um valor fixo por número por mês, sem nenhuma cobrança por mensagem da nossa parte, e a fatura da Meta chega para você, no Business Manager, com o preço de tabela dela. Não existe markup sobre a mensagem porque não existe como colocar um. Os planos estão em preços por número.

Compare com a "instância" de R$ 70 da não oficial. O valor fixo é parecido. A diferença é que, do lado oficial, o mesmo dinheiro compra um número que a Meta reconhece, com limite publicado, histórico de qualidade, recurso em caso de sanção e um caminho de crescimento. Do lado não oficial, compra uma sessão que pode acabar amanhã sem aviso, levando o número junto.

O que a API oficial não faz

Seria desonesto fingir que a oficial faz tudo o que a sessão emulada faz. Ela não faz, de propósito, e é bom saber antes de migrar.

• Grupos. A Cloud API não cria, não entra e não envia para grupos. Em coexistência, o app do celular também perde a função de grupos.
• Status. Não há como publicar status pela API.
• Listas de transmissão do app. Em coexistência, as listas existentes ficam somente leitura. O envio em massa na oficial é por campanha com mensagem aprovada, que é outro mecanismo.
• Mensagem livre para quem nunca escreveu. Fora da janela de 24 horas, só template aprovado pela Meta. Mandar "oi, tudo bem?" para uma lista fria é recusado com o erro 131047 antes de sair.
• Envio sem consentimento. A política da Meta exige que a pessoa tenha dado o número e concordado em receber mensagens. Isso é regra da plataforma, e o provedor oficial não tem como abrir exceção.
• Volume ilimitado no primeiro dia. Cada conta começa com uma capacidade de envio para 250 números únicos em 24 horas, que a Meta sobe conforme a qualidade e o uso. O que faz esse limite crescer está em limite de mensagens da WhatsApp Business API.

No Frame Conexa, o que existe é o que a API entrega: conversas com a janela sinalizada, campanhas com pausa automática quando a qualidade cai, público com segmentos, templates, webhooks e API REST. Não há chatbot pronto, catálogo, chamadas de voz nem multiatendimento com vários atendentes. Se o seu uso depende de algum desses itens, um CRM ou plataforma de atendimento parceira se conecta por cima da API.

Quando a não oficial ainda faz sentido e quando é imprudência

Não é todo uso que justifica o custo de conformidade da oficial, e dizer o contrário seria venda, não análise.

A sessão emulada faz sentido quando o número não vale nada para o negócio: um script pessoal para avisar você mesmo de algo, um protótipo para testar uma ideia por uma semana, um projeto de estudo. Faz sentido também quando a funcionalidade não existe na oficial, como ler o que acontece num grupo, desde que o número seja descartável e as pessoas do grupo saibam o que está rodando.

Vira imprudência quando:

• O número é o número principal do negócio, com anos de conversas, clientes que só têm aquele contato e presença em cartão de visita, fachada e anúncio.
• O uso é envio em massa para quem não pediu. Esse é o uso que a Meta descreve, palavra por palavra, como proibido. Não é uma zona cinzenta.
• Os dados dos clientes importam. Conversas de pacientes, alunos ou compradores passando por um servidor que emula uma sessão, sem nenhum termo da Meta cobrindo esse tratamento, é um problema de proteção de dados que o dono do negócio responde sozinho.
• Você constrói integração em cima. CRM, agenda, automação de vendas. Cada mudança de protocolo quebra a base do que você montou, e a queda nunca avisa.

A pergunta que resolve a maioria dos casos é simples: se este número sumisse amanhã, o que aconteceria com o negócio? Se a resposta for "nada", a não oficial pode servir. Se for qualquer outra coisa, a discussão sobre custo perdeu o sentido.

Como migrar sem perder o número nem o histórico

O medo mais comum de quem usa a não oficial é a migração: "vou ter que tirar o número do celular e perder tudo". Não é mais assim desde que a Meta liberou a coexistência.

O que a coexistência muda

Na coexistência, o mesmo número continua no app WhatsApp Business do celular e passa a existir também na Cloud API. Você segue atendendo pelo celular; o sistema atende pela API; as duas coisas convivem. Se o dono do número aprovar o compartilhamento na hora da conexão, a Meta envia ao provedor as mensagens dos últimos 180 dias, em fases, e a lista de contatos. É o histórico de 6 meses que aparece no painel no dia seguinte.

Há limites que valem a pena conhecer antes: o número em coexistência tem capacidade fixa de 20 mensagens por segundo, o app perde grupos e listas de transmissão, e o celular precisa continuar ativo, senão a integração é desligada depois de cerca de 14 dias sem uso.

Os passos, na ordem

1. Encerre a sessão da ferramenta não oficial. No app, em Dispositivos conectados, remova o dispositivo do provedor. Não é uma exigência documentada da Meta, mas evita duas automações respondendo a mesma conversa durante a troca.
2. Confira o app. A coexistência exige o WhatsApp Business atualizado e um número que não esteja bloqueado. Número banido não entra na API oficial; se for o seu caso, o caminho é o recurso, descrito em WhatsApp Business bloqueado: o que fazer.
3. Tenha um portfólio de negócios na Meta. É a conta do Business Manager. Se não existir, a janela de conexão cria uma.
4. Conecte pelo Embedded Signup. No Frame Conexa é o botão "Conectar WhatsApp" do painel, ou um link de conexão que você manda para quem tem o celular em mãos. Você entra com o Facebook, escolhe o número e aprova o compartilhamento do histórico. Sem QR code.
5. Cadastre o meio de pagamento na Meta. Como Tech Provider, o Frame Conexa não pode fazer isso por você. Sem cartão no Business Manager, o número conecta, responde dentro da janela, mas não dispara template. O painel avisa e leva ao lugar certo.
6. Aponte a integração para a API oficial. Se você tinha um sistema falando com a não oficial, o trabalho é trocar o destino: o envio vira uma chamada REST com token e o recebimento vira um webhook assinado. O guia de webhooks mostra o formato, e o quickstart envia a primeira mensagem em minutos.

Um exemplo do que muda no código. Na oficial, o envio é isto, e a resposta diz na hora se foi aceito:

curl -X POST https://frameconexa.com/api/v1/instances/$FRAME_CONEXA_INSTANCE_ID/messages \
  -H "Authorization: Bearer fc_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"to":"5585999990000","type":"text","text":{"body":"Olá! Recebemos seu pedido."}}'

Se a pessoa não escreveu nas últimas 24 horas, essa chamada volta com o código 131047 da Meta, e o sistema sabe que precisa usar um template aprovado. Na não oficial, a mesma mensagem sairia sem aviso, e a única resposta possível viria dias depois, na forma de um número bloqueado.

Quem automatiza por ferramenta visual encontra o mesmo caminho em WhatsApp Business API no n8n e Make, com os fluxos prontos para trocar a origem.

Dica: migre o número principal primeiro e mantenha a base de contatos limpa. A capacidade de envio da conta nova começa em 250 números por dia e sobe com qualidade; um envio em massa para uma lista fria na primeira semana é o jeito mais rápido de começar a vida oficial com o número marcado.

Próximo passo

Se o número importa para o negócio, a decisão já está tomada; o que falta é o caminho. Veja os planos por número e conecte por coexistência, sem tirar o número do celular. Para quem vai reescrever a integração, o quickstart da API mostra a primeira mensagem em três chamadas.