Como criar um agente de IA agendador em n8n com Telegram, Google Gemini e Google Calendar

Pedro dos Santos
29 de set.
6 min de leitura

Ilustração futurista mostrando um robô inteligente interagindo com uma tela digital de agendamento automatizado, integrando Telegram e n8n. Conceito visual sobre como criar um agente de IA para gerenciar tarefas e automatizar processos.

Introdução

O uso de agentes de IA deixou de ser um tema exclusivo de grandes empresas de tecnologia e passou a estar acessível para pequenas e médias empresas (PMEs). Hoje, com ferramentas abertas como o n8n e APIs gratuitas disponibilizadas pelo Google, é possível criar soluções práticas que automatizam tarefas do dia a dia, como agendamento de compromissos.

Neste artigo, você vai aprender como construir um agente de IA agendador integrado ao Telegram, Google Gemini e Google Calendar usando o n8n. A ideia é mostrar, passo a passo, como obter as chaves de API necessárias, configurar os nós no n8n e criar uma ferramenta de IA útil.

Por que usar agentes de IA no agendamento de tarefas?

Um dos maiores gargalos de produtividade nas empresas está na gestão de tempo. Marcar reuniões, organizar agendas e sincronizar diferentes compromissos pode consumir horas de trabalho que poderiam ser aplicadas em atividades estratégicas.

Com um agente de IA agendador, você pode:

Automatizar agendamentos via Telegram (canal acessível para clientes e equipe).
Usar a IA generativa do Google Gemini para interpretar mensagens em linguagem natural.
Integrar com o Google Calendar, criando eventos automaticamente sem necessidade de interação manual.

Estudos da Harvard Business Review (2023) já apontam que tarefas administrativas consomem em média 28% do tempo de profissionais de escritório. A automação, apoiada por IA, reduz esse percentual de forma significativa, impactando diretamente a produtividade.

Visão geral da arquitetura no n8n

Antes de entrar no passo a passo, é importante visualizar a arquitetura:

Telegram: Usuário envia uma mensagem solicitando um agendamento.
n8n: Captura a mensagem do Telegram.
Google Gemini (API): Interpreta a solicitação em linguagem natural (“Marque uma reunião amanhã às 15h com o cliente João”).
Google Calendar (API): Cria o evento automaticamente.
Telegram: Retorna a confirmação ao usuário.

Essa integração é possível porque o n8n funciona como um “hub de automação”, conectando APIs de diferentes serviços.

Captura de tela do BotFather no Telegram mostrando o processo de criação de um bot, incluindo comandos como /newbot e o token de acesso à API, passo essencial em tutoriais sobre como criar um bot no Telegram e integrar em projetos de automação com IA.

Como obter as chaves de API necessárias

Iremos criar um agente cuja função é marcar eventos no Google Calendar a partir de eventos, funcionando como um agendador de tarefas. As ferramentas utilizadas serão gratuitas, com a possível exceção da ferramenta n8n, caso você não a tenha por meio do self host.

Para conseguir replicar esse tutorial, você precisará de:

Uma instância do n8n. Para tal, você pode buscar como fazer self host de uma instância do n8n ou contratar uma versão online
Uma conta Google

1. Google Gemini: chave gratuita no Google AI Studio

Captura de tela da tela inicial do Google AI Studio mostrando a interface para criação de prompts no Gemini, com opções para aceitar os termos de serviço e obter uma chave de API: guia visual sobre como começar a usar o Google AI Studio para criar e testar modelos de IA generativa.

1. Acesse: https://aistudio.google.com e aceite os termos de serviço. Caso necessário, faça login com sua conta Google

Tela do Google AI Studio mostrando a tela principal, com destaque para a opção “Get API key”, etapa essencial no processo de como criar um agente de IA

2. Vá até a seção API Keys no canto inferior esquerdo.

Tela do Google AI Studio mostrando a seção de chaves de API, com o botão “Criar chave de API” destacado, etapa essencial para configurar o acesso e aprender como criar um agente de IA

