O módulo Evolution API é parte da Formação em Agentes IA e Automações da ibe.IA, dentro do curso de N8N Avançado. São 24 aulas cobrindo desde a instalação do servidor até webhooks recebendo mensagens em tempo real. O ponto central é simples: você aprende a usar uma API não-oficial do WhatsApp que entrega funcionalidades que a API oficial da Meta simplesmente não tem.

O que você vai aprender neste módulo

O módulo cobre tudo que vai do zero até o primeiro disparo de mensagem via API. Começa com conceitos da Evolution API, passa pela instalação completa em servidor próprio com Docker Swarm, configura o ambiente (DNS, banco de dados Postgres, Redis), e termina nas chamadas de API e nos webhooks que conectam tudo ao N8N.

Print da primeira aula do módulo Evolution API

A primeira aula do módulo está disponível em curso.ibe.ia.br/l/evoapi-02a-evolution pra quem quiser dar uma olhada antes de entrar na formação. O módulo completo fica em curso.ibe.ia.br/m/evoapi.

O conteúdo está dividido em cinco blocos:

  1. Conceitos iniciais: diferença entre a versão Cloud e Self-hosted, comparativo com a API oficial da Meta, e dicas concretas pra não ter o número bloqueado.
  2. Instalação e configurações: do esquema de instalação ao Docker Swarm, passando por DNS na Cloudflare, Redis e Postgres.
  3. API Evolution: documentação, criar instância, gerar QR Code, enviar mensagem, checar número e usar proxy via webshare.io.
  4. Webhooks: configuração dos eventos e como receber mensagem no N8N em tempo real.
  5. Gestão via Manager: visão geral do painel e conexão do número.

Evolution API ou API oficial do WhatsApp: qual a diferença

A API oficial do WhatsApp Business, fornecida pela Meta, exige aprovação, cobra por conversa iniciada e limita o que você pode fazer. A Evolution API é uma API não-oficial que funciona conectando um número real via QR Code, sem aprovação da Meta e sem custo por mensagem.

Cena Pixar comparando API oficial vs não-oficial

A diferença prática para quem monta agentes:

  • Custo: a API oficial da Meta cobra por conversa. A Evolution API não tem esse custo, porque opera como um cliente WhatsApp Web no servidor.
  • Funcionalidades exclusivas: disparar mensagens com “digitando…”, usar proxy por número, gerenciar múltiplas instâncias no mesmo servidor.
  • Risco de bloqueio: existe. Por isso o módulo dedica uma aula inteira de 10 minutos só pra boas práticas pra evitar ban do número, coisa que a API oficial não precisa se preocupar.

A escolha entre uma e outra depende do caso de uso. Para agentes que precisam de volume controlado e conformidade com os termos da Meta, a oficial faz sentido. Para projetos com mais liberdade técnica, volume menor e funcionalidades que a oficial não entrega, a Evolution API é o caminho que o módulo ensina.

Instalação e configuração do ambiente

O módulo trata a instalação com seriedade: são 8 aulas só nesse bloco, totalizando quase 30 minutos. O motivo é que a stack tem partes que dependem umas das outras e a ordem importa.

Cena Pixar mostrando instalação Docker Swarm

O caminho percorrido nas aulas:

  1. Esquema de instalação: visão geral de como as peças se encaixam antes de rodar qualquer comando.
  2. DNS na Cloudflare: configurar o subdomínio que vai apontar pro servidor onde a Evolution vai rodar.
  3. Redis: instalado como cache e fila de mensagens pra Evolution.
  4. Postgres: banco de dados onde as instâncias e conversas ficam persistidas.
  5. Docker Swarm: o orquestrador que sobe toda a stack com os containers da Evolution, Postgres e Redis juntos.
  6. Manager: painel web da Evolution pra gerenciar instâncias e conectar números via QR Code.

Quem já tem experiência com Docker vai reconhecer o fluxo. Quem não tem vai sair sabendo o suficiente pra subir o ambiente em qualquer VPS. O módulo usa uma aula específica pra apresentar a “stack completa da Evolution” antes de mergulhar em cada componente.

Chamadas de API: enviar mensagem, checar número e webhooks

Com o servidor no ar, o módulo entra nas chamadas de API que você vai usar nos seus fluxos de N8N. São 8 aulas cobrindo os endpoints mais usados na prática.

Cena Pixar com chamadas de API WhatsApp n8n

Os endpoints ensinados:

  • Criar instância: registrar um número novo no servidor.
  • Gerar QR Code: conectar o número escaneando pelo celular.
  • Enviar mensagem: o endpoint central de qualquer agente de atendimento.
  • Checar número: verificar se um contato tem WhatsApp antes de tentar disparar.
  • Enviar digitando…: simular que alguém está digitando antes de a mensagem chegar, o que aumenta a taxa de leitura em conversas mais naturais.
  • Proxy via webshare.io: rotacionar IP pra reduzir risco de bloqueio em operações de maior volume.
  • Chamada via domínio público ou service_name: como chamar a API de dentro do N8N dependendo de onde os containers estão rodando.

O bloco de webhooks fecha o ciclo: duas aulas mostram como configurar os eventos da Evolution e como criar um fluxo no N8N que recebe mensagem assim que ela chega no número conectado. Com isso, o agente consegue responder em tempo real sem precisar ficar fazendo polling.

Pra quem é esse módulo

O módulo é pra quem já tem alguma familiaridade com N8N e quer adicionar WhatsApp de verdade nos seus agentes. Não precisa saber criar servidor do zero, mas ajuda ter noção básica de como VPS e Docker funcionam.

Se você está montando agentes de atendimento pra clínicas, imobiliárias, e-commerces ou qualquer negócio que usa WhatsApp como canal principal, esse módulo entrega a infraestrutura que sustenta tudo isso. A Evolution API é o componente que aparece em praticamente todo projeto de atendimento automatizado via WhatsApp fora da API oficial da Meta.

O módulo faz parte do curso N8N Avançado dentro da Formação em Agentes IA e Automações. Quem entra na formação tem acesso a tudo: o módulo completo, os outros módulos do N8N Avançado e o restante da trilha de agentes.

A Formação em Agentes IA e Automações da ibe.IA ensina a montar esse agente no WhatsApp e cobrar de empresa por isso: da instalação do servidor até o fluxo completo de atendimento rodando no N8N.

Conheça a Formação em Agentes IA e Automações

E se essa leitura te ajudou a entender o que está acontecendo, segue a ibe.IA no Instagram (@ibe.ia) que toda semana sai conteúdo desse jeito.