Guia prático · Typebot
Arquitetura completa: Evolution API + Typebot + n8n + Chatwoot na mesma operação
Aprenda a orquestrar Typebot, n8n e Chatwoot junto à Evolution API sem conflito de webhooks ou loops de mensagem.
Neste guia passo a passo
1. Arquitetura e pré-requisitos no ambiente
2. Passo a passo de implementação e validação
3. Boas práticas de produção, segurança e escala
1. Arquitetura e pré-requisitos no ambiente
O erro mais comum ao juntar Typebot, n8n e Chatwoot é apontar todos para o mesmo evento sem controle de estado, gerando respostas duplicadas. A chave é definir quem é o dono da sessão em cada etapa.
- Plano recomendado: VPS Performance (12 GB RAM) para rodar toda a stack com folga.
- Fluxo publicado no Typebot com palavra-chave de gatilho ou ativação padrão.
2. Passo a passo de implementação e validação
- Conecte o Typebot diretamente na integração nativa da Evolution API definindo Expire (minutos) e uma palavra de saída (ex:
#sair). - Configure a opção Pause Bot on Human Reply (ou Finish Bot ao transferir para fila humana no Chatwoot).
- Dentro do fluxo do Typebot, use o bloco Webhook / HTTP Request para acionar o n8n apenas quando precisar consultar banco, gerar Pix ou validar CPF.
- Quando o cliente pedir atendimento humano, chame a API da Evolution/Chatwoot para alterar o status da conversa de
pendingparaopene pausar a sessão do Typebot.
3. Boas práticas de produção, segurança e escala
Dessa forma, o n8n só é acionado nas etapas transacionais, economizando CPU e mantendo o diálogo fluido.
- Sempre ignore mensagens enviadas pelo próprio número (
fromMe: true) nos gatilhos do n8n para evitar loop infinito.
Quer colocar Typebot em produção hoje com 30% OFF no plano anual?
Suba sua VPS NVMe em São Paulo (6,6ms) com instalador em 1 clique, SSL automático e suporte humano no WhatsApp. Equivale a R$ 69,30/mês no plano anual com o cupom BLACK30 (ou R$ 99/mês no mensal).
Mais tutoriais sobre WhatsApp, Evolution API & Atendimento
You Secure