Criando um Agente de IA com n8n e Telegram para vendas: Passo a Passo do Zero

Neste artigo vamos construir do zero um agente de inteligência artificial usando o n8n, uma ferramenta gratuita e open-source de automação, integrado ao Telegram e ao Google Gemini para criar um assistente virtual que responde a clientes automaticamente.

Vamos criar do zero, sem necessidade de conhecimento prévio, incluindo a configuração de credenciais do Telegram. Acompanhe o passo a passo e aprenda a implementar um fluxo que recebe mensagens, processa com IA e responde, tudo personalizado para sua empresa.

Para baixar os arquivos utilizados na aula, preencha:

Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.

Para criar um agente de IA com n8n, você usa essa plataforma gratuita e open-source de automação para conectar um gatilho — como uma mensagem no Telegram — a um modelo de IA, como o Google Gemini, e devolver a resposta automaticamente. O fluxo recebe a mensagem, processa com a IA, mantém a memória da conversa e responde ao cliente sozinho, 24 horas por dia.

O que é o n8n e por que usá-lo?

O n8n é uma plataforma open-source para automação de fluxos de trabalho, integrando mais de 350 aplicativos e APIs personalizadas por meio de uma interface visual de "nós" (nodes). Sem precisar programar, você arrasta e solta elementos para criar automações, economizando tempo em tarefas manuais.

Para que serve?

• Automatizar tarefas: Integra aplicativos como Telegram, Google Sheets, WhatsApp e e-mails.
• Economizar tempo: Substitui processos operacionais por fluxos automáticos.
• Casos de uso: Cadastro de formulários em bancos de dados, chatbots para atendimento e integração com sistemas personalizados via webhooks.

Exemplo: Um cliente preenche um formulário no seu site, o n8n captura os dados e salva em um Google Sheets ou banco de dados, ou responde automaticamente via Telegram.

Configurando o n8n e criando o fluxo

Como instalar o n8n? Você pode instalar o n8n localmente (funciona enquanto o PC está ligado), em um servidor (24/7) ou usar a versão em nuvem.

Após instalar, acesse a interface em http://localhost:5678 (ou outra porta configurada).

Criando o primeiro fluxo:

1. Na tela inicial do n8n, clique em Create Workflow para abrir o editor.
2. A interface permite arrastar nós, ajustar zoom e salvar fluxos.
3. Todo fluxo começa com um gatilho (trigger), que dispara as ações.

Passo 1: Configurando o gatilho do Telegram

Por que Telegram? O Telegram é gratuito e fácil de configurar, ao contrário do WhatsApp, que exige APIs pagas. Vamos criar um bot para receber mensagens.

Como criar um bot no Telegram?

1. Abra o Telegram e procure por @BotFather (verificado).
2. Inicie o chat com /start.
3. Crie um novo bot com /newbot.
   • Nome: Ex.: Assistente Tecnova.
   • Username: Ex.: @AssistenteTecnovaBot (deve terminar com "Bot").
4. O BotFather fornecerá um access token. Copie-o (ex.: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).

Conectando o Telegram ao n8n:

1. No n8n, clique no botão + e selecione Telegram → On Message.
2. Na configuração do nó, clique em Create New Credential.
3. Cole o access token do BotFather e salve como "Conta Telegram Aula".
4. Teste o nó clicando em Execute Step. Envie uma mensagem (ex.: "Olá") ao bot no Telegram. O n8n deve exibir o texto, chat ID e outras informações.

Dica de privacidade: Nunca compartilhe o access token ou chat ID, pois são exclusivos e sensíveis.

Passo 2: Processando mensagens com Google Gemini

Adicionando o agente de IA:

1. Clique no + e selecione AI Agent.
2. Escolha Google Gemini Chat Model (gratuito, com tokens limitados).
3. Crie uma nova credencial:
   • Acesse Google AI Studio (aistudio.google.com).
   • Faça login com sua conta Google.
   • Clique em Get API Key → Create API Key in new project.
   • Copie a chave e cole no n8n, salvando como "Gemini Aula".
4. No AI Agent, configure:
   • Prompt: Arraste o campo text do nó Telegram (mensagem do usuário, ex.: "Olá").
   • System Message: Defina o contexto da IA. Exemplo:

Você é o assistente virtual oficial da Tecnova Solutions, uma empresa de tecnologia especializada em desenvolvimento de aplicativos, automação de processos e dashboards. Seu papel é atender clientes com respostas claras e profissionais. Forneça informações sobre serviços (desenvolvimento de apps, automações, dashboards), preços estimados (ex.: dashboards a partir de R$ 5.000) e contatos (e-mail: contato@tecnovasolutions.com). Mantenha um tom amigável e profissional.

5. Teste o nó. Envie "Olá, tudo bem?" no Telegram. O Gemini deve responder algo como: "Olá! Tudo ótimo por aqui. Sou o assistente da Tecnova Solutions. Como posso ajudar?"

Passo 3: Enviando respostas automáticas no Telegram

Configurando a resposta:

Adicione um nó Telegram → Send a Text Message.

1. Use a mesma credencial do Telegram ("Conta Telegram Aula").
2. Configure:
   • Chat ID: Arraste o campo chat.id do nó Telegram Trigger.
   • Text: Arraste o campo output do nó AI Agent (resposta da IA).
   • Parse Mode: Defina como HTML para evitar erros de caracteres.
   • Append n8n Attribution: Desmarque para remover o link do n8n.