3. Clique na opção criar chave de API

Tela do Google AI Studio exibindo a criação de um novo projeto chamado “Projeto agendador”, com a opção “Create project” destacada, passo fundamental no processo de como criar um agente de IA.

4. Forneça um nome para a chave e selecione a opção criar novo projeto no menu inferior

Captura de tela do painel do Google AI Studio mostrando a seção de chaves de API, etapa essencial no processo de como criar um agente de IA com integração ao projeto e configuração de chave de API.

5. Ao finalizar a etapa anterior, você voltará para a página de chaves, mas agora haverá uma chave cadastrada. Clicando nela, você terá acesso à chave da API do Google Gemini.

Captura de tela do Google AI Studio exibindo os detalhes da chave de API de um projeto, mostrando como copiar a chave necessária para integrar o projeto ao criar um agente de IA.

6. Clicando na opção destacada, você copiará a chave da API. Ela será utilizada na configuração do projeto.

Dica: O plano gratuito do Google oferece milhares de tokens por mês, suficiente para projetos pequenos e médios.

2. Google Calendar: chave gratuita no Google Cloud

Tela de cadastro do Google Cloud mostrando a etapa de aceitação dos Termos de Serviço, passo necessário para configurar o ambiente e prosseguir no processo de como criar um agente de IA.

1. Acesse: https://console.cloud.google.com e aceite os termos de serviço. Caso necessário, faça login com sua conta Google

Tela inicial do Google Cloud mostrando o botão “Selecione um projeto”, primeiro passo de como criar um agente de IA na plataforma

2. Vá até a opção selecione um projeto.

Tela de seleção de projeto no Google Cloud mostrando o projeto “projetoAgendador”, etapa essencial de como criar um agente de IA

3. Selecione o projeto já criado.

Tela de pesquisa no Google Cloud mostrando a busca pela “Google Calendar API”, etapa essencial de como criar um agente de IA integrado ao Google Calendar

4. Busque a opção Calendar e selecione a opção Google Calendar API.

Tela do Google Cloud mostrando a página da API do Google Calendar, apresentando o botão de ativação da API

5. Ative a API do Google Calendar.

Tela do Google Cloud mostrando a API do Google Calendar ativada, com destaque para o botão “Criar credenciais”, etapa fundamental no processo de integração entre o Google Calendar e um agente de IA

6. Selecione a opção criar credenciais.

Tela do Google Cloud exibindo a etapa de seleção do tipo de credencial para a Google Calendar API, com a opção “Dados do usuário” marcada e o botão “Avançar” em destaque

7. Selecione o tipo de credencial e clique em avançar.

Tela do Google Cloud mostrando a configuração da tela de permissão OAuth ao criar credenciais para um projeto, etapa essencial em como criar um agente de IA com acesso à API do Google Calendar

8. Dê um nome ao App e forneça emails de suporte e de desenvolvedor, depois clique em avançar.

Tela do Google Cloud mostrando a etapa de criação de credenciais OAuth com o botão “Salvar e continuar” destacado, uma parte do processo de configuração necessária para criar um agente de IA integrado à API do Google Calendar.

9. A seção de escopo é opcional, então clique em salvar e continuar.

Tela do Google Cloud mostrando a configuração de URIs de redirecionamento autorizados e chaves secretas do cliente OAuth

10. Selecione o tipo do aplicativo e o nome. Na opção Adicionar URI será necessário adicionar a URL de Callback da sua instância do n8n. Caso você já saiba a sua, adicione-a aqui. Caso contrário, voltaremos a esse passo posteriormente. Clique em salvar

Tela do Google Cloud mostrando a etapa de download das credenciais OAuth em formato JSON, parte essencial do processo de configuração de APIs para integração com um agente de IA.

11. Clique na opção Download e por fim, Concluído. Será realizado o Download de um arquivo JSON contendo o Client ID e o Client Secret. Essas informações serão usadas na configuração do projeto

3. Telegram: criando um bot

