Bloco 2 · Evolution API

■REPO CERTO — v2.3.x oficial

Usar SÓ EvolutionAPI/evolution-api v2.3.7. O fork evolution-foundation/evolution-api é PAGO (licenciamento). Aluno tropeça aqui se não avisar.

2.1

Subir Evolution no Easypanel

Reusa o MESMO Postgres da Bloco 1. NÃO use o template 1-click do painel: ele sobe sem limite de memória e derruba a VPS no pull. O prompt abaixo instala a v2.3.7 EM FASES, com teto de RAM e as armadilhas já resolvidas.

⚠Por que não o template do painel?

Já tentamos pelo Create Service → Template e a VPS travou no deploy (pull pesado + zero limite de memória = OOM, derruba tudo). O prompt faseado abaixo resolve: define memoryLimit antes do deploy, isola a operação pesada e espera o pull sem bombardear o painel.

Cola no Claude com o token do Easypanel. Ele instala, conecta no banco e te devolve a URL + a chave de acesso:

Prompt — instala Evolution API v2.3.7 (faseado, anti-travamento)

# PROMPT — Instalar Evolution API v2.3.7 no Easypanel (EM FASES, anti-travamento)

Você vai instalar o **Evolution API v2.3.7** (WhatsApp API) no meu Easypanel, via API tRPC,
REUSANDO o Postgres que já subi no projeto da aula. Execute EM FASES, na ordem,
respeitando os GATES. NÃO pule fases e NÃO empilhe operações pesadas.

…

Clica aqui pra copiar o prompt inteiro

Precisa de:easypanel-mcpEASYPANEL_TOKEN

Quando o Claude entregar a URL + a AUTHENTICATION_API_KEY, o resto é manual (não dá pra automatizar o QR):

1. Acessa https://<host>/manager e entra com a API key
2. Cria a instância "atendimento"
3. Escaneia o QR code no chip dedicado (Android velho)
4. Aponta o webhook da instância pra URL do teu n8n (usada na 2.2)

APIevolution-api

2.2

Workflow n8n · Evolution → IA → resposta

O bot que recebe a mensagem, pensa com IA e responde sozinho. O prompt já vem com o filtro de grupo/fromMe (o bug que mais derruba bot), o payload real da Evolution e teste E2E.

Prompt — cria o bot Evolution no n8n (faseado, com filtro anti-bug)

# PROMPT — Workflow n8n do bot: Evolution → IA → resposta (FASEADO, à prova de erro)

Você vai criar no meu n8n, via MCP, um workflow que recebe a mensagem do WhatsApp (pela Evolution API),
responde com IA e devolve pelo mesmo número. Execute EM FASES, validando node a node. Já te dou tudo
mapeado — siga à risca e gaste o MÍNIMO de chamadas.

…

Clica aqui pra copiar o prompt inteiro

Precisa de:n8n-mcpPostgresIA (MiMo/Claude)evolution-api

Não quer montar do zero? Importa o template pronto — bot completo em 15 nós, só Postgres: agrupa mensagens picadas (buffer anti-fragmentação), tem memória de conversa nativa e o filtro de grupo/eu-mesmo já resolvido. No n8n: Workflows → Import from File.

Template n8n pronto · importa e usa

Chatbot SDR · Evolution

Buffer no Postgres + memória nativa (Postgres Chat Memory) + filtro anti-grupo. Zero Redis. RAG pluga pelo Bloco 5.

Baixar .json15 nodes

✓O que ajustar depois de importar

No n8n, mapeia as credenciais (Evolution, Postgres, modelo de IA) e personaliza o system prompt do AI Agent. As tabelas (memória e buffer) se criam sozinhas — não precisa rodar nada na mão. Pra dar conhecimento real (playbooks/FAQs), pluga o RAG 2 camadas com o prompt do Bloco 5.

2.3

Checklist anti-ban

Mesmo seguindo TUDO, número pode banir. É a regra do jogo do não-oficial.

☐ Chip NOVO dedicado (R$ 30, Android velho)
☐ Aquecimento 7-14 dias antes (msgs orgânicas reais)
☐ Delay aleatório 8-30s entre respostas
☐ Nunca templates 100% idênticos
☐ Não comprar lista fria
☐ Limite ~100 msgs novas/dia início
☐ Backup tabela chat_history (se banir, perde tudo)
☐ Número 2 reserva já aquecido (plano B)