Modulo 2.3: Construindo seu Primeiro AI Workflow

🎯

O Que Vamos Construir

Classificador de e-mails de suporte

Vamos criar um workflow completo que recebe e-mails, usa IA para classificar em categorias, e roteia para as acoes corretas. Este e um caso de uso real e pratico que voce pode adaptar imediatamente.

Fluxo que vamos construir:

Email chega → IA classifica → Roteia → Acao Final

1

Definindo o Objetivo

Antes de construir, defina claramente

Nosso objetivo:

"Quando um e-mail chegar na caixa de suporte, quero que seja automaticamente classificado e enviado para a fila correta, com prioridade definida."

Criterios de sucesso:

• Classificar em 5+ categorias
• Definir prioridade (alta/media/baixa)
• Processar em menos de 10 segundos
• Escalar para humano quando incerto

Fora do escopo (por enquanto):

• Resposta automatica
• Analise de anexos
• Integracao com CRM
• Multiplos idiomas

2

Configurando o Trigger

O evento que inicia tudo

Opcoes de Trigger:

Gmail/IMAP Trigger

Monitora caixa de entrada diretamente

Webhook

Recebe via API do provedor de email

Formulario

Form de contato no site

Polling

Verifica periodicamente

Configuracao no n8n (Gmail):

{
  "node": "Gmail Trigger",
  "operation": "Watch for new emails",
  "label": "inbox",
  "poll_interval": 60 // segundos
}

Dica:

Para testes, use Webhook Trigger - permite enviar dados manualmente sem precisar de email real.

3

Integrando a Chamada de IA

Conectando com OpenAI/Claude

Configuracao da API:

1. Adicione um node "HTTP Request" ou use o node nativo da OpenAI/Anthropic
2. Configure sua API Key nas credenciais do n8n
3. Escolha o modelo (recomendado: GPT-4o-mini ou Claude 3.5 Haiku para classificacao)

Parametros recomendados:

Model: gpt-4o-mini
Temperature: 0.1 (mais deterministico)
Max tokens: 200 (resposta curta)
Response format: JSON

Custos estimados:

GPT-4o-mini: ~$0.0001/email
Claude Haiku: ~$0.00008/email
1000 emails/dia: ~$3/mes

Importante:

Nunca coloque API keys direto no workflow. Use as credenciais seguras do n8n ou variaveis de ambiente.

4

Escrevendo o Prompt

O coracao do seu workflow

Prompt completo para classificacao:

Voce e um classificador de e-mails de suporte para uma empresa SaaS.

Analise o e-mail e classifique em UMA categoria:
- suporte_tecnico: bugs, erros, problemas de acesso
- comercial: precos, planos, upgrade, desconto
- financeiro: faturas, cobrancas, reembolso
- cancelamento: pedidos de cancelamento
- reclamacao: insatisfacao, ameaca de sair
- outros: nao se encaixa acima

Defina prioridade:
- alta: cliente irritado, sistema fora do ar, urgente
- media: problema afeta trabalho, mas tem workaround
- baixa: duvida simples, sem urgencia

Responda APENAS em JSON:
{
  "categoria": "string",
  "prioridade": "string",
  "confianca": 0.0-1.0,
  "resumo": "1 frase descrevendo o problema"
}

ASSUNTO: {{ $json.subject }}
REMETENTE: {{ $json.from }}
CORPO:
"""
{{ $json.body }}
"""

Variaveis do n8n:

Use {{ $json.campo }} para acessar dados do email. Campos comuns: subject, from, body, date.

5

Criando as Rotas Condicionais

Direcionando para as acoes corretas

Estrutura de roteamento:

Switch Node Roteia baseado na categoria

→ suporte_tecnico → Fila Tecnica

→ comercial → Fila Vendas

→ financeiro → Fila Financeiro

→ cancelamento/reclamacao → Fila Retencao (prioridade alta)

→ outros → Fila Geral

Configuracao do Switch no n8n:

{
  "node": "Switch",
  "rules": [
    { "value": "{{ $json.categoria }}",
      "operation": "equals",
      "output": 0 },
    // ... mais regras
  ],
  "fallback": "last"
}

Nao esqueca:

Adicione uma rota para confianca baixa (ex: <0.7). Esses casos devem ir para revisao humana.

6

Configurando as Acoes Finais

O que acontece no final de cada rota

Acoes comuns:

✓ Criar ticket no Zendesk/Freshdesk
✓ Enviar notificacao Slack
✓ Adicionar label no email
✓ Salvar em planilha/Airtable
✓ Enviar para fila no Trello/Asana

Dados a incluir:

• Email original (subject, body, from)
• Categoria classificada
• Prioridade definida
• Resumo gerado pela IA
• Score de confianca
• Timestamp de processamento

Exemplo: Notificacao Slack

{
  "channel": "#suporte-{{ $json.categoria }}",
  "text": "Novo ticket [{{ $json.prioridade }}]",
  "blocks": [
    {
      "type": "section",
      "text": "*{{ $json.subject }}*\n{{ $json.resumo }}"
    }
  ]
}

7

Testando e Validando

Antes de colocar em producao

Checklist de testes:

□ Testar cada categoria (minimo 3 exemplos)

□ Testar emails ambiguos

□ Testar emails muito longos

□ Testar emails muito curtos

□ Verificar JSON sempre valido

□ Testar fallback (categoria "outros")

□ Verificar rota de confianca baixa

□ Testar tratamento de erros

Dica de teste:

Use o "Execute Workflow" do n8n com dados de teste antes de ativar o trigger real. Isso permite debugar passo a passo.

8

Deploy e Monitoramento Inicial

Colocando em producao

Antes de ativar:

✓ Configurar alertas de erro
✓ Definir limite de execucoes
✓ Verificar credenciais em producao
✓ Documentar o workflow

Primeiros dias:

• Monitore taxa de erro
• Revise classificacoes manualmente
• Colete feedback da equipe
• Ajuste prompt conforme necessario

Expectativa realista:

Nos primeiros dias, espere precisao de ~80%. Com ajustes de prompt e mais exemplos, voce pode chegar a 95%+ em algumas semanas.

Resumo do Modulo

✓ Defina objetivo claro e criterios de sucesso antes de construir

✓ Configure trigger apropriado (Gmail, Webhook, ou IMAP)

✓ Integre API de IA com parametros otimizados (temperatura baixa, JSON)

✓ Crie rotas condicionais incluindo fallback para confianca baixa

✓ Teste extensivamente antes de produzir, monitore apos deploy

Proximo Passo

Aprenda a rotear e criar acoes avancadas!