WhatsApp · 5 de setembro de 2026

Evolution API WhatsApp vs API oficial da Meta

Evolution API vs Cloud API / WABA: risco, setup, templates e quando migrar — comparativo honesto e como a Treffen cobre os dois caminhos.

Por Equipe Treffen · Atualizado em 7 de setembro de 2026

Neste artigo

No Brasil, “API de WhatsApp” misturou Evolution API (e pares do ecossistema) com a API oficial da Meta. As duas aparecem em propostas comerciais. Esta página compara com honestidade: velocidade e preço de entrada de um lado; previsibilidade e política Meta do outro — e onde a Treffen se posiciona.

Resumo rápido

  • Evolution ≠ API oficial; é stack do ecossistema não oficial (sessão Web).
  • Oficial (WABA/Cloud API): templates, Quality Rating, cobrança Meta/BSP.
  • Não oficial: entrada rápida; risco de ban e queda de sessão.
  • Treffen cobre os dois caminhos na mesma caixa — migração sem trocar de marca.
  • Decisão guiada: quiz: preciso de WABA.
Evolution API (QR / sessão) versus API oficial WABA com templates
Esquerda: QR e sessão Web. Direita: WABA, templates e política Meta. A caixa Treffen cobre os dois.

O que é Evolution API (no contexto de comprador)

Evolution API é uma stack popular no ecossistema não oficial: sobe instâncias, conecta número (tipicamente via sessão Web / QR) e expõe endpoints para bots e CRMs. Serve para provar valor rápido — caixa, bot, integrações — sem passar pelo onboarding completo de WABA.

Não é um produto da Meta. Não há Quality Rating oficial, templates aprovados no modelo Cloud API nem ticket na WhatsApp Business Platform. Baileys, Z-API, Uazapi e similares ocupam o mesmo saco operacional: sessão do WhatsApp Web encapsulada.

Na proposta comercial, “Evolution” quase sempre significa: o time de TI (ou a agência) sobe um servidor, lê um QR, aponta o webhook para o bot. Funciona até não funcionar. O comprador precisa saber que está comprando velocidade, não contrato Meta. Se a agência esconde isso, peça por escrito: oficial ou sessão Web?

Peça também quem opera o servidor: vocês, a agência, um VPS barato. Queda de instância é queda de WhatsApp. Isso não aparece no slide de “API ilimitada”. Na Treffen o conector é uma peça; a caixa continua de pé se você migrar o tubo.

Guarde o QR como plano B de laboratório, não como plano A da marca. Quando o volume pagar a tarifa Meta, migre. O quiz e o pilar WABA existem para essa data não ser um susto.

O que é a API oficial da Meta

Cloud API / WhatsApp Business Platform: WABA, templates, janela de 24h, Quality Rating, cobrança por mensagem via Meta ou BSP. Mais disciplina e setup; mais previsibilidade para escala. Detalhe de custo e outubro de 2026: API WhatsApp Business Cloud API e o pilar WhatsApp API oficial vs não oficial.

Comparativo: Evolution vs oficial

CritérioEvolution / não oficialAPI oficial (WABA)
Contrato MetaFora da WhatsApp Business PlatformSob políticas e Cloud API
SetupRápido (QR / sessão Web)Maior (WABA, opt-in, templates)
Templates / disparosFrágil ou limitadoSim, com aprovação Meta
Quality RatingSem equivalente oficialSim, no painel Meta/BSP
Risco de ban / sessãoMais altoMais baixo se seguir política
Custo de entradaEm geral mais baixoPlataforma + Meta/BSP
Escala multi-agenteAté certo pontoDesenhado para escala
Resumo operacional. “Não oficial” inclui Evolution e pares (Baileys, Z-API, Uazapi e similares).

Riscos do caminho não oficial (sem drama, com clareza)

Esta página não é parecer jurídico. O ponto do comprador é risco operacional. Sessão cai no pico. Número da fachada some. Não há painel Meta para entender por quê. Time de compliance de cliente grande pode recusar o modelo no contrato.

  • Sessão pode cair; reconectar no meio do pico dói.
  • Risco de restrição ou banimento do número — crítico se for o chip “oficial” da marca.
  • Sem o mesmo modelo de templates e políticas da Cloud API.
  • Suporte e compliance de clientes enterprise podem rejeitar o modelo.

Quando Evolution (ou similar) ainda faz sentido

POC com volume baixo, número que você pode substituir, time validando roteiros de IA antes de pagar BSP. Orçamento de entrada limitado — com data explícita para migrar. Não use o número principal da marca “para ver se cola”.

  • POC com volume baixo e número que você pode substituir.
  • Time pequeno validando roteiros de IA antes do WABA.
  • Orçamento de entrada limitado — com plano explícito de migração.

Como decidir em 5 perguntas

  1. Esse número pode sair do ar amanhã sem derrubar o negócio?
  2. Preciso de disparo em massa / templates sob Meta?
  3. Quantos atendentes simultâneos e qual o SLA?
  4. Cliente ou auditoria interna exige canal oficial?
  5. Tenho orçamento para taxa Meta/BSP + plataforma (veja preços Treffen)?

Se a resposta a (1) for “não, o DDD da fachada não pode cair”, o caminho é WABA — mesmo que você comece o trial da caixa no conector atual. A migração é de tubo, não de inbox, se a plataforma já unifica os dois mundos.

Como a Treffen cobre os dois

Treffen Chat conecta stacks do ecossistema e o caminho oficial. Agentes de IA (Agentes) vivem na mesma caixa. Você não troca de marca para sair do QR. Produto: WhatsApp Treffen. Trial: teste grátis 14 dias.

Como parece uma migração de verdade

Não é “exportar o bot”. É: WABA no ar, opt-in conferido, templates mínimos, número (ou número novo) no conector oficial, caixa apontando para o tubo novo, sessão Web desligada. O histórico que estava na Treffen continua na Treffen. O que não continua é a ilusão de que o QR era SLA.

Faça a migração num horário calmo, com número de teste primeiro se o volume permitir. O quiz: preciso de WABA não substitui o runbook, mas evita começar a jornada no número errado.

Comunique o time: no dia D o QR antigo não vale. Deixe um plantão humano nas primeiras horas. Agentes de IA (Agentes) só voltam Ativo quando a caixa estiver estável no tubo novo — senão você automatiza o caos da virada.

Quem não deveria ficar no Evolution

Marca com o mesmo DDD na fachada, Google e anúncio. Time com mais de um atendente e SLA. Cliente B2B que pede “canal oficial” no contrato. Disparo de template em volume. Nesses casos o custo de entrada do não oficial é um desconto no risco. Pilar amplo: WhatsApp API oficial vs não oficial.

Também saia do QR se você já tomou um ban, se a sessão cai no sábado, ou se o financeiro pediu nota previsível de mensagens. Evolution continua útil como laboratório. Laboratório não é o número que está no caminhão da empresa.

Se a equipe já atende em Treffen Chat, a decisão é só de conector. Não jogue fora a caixa para “ir de oficial”. Mude o tubo, mantenha filas, agentes e histórico.

Checklist: ficar ou migrar

  • O número pode cair amanhã sem derrubar a marca?
  • Preciso de template / disparo sob Meta?
  • Há SLA e mais de um atendente?
  • Contrato pede canal oficial?
  • A caixa já unifica os dois conectores?

Próximo passo

FAQ