Este projeto é um exemplo funcional de automação de chatbot com IA utilizando o n8n, integrando:
- Captura de mensagens via webhook,
- Registro em planilha Google Sheets,
- Interação com modelo de linguagem natural via Groq,
- Uso de memória de conversação e ferramentas auxiliares (Wikipedia, Calculadora).
Demonstrar a construção de um fluxo automatizado de atendimento utilizando:
- Nodes de linguagem natural (LangChain),
- Armazenamento persistente via Google Sheets,
- Organização e rastreamento de sessões por ID único,
- Personalização de respostas com um tom mais humano e simpático (emojis, linguagem amigável).
Antes de usar, você precisará configurar:
- Conta no n8n.cloud ou instância local.
- Conexões com:
- Google Sheets API (OAuth2),
- Groq API (para LLMs como Mixtral, LLaMA, etc.).
Este fluxo não contém dados sensíveis, pois:
- IDs de webhooks, documentos e credenciais foram substituídos por placeholders genéricos.
- Nenhum segredo ou token está incluído.
- Todas as conexões externas devem ser configuradas localmente com suas próprias chaves e permissões.
Para publicar ou utilizar este fluxo em produção:
- Utilize variáveis de ambiente (
$env) para armazenar credenciais. - Nunca exponha URLs, planilhas ou webhooks reais em repositórios públicos.
| Node | Função |
|---|---|
When chat message received |
Inicia o fluxo ao receber mensagem do usuário |
Set Fields |
Separa ID da sessão e conteúdo da mensagem |
Google Sheets (append) |
Registra a conversa na planilha com controle de sessões |
AI Agent (LangChain) |
Gera resposta personalizada com base no input |
Groq Chat Model |
Integra modelo de linguagem (como Mixtral) para geração de resposta |
Simple Memory |
Mantém contexto da conversa com base no ID da sessão |
Wikipedia / Calculator |
Ferramentas auxiliares à IA |
workflow.json: fluxo exportado do n8n pronto para importaçãoREADME.md: explicações, segurança, instruções de uso
- Importe o JSON no n8n (
Import Workflow) - Substitua:
WEBHOOK_ID_PLACEHOLDERGOOGLE_SHEET_ID_PLACEHOLDER- Credenciais (
Google Sheets account,Groq account)
- Configure as permissões adequadas nas APIs
- Teste localmente antes de colocar em produção ou compartilhar
Projeto acadêmico desenvolvido com foco em automação com IA, ideal para demonstrar conhecimentos em:
- Lógica de automação
- Integração entre APIs
- Segurança e boas práticas de publicação de workflows
Este repositório é educacional. Para ambientes reais, siga as práticas de segurança da sua organização e certifique-se de estar em conformidade com a LGPD ou regulamentos locais de proteção de dados.