Secretária IA com n8n, Evolution API e Chatwoot

Cliente que chama no WhatsApp e fica sem resposta marca com o concorrente. Este tutorial resolve isso no modo faça você mesmo: uma secretária IA montada com n8n, Evolution API e Chatwoot, rodando na sua VPS, com os workflows liberados pra download. No vídeo acima, o Lucas constrói o sistema do zero. Este artigo é o mapa: o que a assistente faz, qual peça cumpre qual papel e a engenharia por trás da conversa.

O que essa secretária IA faz no WhatsApp

A demonstração usa uma clínica, mas o mesmo esqueleto serve pra loja, pet shop, escritório, qualquer negócio que agenda e responde gente o dia todo. O repertório:

• Texto e áudio. Se o cliente manda áudio, ela transcreve (Whisper, da OpenAI) e responde em áudio com voz do ElevenLabs. Chega no WhatsApp como áudio gravado, com modulação e tudo. E espera a pessoa terminar antes de responder, agrupando mensagens picadas.
• Sinais de presença. Visto azul, "digitando...", "gravando áudio..." e reação com emoji.
• Múltiplas agendas. Marca, remarca e cancela em vários calendários do Google Calendar, checando disponibilidade por profissional.
• Envio de arquivos. Qualquer PDF numa pasta do Google Drive: exame, catálogo, tabela.
• Follow-up e escalada. Cobra confirmação de presença; assunto fora do escopo (financeiro, reclamação) desliga a IA e chama um humano (detalhe mais abaixo).
• Assistente interno. Por áudio no Telegram, você desmarca compromissos em massa, pede resumo dos e-mails e cria lembretes.

Um ponto de projeto: nada aqui é agente solto adivinhando tudo. Sistema que aguenta o tranco é híbrido: a IA conduz a conversa, filtros e etiquetas determinísticas controlam o que ela pode atender, e a gente assume o que é delicado.

A stack: n8n, Evolution API, Chatwoot e Supabase

Por que Evolution API (e o que o Baileys tem a ver)

A Evolution API é uma API open source, não oficial, que conecta números de WhatsApp a outros sistemas: você aponta o celular pro QR Code, igual no WhatsApp Web. Por baixo, quem faz a ponte é o Baileys, biblioteca que simula um dispositivo do WhatsApp.

Por que tanta gente prefere esse caminho à API oficial da Meta? Porque com a API oficial o número vira só virtual: deixa de existir no celular. Com o Baileys, a empresa segue no número de sempre, que os clientes já conhecem.

O papel do Chatwoot (e o fork da fazer.ai)

O Chatwoot é uma central de atendimento open source: WhatsApp, Instagram, site e e-mail numa tela só, com caixas de entrada, times e regras de distribuição. É nele que você enxerga todas as conversas: as que a IA conduz e as que as pessoas assumem.

O Chatwoot original não falava Baileys nativamente. Foi isso que o time de desenvolvimento da fazer.ai integrou no fork Chatwoot fazer.ai: o QR Code passa a existir dentro do próprio Chatwoot, sem instalar a Evolution à parte. Foram cerca de três meses de trabalho, e o código é aberto no GitHub.

Completam a stack:

• n8n: orquestra os workflows. A analogia que a gente usa: é um Arduino, ótimo pra validar e subir rápido; escalar com compliance é outra conversa.
• Supabase: PostgreSQL gerenciado pra memória do agente e pra fila de mensagens.
• Gemini 2.5 Pro: o modelo do agente; nos testes do time, foi o que melhor segurou essas tarefas.
• ElevenLabs: geração de voz, com os parâmetros de velocidade e estabilidade sugeridos no vídeo.
• Telegram: canal interno da equipe, separado do WhatsApp do cliente.

Da VPS vazia ao WhatsApp conectado

Tudo roda numa VPS, uma máquina alugada na nuvem, administrada por você. Seus dados de atendimento ficam no seu servidor, no seu controle. No vídeo, a VPS é da Hostinger (cupom FAZERAI dá 10% de desconto), plano KVM 2 com a imagem do painel Coolify. O caminho:

