Build AI Business Solutions with Workflow Automation | NappAI - Template: Bot de gestión de eventos en Telegram

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% TelegramWebhook-no237[Telegram Webhook] style TelegramWebhook-no237 stroke:#a170ff ParseData-e810l[<div><img 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

Bot de gestión de eventos en Telegram

🧩 Descripción general

Este flujo de trabajo automatiza el proceso de recibir solicitudes de usuarios a través de Telegram y gestionar eventos en el calendario de Google Calendar. Escucha los mensajes entrantes, interpreta la intención del usuario de crear o gestionar eventos y utiliza un agente de IA para ejecutar las acciones apropiadas. El sistema garantiza una comunicación clara enviando una confirmación o el resultado de vuelta al usuario en Telegram, proporcionando una experiencia fluida de asistente personal.

⚙️ Características principales

Recibe y procesa mensajes de usuario desde un webhook de Telegram.
Extrae y estructura información clave como el mensaje del usuario, el ID del chat y el ID del mensaje.
Utiliza un agente de IA para interpretar solicitudes en lenguaje natural y decidir las acciones necesarias.
Se integra con Google Calendar para crear eventos basados en las instrucciones del usuario.
Envía respuestas automatizadas de vuelta al usuario en Telegram para confirmar acciones o proporcionar resultados.

🔄 Pasos del flujo de trabajo

Nombre del componente	Rol en el flujo de trabajo	Entradas clave	Salidas clave
Webhook de Telegram	Recibe el mensaje inicial del usuario y los datos de Telegram.	Datos del webhook entrante que contienen el mensaje y metadatos del usuario.	Datos del mensaje en bruto para su procesamiento.
Analizar mensaje	Estructura los datos brutos del webhook extrayendo el texto del usuario, el ID del chat y el ID del mensaje en un formato claro.	Datos brutos del webhook.	Texto formateado que contiene el mensaje del usuario, el ID del chat y el ID del mensaje.
Modelo Gemini	Proporciona la capacidad central del modelo de lenguaje que impulsa el razonamiento y la toma de decisiones del agente de IA.	Parámetros de configuración del modelo.	Una instancia del modelo de lenguaje configurada para el agente.
Crear eventos (Google Calendar)	Sirve como herramienta para que el agente interactúe con Google Calendar, permitiéndole crear eventos.	Configuración y descripción de la herramienta.	Una herramienta que el agente puede llamar para crear eventos en el calendario.
Mensaje de Telegram	Sirve como herramienta para que el agente envíe mensajes de texto de vuelta al usuario en Telegram.	Configuración y descripción de la herramienta.	Una herramienta que el agente puede llamar para enviar respuestas.
Agente	El componente central de IA que interpreta la solicitud del usuario, decide qué herramientas usar (por ejemplo, crear un evento en el calendario) y orquesta la ejecución.	Mensaje formateado del usuario, el modelo de lenguaje y las herramientas disponibles (Telegram y Google Calendar).	Un mensaje de respuesta final basado en el resultado de las acciones ejecutadas.

🧠 Notas

El flujo de trabajo se activa por un mensaje entrante desde un webhook de un bot de Telegram.
Se instruye al agente de IA para que utilice un formato de fecha ISO 8601 estricto (AAAA-MM-DD para eventos de todo el día, AAAA-MM-DDTHH:MM:SS para eventos con hora) al crear eventos en el calendario para garantizar la precisión.
La instrucción del sistema del agente le indica explícitamente que concluya su ejecución enviando un mensaje de resultado de vuelta al usuario a través de Telegram.
El flujo de trabajo requiere credenciales de API válidas para el Bot de Telegram y los servicios de Google para funcionar.
El razonamiento del agente está limitado por un recuento máximo de iteraciones para evitar bucles infinitos.