3. Teste o nó. Envie "Quais serviços vocês oferecem?" no Telegram. O bot deve responder com base no system message.

Passo 4: Adicionando memória ao agente

Por que adicionar memória? Sem memória, o agente processa cada mensagem isoladamente, esquecendo o contexto. Para lembrar informações (ex.: nome do usuário), adicione um nó de memória.

Configurando a memória:

1. Clique no + e selecione Simple Memory.
2. Configure:
   • Session Key: Arraste o chat.id do nó Telegram Trigger.
   • Context Window: Defina como 15 (número de interações lembradas).
3. Ative o fluxo clicando no botão Active no editor.
4. Teste enviando:
   • "Olá, me chamo Rafael."
   • "Qual é meu nome?" O bot deve lembrar e responder: "Seu nome é Rafael!"

Resolvendo erros comuns

Erro de caracteres no Telegram:

• Solução: Configure o Parse Mode como HTML ou Markdown no nó de envio de mensagem.

Erro de conexão com Gemini:

• Verifique a chave de API no Google AI Studio.

Fluxo não responde:

• Certifique-se de que o fluxo está ativo no n8n.
• Consulte a aba Executions para rastrear erros.

Perguntas frequentes sobre agente de IA com n8n

Conclusão: Escalando seu assistente virtual

Você criou um agente de IA que:

• Recebe mensagens no Telegram.
• Processa com Google Gemini, usando um prompt personalizado.
• Responde automaticamente, com memória para contexto.

Próximos passos:

• Integre com WhatsApp ou e-mail (Gmail, Outlook).
• Adicione um banco de dados (ex.: Google Sheets) para salvar interações.
• Expanda o prompt com detalhes como preços, links de inscrição ou FAQs.
• Explore outros nós do n8n, como webhooks para formulários de sites.

Quer dominar a criação de agentes de IA? Conheça a formação No Code + IA da Hashtag Treinamentos!

Caso prefira esse conteúdo no formato de vídeo-aula, assista aos vídeos abaixo ou acesse o nosso canal do YouTube!

O que você aprende neste vídeo

Resposta rápida: Nesta aula, o instrutor constrói do zero um agente de IA para atendimento/vendas no n8n (ferramenta no-code de automação), integrado ao Telegram. O fluxo recebe a mensagem, processa com um modelo de IA (Google Gemini) e responde automaticamente. Ele mostra tudo, sem conhecimento prévio: criar o bot no Telegram, conectar a chave da IA, dar um contexto de empresa (system message) e adicionar memória para o agente lembrar da conversa.

Neste vídeo (41 min):

• 0:00 - O que é o n8n: plataforma no-code de automação (nós conectados por gatilhos) e como um agente de IA funciona.
• 5:00 - Montando o fluxo: receber a mensagem → processar → responder, começando pelo gatilho.
• 7:00 - Conectar o Telegram: criar o bot no BotFather e gerar a credencial (access token) no n8n.
• 14:00 - Testar o recebimento das mensagens dentro do n8n (execute step).
• 16:00 - Adicionar o agente de IA e conectar um modelo de linguagem (Google Gemini, gratuito).
• 29:00 - System message: dar à IA o contexto e o papel da empresa (respostas específicas do negócio).
• 34:00 - Memória: fazer o agente lembrar das mensagens anteriores da conversa.
• 39:00 - Ativar o fluxo para rodar 24/7, funciona também com WhatsApp, e-mail etc.

Hashtag Treinamentos

Para acessar outras publicações de No Code, clique aqui!

---

---

Posts mais recentes de No Code

• 
  Dots do ChatGPT: o que é e como usar esse agente de IA5 de outubro de 2026
  Descubra o que é o Dots do ChatGPT, como configurar, integrar com Slack e agenda e se vale a pena usar esse novo agente de IA da OpenAI.
• 
  GPT-6 Astra: 7 usos reais do novo modelo da OpenAI5 de outubro de 2026
  Veja 7 usos reais do GPT-6 Astra, o novo modelo da OpenAI que executa tarefas sozinho no computador. Entenda como ele funciona e onde ainda erra.
• 
  Jev IA: o que é e como usar essa IA que não escreve5 de outubro de 2026
  Entenda o que é o Jev IA, a inteligência artificial classificadora mais rápida e barata do mercado, e veja 5 usos práticos para seus fluxos.

Posts mais recentes da Hashtag Treinamentos

• 
  Planilha de Controle de Notas Fiscais no Excel [Grátis]2 de outubro de 2026
  Baixe a planilha de controle de notas fiscais no Excel grátis: calcule ISS e retenções, veja o que está em aberto e gere a cobrança de cada nota de serviço.
• 
  Qual IA usar na empresa: ChatGPT, Claude ou Perplexity?2 de outubro de 2026
  Qual IA usar na empresa: veja as diferenças entre ChatGPT, Claude e Perplexity e quando cada um rende mais em cada área da sua equipe.
• 
  Apostilas Gratuitas em PDF: Excel, Power BI, Python e IA30 de setembro de 2026
  Baixe apostilas gratuitas em PDF de Excel, Power BI, Python, Claude e agentes de IA, com exercícios e gabarito. Escolha a sua e comece hoje.