Comparativo
Evolution API ou API oficial do WhatsApp: qual usar em 2026
A Evolution API é um projeto open source que conecta o WhatsApp de dois jeitos: pelo QR code do WhatsApp Web, sem tarifa da Meta e com risco de bloqueio do número, ou pela Cloud API oficial, com tarifa por mensagem. Na oficial, a diferença entre Evolution e Omnique está em quem monta e mantém app, token e webhook.
Por Gustavo Calixto, fundador do Omnique. Atualizado em .
A Evolution API é oficial?
Não. A Evolution API é um projeto open source, sem vínculo com a Meta. Ela conecta o WhatsApp de dois jeitos: pelo QR code, imitando o WhatsApp Web com a biblioteca Baileys, que é o caminho não oficial; ou pela Cloud API, que é a API oficial da Meta. O risco e o custo mudam conforme o modo.
O projeto é popular: o repositório no GitHub tinha 9.778 estrelas e 7.335 forks em 6 de outubro de 2026. Popularidade não muda a regra do WhatsApp. O que coloca o seu número dentro ou fora das regras é o tipo de conexão, não a ferramenta que fica no meio.
Evolution API x API oficial: resumo em uma tabela
São três caminhos, não dois. A Evolution pelo QR não paga a Meta, mas opera fora dos termos do WhatsApp. A Evolution com a Cloud API e o Omnique usam a mesma API oficial e pagam a mesma tarifa por mensagem. Entre esses dois, muda quem cria o app na Meta, guarda o token e cuida do webhook.
| Evolution pelo QR | Evolution com a Cloud API | Omnique | |
|---|---|---|---|
| Conexão | WhatsApp Web, não oficial | Cloud API da Meta, oficial | Cloud API da Meta, oficial, como Provedor de Tecnologia da Meta |
| Como o número entra | Lendo o QR code | Você cria o app na Meta, gera um token permanente e informa o ID do número e o ID da conta | Login do Facebook dentro do painel (Cadastro Incorporado), sem criar app |
| Preço da ferramenta | Grátis, mais o servidor | Grátis, mais o servidor | R$ 50 por número no mês de 1 a 4 números, caindo até R$ 33 |
| Servidor | Seu | Seu | Nosso, em São Paulo |
| Tarifa por mensagem | Nenhuma da Meta | Tarifa da Meta | Tarifa da Meta, paga direto à Meta no seu cartão |
| Risco para o número | Alto: conexão fora dos termos do WhatsApp | Regras de qualidade da Meta | Regras de qualidade da Meta |
| Webhook para o seu sistema | Você configura e mantém | Você configura e mantém | Fila, retentativa, delivery_id, assinatura HMAC, log por entrega e reenvio |
| Grupos | Sim | Regra da Meta: só conta comercial oficial, até 8 participantes | Não: mensagem de grupo não chega ao webhook |
| Suporte | Comunidade | Comunidade | Em português, por ticket |
| Teste | Livre | Livre | 3 dias grátis, 1 número, sem cartão |
Tarifa da Meta: tabela em reais vigente desde 1/10/2026. Grupos: API de Grupos da Meta. Passos da Evolution com a Cloud API: documentação oficial do projeto. Tudo consultado em 6/10/2026.
Por que a Evolution pelo QR derruba números?
Porque a conexão pelo QR usa o WhatsApp de um jeito que os termos não autorizam. Os Termos de Serviço do WhatsApp proíbem acessar o serviço por meios automatizados não permitidos e oferecer a terceiros software ou API que faça a mesma função sem autorização. Quem bloqueia é o WhatsApp, e o bloqueio pode vir logo depois de conectar.
Isso vale para qualquer API desse tipo, não só para a Evolution. No próprio GitHub do projeto há relatos de números derrubados só de ler o QR code (issue 2497, abril de 2026) e de bloqueios em série durante envio em massa e até no aquecimento do chip (issue 1870, aberta desde agosto de 2025).
Para quem atende cliente de agência, o bloqueio custa mais que o chip: é histórico perdido, cliente sem resposta e reconexão no meio do expediente. Se já aconteceu com você, o guia número banido no WhatsApp: o que fazer mostra os próximos passos.
A Evolution pelo QR é estável?
Depende de coisas fora do seu controle. A sessão pelo QR vive enquanto o WhatsApp aceita aquela conexão como um aparelho ligado. Quando ela cai, alguém precisa ler o QR de novo, e o seu fluxo para até lá. Na Cloud API não existe sessão de aparelho: a Meta entrega cada evento por webhook.
Na oficial, a estabilidade passa a depender de outra peça: o webhook. Se o seu servidor sai do ar, os eventos precisam ser guardados e entregues de novo, sem duplicar. Na Evolution com a Cloud API, isso fica com você. No Omnique, cada evento entra numa fila durável, ganha retentativa automática e um delivery_id para o seu sistema descartar repetição, e aparece no log de entregas com opção de reenvio. O guia de webhook do WhatsApp Cloud API explica esse desenho.
Quanto custa cada caminho?
Pelo QR, a Meta não cobra nada, mas você paga servidor, chips e o tempo de quem mantém. Na oficial, a Meta cobra por mensagem entregue. No Brasil, desde 1/10/2026, são R$ 0,3217 por mensagem de marketing e R$ 0,035 por utilidade e autenticação. A resposta dentro da janela de 24 horas tem 1.000 grátis por número por mês e custa R$ 0,035 da 1.001ª em diante.
| Uso no mês | Evolution pelo QR | Evolution com a Cloud API | Omnique, 1 número |
|---|---|---|---|
| Agente de IA com 2 mil respostas (1.000 grátis) | Servidor | R$ 35 na Meta + servidor | R$ 35 na Meta + R$ 50 = R$ 85 |
| 10 mil avisos e cobranças (utilidade) | Servidor + os chips que aguentarem o volume | R$ 350 na Meta + servidor | R$ 350 + R$ 50 = R$ 400 |
| 10 mil mensagens de marketing | Servidor + os chips que aguentarem o volume | R$ 3.217 na Meta + servidor | R$ 3.217 + R$ 50 = R$ 3.267 |
Servidor: a Wafly estima uma VPS de US$ 6 a 7 por mês para a Evolution, uns R$ 30 a 35 pelo dólar PTAX de 5/10/2026 (R$ 4,9859). Some a isso as horas de instalação, atualização e reconexão, que costumam pesar mais que a VPS.
Leitura honesta: em campanha de marketing, o QR sai mais barato enquanto os chips aguentam. Em atendimento e agente de IA, as primeiras 1.000 respostas do mês em cada número são grátis; em aviso e cobrança, a oficial custa R$ 0,035 por mensagem. Nos dois casos, o número fica. Duas regras da Meta ajudam a conta: só a mensagem entregue é cobrada, e a conversa que chega por anúncio de clique para o WhatsApp, respondida em até 24 horas, abre uma janela sem cobrança que pode ficar aberta por até 7 dias. Os valores do Omnique por volume estão em preços.
Evolution com a Cloud API ou Omnique?
Se você já roda a Evolution, gosta de manter o próprio servidor e tem tempo para configurar o app na Meta, dá para ir para a oficial sem sair dela. É um caminho legítimo e sem mensalidade. O Omnique faz sentido quando montar e manter essa camada custa mais do que R$ 50 por número.
Pela documentação da Evolution, o modo Cloud API pede: Business Manager com a empresa verificada, um app no painel de desenvolvedores da Meta com o WhatsApp adicionado, o número cadastrado e verificado nesse app, um token permanente do administrador e o webhook da Meta apontado para o seu servidor. Para atender números de clientes com um app só, você precisa virar Tech Provider. Os guias WhatsApp Cloud API: como configurar e como virar Tech Provider da Meta mostram cada etapa.
O Omnique faz sentido quando:
- você conecta números de clientes e não quer criar e manter app, token e webhook para cada um;
- o seu fluxo no n8n não pode perder nem processar duas vezes a mesma mensagem, e você quer ver no log o que aconteceu com cada entrega e reenviar quando o seu servidor caiu;
- você quer o mesmo número no app do celular e na API (coexistência), com o eco do celular chegando no seu sistema;
- você usa Chatwoot e quer áudio, mídia e resposta do agente funcionando sem ajuste;
- você também quer o Instagram na mesma chave de API.
Quando cada caminho faz sentido?
A escolha depende de quanto custa perder o número e de quem vai manter a infraestrutura. Projeto pessoal tolera o QR. Dev com um ou dois números próprios se vira bem na Evolution com a Cloud API. Agência e freela com números de clientes ganham tempo deixando a camada da Meta com um provedor.
| Fica na Evolution pelo QR | Vai para a Evolution com a Cloud API | Vai para o Omnique |
|---|---|---|
| Projeto pessoal ou de teste; uso pesado de grupos; aceita o risco de perder o número | Dev que prefere hospedar tudo e mantém um ou dois números próprios | Agência ou freela com números de clientes; fluxo de n8n que não pode perder evento; quem não quer manter servidor |
Como migrar da Evolution para a API oficial?
A migração é menor do que parece, porque o seu fluxo continua no mesmo lugar. Você troca a porta de entrada e de saída do WhatsApp, cria os templates do que manda fora da janela de 24 horas e respeita o limite inicial de envio da Meta. Com o Omnique, são cinco passos.
- Separe o que a Meta pede: conta do Facebook, portfólio empresarial e o número. Se ele está no app WhatsApp Business 2.24.17 ou mais novo, dá para conectar com coexistência e manter o app no celular.
- Crie a conta no Omnique e conecte o número pelo login do Facebook, dentro do painel.
- No n8n, troque o nó da Evolution por um Webhook (receber) e um HTTP Request (enviar), ou importe um dos 4 fluxos prontos da página API oficial do WhatsApp no n8n.
- Crie os templates das mensagens que você manda fora da janela de 24 horas.
- Planeje o volume: um portfólio novo começa com 250 destinatários únicos a cada 24 horas fora da janela de atendimento. Verificar a empresa é um dos caminhos para subir para 2 mil, e depois a Meta sobe o limite sozinha conforme a qualidade e o uso.
O teste grátis dura 3 dias, com 1 número e sem cartão, o que basta para validar o fluxo inteiro antes de mexer no número principal. Para entender a API oficial do começo, o guia como usar a API oficial do WhatsApp junta todos os passos, e a documentação traz os exemplos de envio e de webhook.