---
title: API oficial vs não oficial do WhatsApp: riscos e custos
description: API oficial ou não oficial do WhatsApp (Z-API, Evolution)? Comparação honesta de risco, custo real, recursos e manutenção, com o que a Meta diz sobre cada uma.
date: 2026-09-06
category: api-oficial
tags: api não oficial whatsapp, api oficial, z-api, evolution api, banimento, cloud api
author: gabriel-miranda
cover: /blog-assets/covers/api-oficial-vs-nao-oficial-whatsapp.jpg
coverAlt: Smartphone e notebook sobre uma superfície de mármore
coverSource: https://www.pexels.com/photo/8217374/
---

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](/blog/api-oficial-do-whatsapp) 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](/blog/embedded-signup-whatsapp) 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](https://faq.whatsapp.com/5957850900902049), 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](/blog/whatsapp-business-bloqueado-o-que-fazer).

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

| Critério | Não oficial (sessão do WhatsApp Web) | Oficial (Cloud API da Meta) |
|---|---|---|
| Como conecta | QR code, como o WhatsApp Web | Login na janela da Meta (Embedded Signup) |
| Quem autoriza | Ninguém; a Meta não reconhece o uso | A Meta, com o número registrado na sua conta do WhatsApp Business |
| Risco de perder o número | Real e sem aviso: é violação das regras | Existe só por conduta (spam, denúncias), com escada de sanções publicada |
| Custo fixo | Mensalidade do provedor por "instância" | Mensalidade do provedor por número (ou por mensagem, dependendo do modelo) |
| Custo por mensagem | Nenhum da Meta, porque a Meta não sabe que você envia | Cobrado pela Meta por mensagem de template entregue; receber é grátis |
| Envio em massa | Tecnicamente livre, na prática o gatilho do bloqueio | Só com mensagem aprovada pela Meta e consentimento do destinatário, dentro da capacidade do número |
| Grupos e status | Sim | Não |
| Mensagem livre para quem nunca escreveu | Sim | Não: fora da janela de 24 horas só template aprovado |
| Estabilidade | Quebra quando o app muda o protocolo | API versionada, com prazo de dois anos por versão |
| Dados dos clientes | Passam pelo servidor de quem mantém a sessão, sem termo da Meta cobrindo o uso | Passam pela Meta e pelo provedor, sob os termos da plataforma e um contrato conhecido |
| Suporte da Meta | Nenhum | Recurso pelo Business Manager em caso de sanção |

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](/blog/whatsapp-business-api-preco).

Hoje, responder um cliente que escreveu para você, dentro da [janela de 24 horas](/blog/janela-de-24-horas-whatsapp), é 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](/#precos).

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](/blog/disparo-em-massa-whatsapp-oficial), 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](/blog/limite-de-mensagens-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](/blog/coexistencia-whatsapp-business-api), 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](/blog/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](/docs/guides/webhooks) mostra o formato, e o [quickstart](/docs/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:

```bash
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](/blog/whatsapp-business-api-n8n-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.

## Perguntas frequentes

### API não oficial do WhatsApp é ilegal?

Não é crime, é violação de contrato. Ao usar o WhatsApp você aceita os termos da Meta, e as Messaging Guidelines proíbem expressamente clientes não oficiais e envio em massa não autorizado. A consequência não é jurídica: é a Meta restringir ou remover o seu acesso, com a possibilidade de barrar o uso de qualquer produto do WhatsApp no futuro. A responsabilidade é do dono do número, mesmo quando a ferramenta é de um terceiro.

### Z-API e Evolution API são oficiais?

Não. As duas pertencem à categoria de ferramentas que emulam uma sessão do WhatsApp Web: a conexão é por QR code, e a Meta não autoriza nem reconhece esse uso. Uma API oficial é a WhatsApp Cloud API da Meta, acessada diretamente ou por um provedor aprovado, como um Tech Provider ou Solution Partner, sempre com o número registrado na sua conta do WhatsApp Business.

### A API oficial é muito mais cara?

Não, e a comparação que diz isso costuma estar desatualizada. A Meta não cobra adesão, mensalidade nem volume mínimo; cobra por mensagem de template entregue, com tarifas publicadas por categoria e país. Um provedor no modelo Tech Provider cobra um valor fixo por número, sem acréscimo por mensagem. O que muda em outubro de 2026 é a cobrança das mensagens de serviço dentro da janela, também por mensagem. Os valores estão em [quanto custa a WhatsApp Business API](/blog/whatsapp-business-api-preco).

### Posso migrar da API não oficial mantendo o número?

Sim, por coexistência. O número continua no app do celular e passa a existir também na Cloud API, com até 6 meses de histórico importados se você aprovar o compartilhamento. A condição é que o número não esteja bloqueado e que o app esteja atualizado. Você perde grupos e listas de transmissão no app e fica com capacidade de 20 mensagens por segundo.

### O que a API oficial não permite fazer?

Grupos, status, listas de transmissão e mensagem livre para quem não escreveu nas últimas 24 horas. Fora da janela só sai mensagem aprovada pela Meta, e só para quem consentiu em receber. A capacidade de envio começa em 250 números únicos por dia e cresce com a qualidade. Essas restrições são da Meta, não do provedor, e são o preço de um número que ela reconhece e protege.

## 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](/#precos) e conecte por coexistência, sem tirar o número do celular. Para quem vai reescrever a integração, o [quickstart da API](/docs/quickstart) mostra a primeira mensagem em três chamadas.