Pular pro conteúdo

Evolution API, Z-API, Typebot e API oficial do WhatsApp: qual escolher

Quem começa a montar atendimento automático no WhatsApp trava sempre na mesma encruzilhada técnica: subir a Evolution API de graça numa VPS, assinar a Z-API, desenhar funis no Typebot ou configurar a API oficial da Meta. Misturar essas peças sem saber a camada certa de cada uma é o caminho mais curto para derrubar o chip principal do cliente.

Vagner Mazzeo · atualizado em · 8 min de leitura

Antes de tudo: o que é ponte de WhatsApp e o que é cérebro do fluxo

Quando alguém pesquisa por Evolution API, Z-API, Typebot e API oficial do WhatsApp na mesma tarde, quase sempre mistura ferramentas de camadas diferentes. Se você não separar o cano que transporta a mensagem do cérebro que decide a resposta, vai gastar dinheiro à toa e prometer algo que cai no primeiro sábado de movimento.

O personagem do Gemini aperta um parafuso da ponte que liga o celular da empresa à máquina que decide a resposta, com cápsulas verdes passando.

Na arquitetura de qualquer automação de WhatsApp, existem duas camadas. A primeira é a ponte de conexão: ela liga o número da empresa à internet para ler a mensagem que chegou e devolver uma resposta. É aqui que moram o aplicativo WhatsApp Business comum, a Evolution API, a Z-API e a API oficial do WhatsApp (Cloud API da Meta). A segunda camada é o construtor de fluxo: ele recebe o texto da ponte, consulta agenda ou banco de dados, chama um modelo de linguagem e responde. É nessa camada que entram o Typebot, o n8n, as plataformas prontas (BotConversa e ManyChat) e os agentes de IA sob medida.

Resumo em uma frase: o Typebot e o n8n não se conectam sozinhos ao número do WhatsApp do cliente; eles precisam da Evolution API, da Z-API ou da API oficial da Meta funcionando como ponte.

Evolution API: o que é, como funciona com n8n e quando vale a pena

A Evolution API é um projeto de código aberto criado no Brasil muito usado em automação com IA para pequenos negócios. Em vez de passar pelo processo burocrático da Meta, ela sobe uma instância em servidor próprio (VPS Linux na Hetzner, Hostinger ou DigitalOcean) que emula uma sessão do WhatsApp Web.

O código da Evolution API é aberto e fica no GitHub, de onde ela sobe na sua VPS. O repositório oficial, em 19 de outubro de 2026.

O pareamento funciona igual ao WhatsApp no computador: a Evolution API gera um QR Code, o empresário lê com o aparelho dele e pronto. Toda mensagem recebida dispara um aviso para o fluxo no n8n ou no Typebot. Como o n8n oferece de graça: instalado no seu próprio servidor, sem chave de licença, ele roda como a edição Community, que é gratuita (ou nuvem R$ 150 por mês, ou R$ 125 por mês no plano anual, com 2.500 execuções de fluxo por mês), a dupla Evolution API n8n permite atender vários clientes num servidor de R$ 35 a R$ 60 mensais sem pagar taxa por número.

A secretária continua vendo as conversas no celular físico e pode assumir o atendimento com a mão a qualquer hora. Mas lembre do custo invisível: como é uma API não oficial na sua VPS, você é o responsável se a Meta atualizar o protocolo e desconectar a sessão.

Z-API, Typebot e API oficial do WhatsApp: preço e diferenças reais

Para quem não quer cuidar de Linux nem Docker da Evolution API, a alternativa mais conhecida é a Z-API. Ela usa a mesma leitura de QR Code, mas entrega a infraestrutura pronta na nuvem com suporte em português, cobrando assinatura mensal por instância (faixa de R$ 70 a R$ 100 por número). Já o Typebot tem código aberto com grátis até 200 conversas por mês; o pago começa em US$ 39 por mês (o Starter, com 2.000 conversas), e a integração com o WhatsApp só vem no Pro, de US$ 89 por mês e desenha árvores visuais de perguntas passo a passo, rodando no site ou ligado ao WhatsApp.

A Z-API cobra por instância, ou seja, por número conectado. A página da Z-API, em 18 de outubro de 2026.

