API Oficial vs API Não Oficial do WhatsApp: Comparativo 2026

Quem pesquisa API oficial vs API não oficial do WhatsApp quase sempre está diante da mesma escolha: uma ferramenta que conecta o número lendo um QR code, barata e pronta em minutos, ou a Cloud API da Meta, que exige verificação e cobra por mensagem. Este comparativo mostra o que muda por baixo, onde está o risco e quando cada caminho faz sentido.

TL;DR

• API oficial é a WhatsApp Business Platform (Cloud API), operada pela própria Meta. A empresa é verificada, as mensagens ativas usam templates aprovados e não existe risco de bloqueio por usar a integração.
• API não oficial é qualquer solução que conecta o número pelo protocolo do WhatsApp Web, lendo um QR code: Z-API, uazapi, WPPConnect, Baileys e o modo WhatsApp Web da Evolution API.
• A não oficial é mais barata e mais rápida de ligar, mas a Meta não autoriza esse uso. O número pode ser restrito ou banido, e a integração cai quando o WhatsApp Web muda.
• Para atendimento, vendas e cobrança de uma operação que não pode parar, a oficial é a escolha. A não oficial só se sustenta em teste, uso pessoal ou volume muito baixo, aceitando perder o número.

O que é a API oficial do WhatsApp

A API oficial é a WhatsApp Business Platform, hoje servida pela Cloud API hospedada pela Meta. A empresa conecta um número a uma conta do WhatsApp Business (WABA) dentro do Gerenciador de Negócios, passa pela verificação e usa a API documentada pela própria Meta. O guia completo está em WhatsApp Cloud API: guia completo da API oficial.

As regras que valem na prática:

1. Mensagens que a empresa inicia usam templates aprovados (marketing, utilidade ou autenticação).
2. Quando o cliente escreve, abre-se uma janela de 24 horas para respostas livres.
3. A Meta cobra por mensagem entregue. Desde 1º de outubro de 2026 as mensagens de serviço também são cobradas, com 1.000 grátis por número por mês. Os valores em reais estão em mensagens de serviço: a cobrança começou.

Você não precisa abandonar o celular: o modo de coexistência permite usar o app WhatsApp Business e a API oficial no mesmo número.

O que é uma API não oficial do WhatsApp

Uma API não oficial não fala com a Meta como integradora. Ela abre uma sessão de WhatsApp Web, como se fosse mais um navegador conectado ao seu número, e transforma essa sessão em uma API HTTP. Por isso a conexão é feita lendo um QR code.

São desse tipo:

• Z-API e uazapi: serviços comerciais que conectam o número por QR code.
• WPPConnect e Baileys: bibliotecas de código aberto que implementam o protocolo do WhatsApp Web.
• Evolution API: projeto de código aberto com dois modos. O modo baseado no WhatsApp Web (Baileys) é não oficial; o modo conectado à Cloud API usa a API oficial da Meta.

A pergunta "a Z-API é oficial?" tem resposta direta: não. Conectar por QR code é o sinal mais simples de que a integração não passa pela plataforma oficial.

Comparativo lado a lado

Critério	API oficial (Cloud API)	API não oficial (QR code)
Quem opera	Meta	Fornecedor da ferramenta, sobre o WhatsApp Web
Autorização da Meta	Sim	Não
Como conecta	Número vinculado a uma WABA verificada	Leitura de QR code
Risco de bloqueio pela integração	Não há	Existe e cresce com volume e disparos
Estabilidade	Não depende do WhatsApp Web	Cai quando o WhatsApp Web muda ou o celular desconecta
Mensagens ativas	Templates aprovados	Texto livre, sem controle
Custo de mensagens	Cobradas pela Meta, por mensagem	Sem cobrança da Meta
Botões, listas e fluxos	Recursos oficiais	Limitados ou instáveis
Selo e nome verificado	Disponível	Não
Multiatendente e várias integrações	Sim, sem depender do celular	Depende da sessão ativa

Onde está o risco de verdade

O risco de uma API não oficial não é teórico. A sessão do WhatsApp Web não foi feita para automação, e os termos do WhatsApp não autorizam acesso automatizado por clientes não oficiais. Na prática, três coisas acontecem:

1. Bloqueio do número. Disparos em volume, respostas instantâneas em série e muitos contatos novos são exatamente o padrão que a Meta procura. Detalhamos isso em WhatsApp bloqueado: a API oficial é a única saída.
2. Queda silenciosa. Uma atualização do WhatsApp Web ou um celular sem bateria derruba a sessão, e o bot para de responder sem aviso.
3. Sem recurso. Se o número cair, não há suporte da Meta para pedir revisão de uma integração que ela não reconhece.

O custo de mensagens que a não oficial "economiza" costuma ser menor que o custo de um dia de atendimento parado ou de perder o número que está nos cartões, no Google e nos anúncios.

Quanto custa cada uma

Na não oficial, você paga a mensalidade da ferramenta e não paga a Meta. Na oficial, há duas contas:

• Plataforma (a ferramenta que dá a caixa de entrada, o chatbot e os relatórios).
• Mensagens da Meta, cobradas por mensagem entregue. No Brasil, a referência é de ~R$ 0,32 por mensagem de marketing e ~R$ 0,035 por mensagem de utilidade, autenticação ou serviço (estas com 1.000 grátis por número ao mês).

O ponto de atenção é o markup: muitas plataformas revendem a mensagem da Meta com margem. Vale perguntar se o preço repassado é o da tabela da Meta. Explicamos como identificar em markup nas mensagens do WhatsApp.

Quando cada opção faz sentido

A API não oficial pode servir quando:

• é um teste ou protótipo;
• o número é descartável e não está ligado à marca;
• o volume é baixo e perder o número não para a empresa.

A API oficial é a escolha quando:

• o número é o canal de vendas, atendimento ou cobrança;
• você roda anúncios que levam ao WhatsApp;
• há mais de uma pessoa atendendo;
• você precisa de templates, botões e relatórios confiáveis;
• LGPD e auditoria importam.

Como migrar da não oficial para a oficial

1. Desconecte a sessão de WhatsApp Web da ferramenta não oficial.
2. Escolha entre migrar o número para a API ou usar o modo de coexistência e manter o app no celular.
3. Crie ou verifique o Gerenciador de Negócios da Meta e a conta do WhatsApp Business.
4. Cadastre e aprove os templates que você já usava como texto livre.
5. Reconfigure chatbot, filas e integrações na plataforma oficial.

Em operações de PME o processo costuma levar de 5 a 7 dias úteis, a maior parte esperando verificação e aprovação de templates.

Como a Agathas resolve isso

O Voyia é a plataforma da Agathas Web para a API oficial do WhatsApp: caixa de entrada multiatendente, chatbot, disparos segmentados com templates aprovados, integração com IA usando a sua própria chave e relatórios. As tarifas da Meta são repassadas sem markup, em reais, e o modo de coexistência é suportado.

Os planos começam em R$ 149 por mês por número, sem fidelidade. A tabela completa, com o que entra em cada plano, está na página do Voyia. Se você usa hoje uma API não oficial e quer migrar sem perder o número, a equipe faz a migração com você.

Conclusão

A escolha entre API oficial e não oficial do WhatsApp é uma escolha entre custo baixo com risco e custo previsível com segurança. Para qualquer número que sustenta vendas ou atendimento, o risco de bloqueio da não oficial pesa mais que a economia nas mensagens. Se o WhatsApp já é canal de receita, o caminho é a API oficial com o Voyia.