Todos os templates Pela equipe NappAI Bot de gestão de eventos no Telegram
Este fluxo é utilizado para, por meio de uma integração com o Telegram, programar eventos no Google Calendar.
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
TelegramWebhook-no237[Telegram Webhook]
style TelegramWebhook-no237 stroke:#a170ff
ParseData-e810l[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Parse Message]
style ParseData-e810l stroke:#a170ff
TelegramMessage-m4cr5[Telegram Message]
style TelegramMessage-m4cr5 stroke:#a170ff
googlecalendarcomponent-xva04[Crear Eventos]
style googlecalendarcomponent-xva04 stroke:#a170ff
GoogleGenerativeAIModel-cx7b4[Gemini]
style GoogleGenerativeAIModel-cx7b4 stroke:#a170ff
AdvancedAgent-27y8e[Agent]
style AdvancedAgent-27y8e stroke:#a170ff
TelegramWebhook-no237 -.- ParseData-e810l
linkStyle 0 stroke:#a170ff
ParseData-e810l -.- AdvancedAgent-27y8e
linkStyle 1 stroke:#a170ff
TelegramMessage-m4cr5 -.- AdvancedAgent-27y8e
linkStyle 2 stroke:#a170ff
googlecalendarcomponent-xva04 -.- AdvancedAgent-27y8e
linkStyle 3 stroke:#a170ff
GoogleGenerativeAIModel-cx7b4 -.- AdvancedAgent-27y8e
linkStyle 4 stroke:#a170ff
🧩 Descrição Geral
O fluxo integra um bot do Telegram com o Google Calendar, permitindo que usuários agendem eventos enviando uma mensagem ao chat. A mensagem é capturada por um webhook, analisada, interpretada por um agente avançado que utiliza o modelo Gemini da Google e, quando necessário, cria o evento no calendário e confirma a ação ao usuário no Telegram.
⚙️ Funcionalidades Principais
- Recebimento de mensagens em tempo real via webhook do Telegram.
- Extração e formatação de dados do webhook em texto compreensível.
- Processamento de solicitações por um agente inteligente com memória limitada.
- Criação automática de eventos no Google Calendar com dados estruturados.
- Envio de respostas e confirmações ao usuário pelo Telegram.
🔄 Passos do Fluxo de Trabalho
| Nome do Componente | Papel no Fluxo | Entradas Principais | Saídas Principais |
|---|---|---|---|
| Telegram Webhook | Captura de mensagens do Telegram | - Dados do webhook (mensagem, chat_id, message_id, texto) | Dados do webhook formatados para o próximo passo |
| Parse Data | Converte dados do webhook em texto | Dados do webhook | Texto da mensagem do usuário |
| Advanced Agent | Interpreta a solicitação, decide ações e gera resposta | Texto do usuário, ferramentas (Telegram Message, Criar Eventos, Gemini), modelo LLM | Resposta do agente, chamada de ferramentas |
| Telegram Message | Envia mensagem de retorno ao chat do Telegram | chat_id, texto, opções de envio | Confirmação da entrega (status) |
| Criar Eventos | Cria evento no Google Calendar | Summary, start_date, end_date, attendees, create_meet | Dados do evento criado (ID, link) |
| Gemini | Modelo de linguagem usado pelo agente | Prompt, system message | Texto gerado (resposta do agente) |
🧠 Notas
- O fluxo requer credenciais válidas tanto do Telegram quanto do Google Calendar.
- O modelo Gemini deve estar habilitado e configurado com a chave de API apropriada.
- A mensagem enviada pelo agente pode incluir um evento de reunião do Google Meet se
create_meetfor habilitado. - O agente usa memória curta (Trim) e não armazena histórico entre execuções, a menos que
use_checkpointeresteja habilitado. - A estrutura do template em
Parse Datagarante que campos comochat_id,message_idetextosejam extraídos corretamente. - O fluxo suporta execução em lote, mas os exemplos aqui representam uma única solicitação.