1. Suba a VPS com o Coolify e crie um projeto Docker Compose.
2. Cole o script de instalação dos templates: ele configura Chatwoot fazer.ai, Baileys, Redis e Postgres de uma vez.
3. Ajuste a variável FRONTEND_URL com o IP da máquina na porta 3000 e faça o deploy.
4. No Chatwoot, crie a caixa de entrada Baileys, informe o telefone com o "+" e aponte o QR Code.
5. No n8n, instale o community node do Chatwoot, cole o token e cadastre dois webhooks (teste e produção) no evento "mensagem criada".

O tutorial vem escrito dentro do próprio workflow, com nodes dedicados a testar cada credencial na configuração: a conexão quebrada aparece ali, não no primeiro atendimento. Os workflows passam pela revisão do time de desenvolvimento da fazer.ai, liderado pelo Gabriel Jablonski.

A engenharia que faz a conversa parecer humana

Fila de mensagens encavaladas. No WhatsApp ninguém escreve linear: a pessoa manda três mensagens picadas em dez segundos. Cada uma abre uma execução no n8n e entra numa fila no Postgres com chave no telefone do contato. O sistema espera 16 segundos; se chegou mensagem nova, a execução antiga morre e a mais recente junta a pilha inteira e responde de uma vez. Só funciona com o workflow em produção.

Sinais de presença e voz sem cara de robô. Visto azul, "digitando" e "gravando" são flags que o n8n manda ao Chatwoot e chegam ao WhatsApp via Baileys, com um tempinho proposital entre visualizar e responder. Já a resposta em áudio passa por uma cadeia LLM que a formata em SSML, protocolo de marcação pra síntese de fala que faz "10:00" virar "dez horas" no ElevenLabs.

Raciocínio e system prompt estruturado. Quando o cliente pede remarcação, documento e valor na mesma mensagem, o node Think (recém-chegado ao n8n) organiza o raciocínio antes de acionar as ferramentas. E o prompt é montado bloco a bloco: data, contato, conversa, papel, procedimento operacional, dados do negócio, IDs das agendas do Google Calendar e a lista de ferramentas. As ferramentas de agenda (criar, buscar, atualizar, apagar) vivem num servidor MCP dentro do próprio n8n.

Follow-up automático e escalada pra humano

O follow-up é um segundo agente, disparado por agendamento: em dias úteis, ele lê as agendas do Google Calendar e cobra confirmação com a antecedência que você definir. O truque de engenharia: ele só envia mensagens, e grava o que enviou na memória da secretária. Quando o cliente responde "sim", a secretária acha aquela mensagem na própria memória e continua a conversa sem se perder. Confirmou, etiqueta o evento na agenda.

A escalada é o caminho inverso: pedido fora do escopo aplica a etiqueta "agente off" na conversa do Chatwoot (o filtro de entrada do workflow passa a bloquear aquele contato, a IA para de responder) e dispara notificação no seu Telegram com o nome e a última mensagem do cliente. Dali em diante, o humano assume pelo Chatwoot.

Já roda Evolution API? O workflow espelhado existe

A primeira versão da assistente já tinha passado de 600 negócios rodando quando os comentários pediram, em peso, a integração com Evolution. O fim do vídeo entrega: o mesmo workflow reconstruído por inteiro sobre a Evolution API, com tudo funcionando. A nossa recomendação segue sendo o fork (um serviço a menos pra manter), mas a escolha é sua.

Perguntas frequentes

Preciso instalar a Evolution API pra usar o Chatwoot fazer.ai?

Não. O Baileys já vem integrado no fork: conectar o WhatsApp é apontar o QR Code na caixa de entrada. A Evolution só entra se ela já é a sua stack.

Quanto custa manter?

Os workflows são gratuitos (mais de 200 horas de desenvolvimento do time). Os custos recorrentes são a VPS (que aqui caiu pra metade da opção da primeira versão) e o consumo das APIs de modelo, transcrição e voz. Tudo item que você enxerga e controla.

Pra ir além

O passo a passo, tela por tela, tá no vídeo acima. E o canal do Lucas Moreira acompanha essa assistente evoluindo a cada versão. Os templates ficam no download da Secretária.

Pra entender de onde ela veio, o capítulo anterior é o assistente virtual no WhatsApp com n8n e MCP; a linhagem inteira tá em a história do melhor atendimento IA faça-você-mesmo.

Se você quer fazer com acompanhamento (tirar dúvida, pegar arquivo pronto, ver bastidor), a comunidade tá em lucasmoreira.ai. Vem fazer junto.