Todas las plantillas Por el equipo NappAI Bot de gestión de eventos en Telegram
Este flujo es utilizado para mediante una integración con telegram programar eventos en 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
Bot de gestión de eventos en Telegram
🧩 Descripción general
El flujo permite gestionar eventos a través de mensajes en Telegram y la creación automática de eventos en Google Calendar. El bot captura un mensaje de Telegram, interpreta la solicitud mediante un modelo de lenguaje, crea el evento en el calendario y devuelve la confirmación al usuario, todo de forma automática y sin intervención humana.
⚙️ Funcionalidades principales
- Captura de mensajes: Se recibe la actualización de Telegram mediante un webhook.
- Parseo de datos: Se extraen y formatean los datos relevantes del mensaje (chat ID, message ID, texto).
- Inteligencia conversacional: Un agente avanzado procesa la petición y decide qué herramientas usar.
- Creación de eventos: Se crea un evento en Google Calendar con formato ISO 8601.
- Respuesta a Telegram: Se envía un mensaje de confirmación al usuario.
🔄 Pasos del flujo de trabajo
| Nombre del componente | Rol en el flujo | Entradas clave | Salidas clave |
|---|---|---|---|
| Telegram Webhook | Recibe actualizaciones de Telegram y construye el objeto de mensaje. | JSON del webhook con campos message, chat.id, message_id, text. |
message (Telegram message), build_data (datos de entrada). |
| Parseo de Mensaje | Convierte los datos del webhook en texto plano y extrae campos esenciales. | data (obtenido de build_data). |
text (mensaje de texto). |
| Agente Avanzado | Procesa el texto, decide acciones y produce una respuesta. | arg_input (texto), llm (Gemini), tools (Telegram Message, Crear Eventos). |
response (mensaje de respuesta). |
| Gemini | Modelo de lenguaje que el agente utiliza para generar y comprender textos. | input_value (texto del agente). |
model_output (instancia del modelo). |
| Crear Eventos | Crea un evento en Google Calendar con los parámetros definidos por el agente. | summary, start_date, end_date, location, attendees (entre otros). |
Data (datos del evento creado). |
| Telegram Mensaje | Envía mensajes, archivos o cualquier acción a Telegram; funciona como herramienta del agente. | text, chat_id, message_id (para respuestas). |
Telegram Response (confirmación de envío). |
Orden secuencial
1️⃣ Telegram Webhook → 2️⃣ Parseo de Mensaje → 3️⃣ Gemini (LLM) → 4️⃣ Agente Avanzado → 5️⃣ Herramientas (Crear Eventos / Telegram Mensaje).
🧠 Notas
- El agente utiliza un system prompt que exige el uso estricto del formato ISO 8601 para fechas y horas (
YYYY-MM‑MMoYYYY-MM‑DDTHH:MM:SS). - El modelo Gemini se configura con el temperature = 1 y sin thinking_budget, lo que favorece la creatividad sin generar razonamientos intermedios.
- Los componentes de Telegram y Google Calendar requieren credenciales válidas (
credential_id). - El flujo no muestra IDs de componentes; se hace referencia únicamente a los nombres legibles.
- El bot se ejecuta en modo asíncrono: cada actualización de Telegram dispara la cadena completa de procesamiento sin bloquear otras conversaciones.
- Si alguna herramienta falla, el agente puede recurrir a los fallback models (no configurados en este flujo).
- Los mensajes de respuesta se envían de forma síncrona a través del componente Telegram Mensaje, garantizando que el usuario reciba la confirmación casi inmediatamente.