Na ponta mais segura está a API oficial do WhatsApp (Cloud API da Meta), homologada direto nos servidores da Meta. Sobre o WhatsApp Business API preço, a cobrança é feita a Meta cobra por mensagem de modelo entregue, com o preço pela categoria (marketing, utilidade ou autenticação) e pelo país de quem recebe; é assim desde 1º de julho de 2025, mas a grande vantagem para recepção é que 24 horas: quando o cliente manda mensagem, abre uma janela de 24 horas pra responder fora de modelo; desde 1º de outubro de 2026, cada número tem mil dessas respostas grátis por mês, e a Meta cobra a partir da milésima primeira. E para quem prefere plataformas prontas, existem o ManyChat (US$ 39 por mês, ou US$ 29 por mês no plano anual, no Pro, o plano que a ManyChat indica pra quem usa o WhatsApp, com até 2.500 contatos ativos por mês) e o BotConversa (R$ 199 por mês no plano anual, no Pro, que é o plano com o agente de IA e a API oficial do WhatsApp (o Starter, sem IA, sai R$ 189 por mês no anual)), além do aplicativo gratuito WhatsApp Business com atalhos de mensagens para clientes.

Caminho / FerramentaPapel na arquiteturaCusto mensal típicoRisco de bloqueioOnde encaixa melhor
App WhatsApp BusinessAplicativo oficial gratuito no celularR$ 0Baixo no uso receptivoComércio local até 30 conversas por dia com atalhos rápidos
Evolution API (VPS)Ponte não oficial via QR Code na sua VPSVPS (R$ 35 a R$ 80/mês para várias instâncias)Alto em disparo frio; seguro no receptivoQuem domina Linux + n8n e quer margem alta em vários clientes
Z-APIPonte não oficial via QR Code na nuvemPor instância (R$ 70 a R$ 100/mês)Alto em listas frias; estável no receptivoQuem quer QR Code rápido sem manter servidor próprio
API Oficial da MetaConexão oficial nos servidores da MetaCobrança a Meta cobra por mensagem de modelo entregue, com o preço pela categoria (marketing, utilidade ou autenticação) e pelo país de quem recebe; é assim desde 1º de julho de 2025; janela 24h grátisMínimo seguindo as regras da MetaClínicas e empresas que não podem arriscar o número
Typebot + n8nCérebro do fluxo (triagem e integrações)Typebot (grátis até 200 conversas por mês; o pago começa em US$ 39 por mês (o Starter, com 2.000 conversas), e a integração com o WhatsApp só vem no Pro, de US$ 89 por mês) + n8n (de graça: instalado no seu próprio servidor, sem chave de licença, ele roda como a edição Community, que é gratuita)Depende da ponte escolhidaTriagem inteligente, qualificação e agendamento
BotConversa / ManyChatPlataforma visual prontaBotConversa (R$ 199 por mês no plano anual, no Pro, que é o plano com o agente de IA e a API oficial do WhatsApp (o Starter, sem IA, sai R$ 189 por mês no anual)) / ManyChat (US$ 39 por mês, ou US$ 29 por mês no plano anual, no Pro, o plano que a ManyChat indica pra quem usa o WhatsApp, com até 2.500 contatos ativos por mês)Depende se usa QR Code ou API oficialEmpresário que prefere pagar assinatura pronta
Comparativo técnico e financeiro das ferramentas de WhatsApp usadas no mercado brasileiro em outubro de 2026. Valores conferidos em 16 de outubro de 2026.
À noite, três pontes levam à mesma recepção acesa de verde: uma de corda, uma de metal aparafusada e uma de concreto; o personagem do Grok olha.
Três pontes pro mesmo número: a que você mesmo mantém na sua VPS (Evolution API), a alugada (Z-API) e a oficial da Meta.

O perigo real de derrubar o número do cliente (e como evitar banimento)

O número de WhatsApp de uma clínica ou imobiliária é o ativo mais valioso daquela empresa. Se você espetar esse número numa Evolution API ou Z-API e disparar trezentas mensagens iguais para uma planilha fria, a Meta vai banir o chip em minutos. Siga quatro regras de segurança:

  • 1. Receptivo é seguro; disparo frio derruba o chip: responder quem clicou no site e chamou primeiro tem risco baixo, simulando digitação humana (2 a 5 segundos). Nunca faça disparo frio em massa no chip principal.
  • 2. Na sua prospecção comercial, vá no 1 a 1: ao fazer sua prospecção e enviar a abordagem no WhatsApp com o link da prévia do site, mande manualmente falando o nome do dono.
  • 3. Separe número de triagem do número histórico: se o cliente quiser automação via QR Code, recomende aquecer um segundo chip antes de mexer no telefone da fachada.
  • 4. Use a janela oficial ou conexões via MCP em operações críticas: quando o agente consulta agenda via MCP, a janela gratuita de 24h da API oficial evita queda de sessão.