Abra o Telegram e busque pelo BotFather, clicando no item de pesquisa no canto superior direito.
Use o comando /newbot.
Dê um nome e um username para o bot.
O BotFather fornecerá um Token de API: copie e guarde.

Exemplo de criação de bot no Telegram usando o BotFather, etapa essencial no processo de como criar um agente de IA, mostrando a geração do token de acesso à API do Telegram

4. Como criar um agente de IA no n8n

Para prosseguir com o processo, será necessário ter uma instância do n8n.

Tela inicial do n8n mostrando a opção ‘Create Workflow’ destacada, passo fundamental no processo de como criar um agente de IA

1. Acesse sua instância do n8n e clique em create workflow e forneça um nome para o projeto.

Tela do n8n configurando o trigger ‘On message’ do Telegram, etapa prática de como criar um agente de IA

2. Com o projeto criado, clique em add first step e busque por telegram na barra da direita e clique em Telegram. Na lista de ferramentas do Telegram, busque por Triggers e On Message.

Tela do n8n mostrando o processo de criação de credencial do Telegram, passo essencial em como criar um agente de IA para integração com o Telegram, destacando a opção “Create new credential”.

3. Clique para criar uma credencial do Telegram. Você precisará fornecer o Token de acesso obtido na criação do bot através do BotFather. Clique fora da área do Telegram Trigger para voltar ao canva.

Interface do n8n exibindo o nó “Telegram Trigger” conectado, destacando o botão de adição de novo nó, etapa importante em como criar um agente de IA integrado ao Telegram

4. No canva, clique para adicionar um node após o Telegram Trigger.

Interface do n8n mostrando a seleção do nó “AI Agent”, etapa fundamental em como criar um agente de IA integrado ao Telegram para automação inteligente.

5. Clique em AI (é a primeira opção) e selecione AI Agent.

Interface do n8n mostrando a configuração do parâmetro System Message em um agente de IA, parte o processo de como criar um agente de IA

6. Clique em Add Option e adicione System Message. No quadro disponível, escreva um prompt descrevendo a função do agente de forma geral, boas práticas e instruções.

Configuração de agente de IA no n8n mostrando a adição do modelo Google Gemini Chat Model, etapa prática de como criar um agente de IA

7. Clique no ícone "+" do Chat Model, busque por gemini e adicione o Google Gemini Chat Model.

Tela de configuração da chave de API do Google Gemini no n8n, mostrando conexão bem-sucedida, etapa essencial de como criar um agente de IA com integração ao modelo Gemini.

8. Clique em create credential e em seguida, adicione API key optida no item 6 da seção sobre a API do Gemini.

Captura de tela de workflow no n8n mostrando como criar um agente de IA com memória simples. A imagem destaca a configuração da memória “Simple Memory”

9. Clique para adicionar memória e selecione a opção Simple Memory.

Captura de tela do workflow no n8n mostrando como criar um agente de IA com integração ao Google Calendar. A imagem destaca a adição do “Google Calendar Tool” ao agente de IA, após configurar o modelo Google Gemini Chat e a simple memory

10. Clique para adicionar uma Tool, busque por calendar e adicione o Google Calendar Tool.

Tela de configuração no n8n mostrando como criar um agente de IA com integração ao Google Calendar, destacando os campos OAuth Redirect URL, Client ID e Client Secret necessários para conectar a API do Google Calendar.

11. Adicione o client ID e o Client Secret que foram obtidos através do JSON baixado na etapa 12 sobre o Google Calendar API. Após isso, clique sobre o item OAuth Redirect URL para copiar o seu texto.

Tela do Google Cloud mostrando o menu APIs e serviços com a opção Credenciais destacada, passo essencial no tutorial sobre como criar um agente de IA.

12. Volte até https://console.cloud.google.com, vá até APIs e Serviços na barra lateral, em seguida Credenciais.

Tela de credenciais do Google Cloud mostrando a criação de um cliente OAuth 2.0 chamado Agendador, etapa do processo de como criar um agente de IA

13. Clique na opção IDs do cliente OAuth 2.0.

Tela do Google Cloud mostrando a configuração de URIs de redirecionamento autorizados e chaves secretas do cliente OAuth, etapa essencial de como criar um agente de IA

14. Busque a opção URIs de redirecionamento autorizados e cole a URL copiada no item 11 da presente seção. Clique em salvar. Aguarde alguns minutos e volte a tela de configuração do Calendar no n8n (passo 11) e clique em Sign in with Google. Faça login com sua conta Google.

Tela de configuração do nó de criação de evento no Google Calendar dentro de um workflow de automação de um agente de IA integrado, mostrando opções de credenciais, seleção de calendário e parâmetros de evento.

15. Vá até Select a Calendar e selecione a opção com a sua conta Google. Nas opções start e end clique no ícone à direita para que o agente possa selecionar os horários de início e fim dos eventos. Note que, em operation, temos a opção Create, o que significa que precisaríamos adicionar mais tools como essa para adicionar as opções delete e update para apagar e atualizar eventos.

Interface de configuração de trigger do Telegram em um fluxo de automação, mostrando a execução do passo para receber mensagens e ilustrar como criar um agente de IA que interage com usuários pelo Telegram.

16. Clique duas vezes sobre o Telegram trigger e selecione a opção execute step. Envie uma mensagem de texto para o bot que você criou (basta clicar no link fornecido pelo BotFather).

Configuração de prompt no nó AI Agent mostrando a integração da mensagem do usuário no fluxo de automação, etapa essencial para entender como criar um agente de IA no n8n

17. Na opção source for prompt substitua para Define Below e após clique com o botão esquerdo do mouse sobre a opção text e arraste até o campo Prompt user Message.

Captura de tela mostrando a configuração de um nó de memória simples no editor de fluxos de automação, com destaque para o campo de Session ID e a chave configurada, etapa essencial no processo de como criar um agente de IA

18. Vá até a simple memory, selecione a opção Define Below na seção Session ID e arraste a opção ID até o campo Key. Agora, volte ao AI Agent clicando duas vezes sobre ele e selecione a opção Execute step.

Captura de tela de workflow no n8n mostrando a configuração de um agente de IA com integração ao Telegram, Google Gemini Chat Model, memória simples e criação de eventos no Google Calendar, etapa prática do processo de como criar um agente de IA

19. Clique para adicionar uma ferramenta ao workflow, busque por telegram e selecione Send a text message.

Captura de tela da configuração do nó “Send a text message” no n8n, para enviar mensagens automáticas via Telegram, etapa essencial no processo de como criar um agente de IA

20. Arraste a opção ID até Chat ID e a opção Output até Text.

Pontos Finais

Na parte superior do canva há a opção activate que permite que o workflow fique ativo respondendo todas as solicitações vindas por meio do telegram. De forma geral, o agente sugerido é bastante simples e visa demonstrar conceitos básicos de como utilizar a ferramenta n8n. Uma utilização em ambiente de produção exigiria um desenvolvimento mais complexo para lidar com possíveis erros, mas espero que esse tutorial te incentive a conhecer o mundo dos agentes de IA e as possibilidades que essas ferramentas proporcionam.

Pronto para aplicar agentes de IA com RAG no seu negócio?

RAG não é apenas um aprimoramento técnico: é a coluna vertebral que transforma modelos generativos em agentes úteis, confiáveis e auditáveis. Para empresas que precisam de automações com impacto real (redução de custos, velocidade e conformidade) agentes com RAG são a solução prática. Frameworks como Langflow, LangGraph, LlamaIndex e vector DBs (Pinecone, Weaviate) aceleram esse caminho, enquanto plataformas de automação (p.ex., n8n) ajudam a integrar ações no mundo real.

Quer implantar um agente com RAG na sua empresa? Oferecemos serviços de avaliação, POC e implantação desde a curadoria de dados até a governança e monitoramento. Fale com nossos especialistas e transforme processos críticos com agentes de IA confiáveis.