É isso que a empresa vê no dia em que o número cai: o aviso de conta banida, na Central de Ajuda do WhatsApp, em 19 de outubro de 2026.

Como transformar isso em contrato (sem virar refém de manutenção técnica)

Muita gente que quer abrir uma agência de IA passa semanas apanhando de Docker antes de ter um cliente pagante. Na turma do MazyOS, a ordem é inversa: primeiro você entrega o site que faz o WhatsApp do cliente tocar; depois oferece a automação de triagem cobrando implementação e mensalidade segundo a régua de quanto cobrar e organizando o recebimento conforme o guia de como cobrar um cliente.

Fiz R$300 mil em 3 meses com Claude Code (mostro tudo que vendi) · No meu canal do YouTube

Olha na prática como essa escada de produtos funciona: esse aluno fechou primeiro R$ 1.800 num projeto criado com o método e já engatou o segundo cliente pedindo justamente uma automação de WhatsApp:

O Vagner, no grupo IA BUSINESS 2, 18/08, 17h06

No MazyOS, que roda no Claude Code, no Codex e no Antigravity, você recebe todas as skills para criar sites, sistemas, propostas e contratos na pasta do cliente, além das 26 aulas divididas em 7 módulos por R$ 97 por um ano ou R$ 197 pra sempre (parcelado em pagamento único, no Pix ou em até 12x), com a garantia tripla: 7 dias de arrependimento; a Garantia de Destrave Técnico, em que alguém da equipe instala o MazyOS junto com você numa chamada, se o primeiro site não sair; e a Garantia de Campo, de 60 dias: apresentou a prévia pronta pra 10 empresários, da sua agenda ou da sua cidade, e não fechou nenhum contrato, o dinheiro volta no Pix e mais a a Garantia de Campo, de 60 dias: apresentou a prévia pronta pra 10 empresários, da sua agenda ou da sua cidade, e não fechou nenhum contrato, o dinheiro volta no Pix, e o acesso continua seu.

Quer saber quanto cobrar pela implementação de um fluxo no WhatsApp e pela mensalidade de manutenção? Veja a régua completa em quanto cobrar por agentes e sites.

Antes de perder noites configurando VPS e Docker, use o MazyOS no Claude Code ou no Antigravity grátis para entregar o site e o fluxo que fazem o WhatsApp do cliente tocar nesta semana.

Seja qual for a sua ferramenta, o MazyOS vai junto. Roda no Claude Code, no Codex e no Antigravity.

Não quer pagar IA nenhuma pra começar? O Antigravity tem um plano grátis, de US$ 0 por mês, com limite de uso por semana.

Por um ano
R$ 97
Pra sempre
R$ 197

Pagamento único, no Pix ou em até 12x. Qual vale mais a pena?

  • A garantia tripla: 7 dias de arrependimento; a Garantia de Destrave Técnico, em que alguém da equipe instala o MazyOS junto com você numa chamada, se o primeiro site não sair; e a Garantia de Campo, de 60 dias: apresentou a prévia pronta pra 10 empresários, da sua agenda ou da sua cidade, e não fechou nenhum contrato, o dinheiro volta no Pix.

O preço sobe conforme o MazyOS melhora.

Ver tudo que vem no MazyOS

No checkout dá pra levar junto o Kit Vertical Pronto por R$ 69,90: 3 nichos que pagam bem (clínicas, advogados e imobiliárias), cada um com site, posts, proposta e a call ensaiada.

O MazyOS não é da Anthropic; Claude é marca da Anthropic.

O MazyOS não é da OpenAI; Codex e ChatGPT são marcas da OpenAI.

O MazyOS não é do Google; Antigravity e Gemini são marcas do Google.

Compartilhar

Quem escreveu

Vagner Mazzeo

O Vagner Mazzeo sou eu, criador do MazyOS e fundador da agência Mazzeo IA. Estou há 8 anos no mercado digital e hoje implemento inteligência artificial com o Claude para empresas, em projetos de R$ 10 mil a R$ 15 mil. Mostro esse trabalho de tela aberta no meu canal do YouTube (@vagnermazzeo), que soma 46,3 mil inscritos em 16/10/2026.

Quem é o Vagner