Todas las plantillas Por el equipo NappAI Gestión dinámica de datos con control de permisos
El sistema recibe mensajes vía webhook de Telegram, extrae el chat ID y consulta Airtable para verificar permisos. Con esta información, genera un *prompt* que incluye el permiso de escritura, el nombre del usuario y su consulta. El agente responde según
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
GoogleGenerativeAIModel-i707k[Gemini]
style GoogleGenerativeAIModel-i707k stroke:#a170ff
Airtable-s73yv[tabla de usuarios]
style Airtable-s73yv stroke:#a170ff
ParseData-cl1k4[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>chat id]
style ParseData-cl1k4 stroke:#a170ff
Airtable-po2dl[leer]
style Airtable-po2dl stroke:#a170ff
Prompt-atel3[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt]
style Prompt-atel3 stroke:#a170ff
ParseData-dv38v[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>permiso de escritura]
style ParseData-dv38v stroke:#a170ff
ParseData-fa09s[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>nombre de usuario]
style ParseData-fa09s stroke:#a170ff
Airtable-f0dty[crear]
style Airtable-f0dty stroke:#a170ff
Airtable-l94gq[actualizar]
style Airtable-l94gq stroke:#a170ff
Airtable-5g9n1[borrar]
style Airtable-5g9n1 stroke:#a170ff
TelegramMessage-k3ykl[Telegram Message]
style TelegramMessage-k3ykl stroke:#a170ff
TelegramWebhook-1wmai[Telegram Webhook]
style TelegramWebhook-1wmai stroke:#a170ff
AdvancedAgent-ob1ay[Agent]
style AdvancedAgent-ob1ay stroke:#a170ff
ParseData-cl1k4 -.- Airtable-s73yv
linkStyle 0 stroke:#a170ff
Airtable-s73yv -.- ParseData-dv38v
linkStyle 1 stroke:#a170ff
Airtable-s73yv -.- ParseData-fa09s
linkStyle 2 stroke:#a170ff
ParseData-dv38v -.- Prompt-atel3
linkStyle 3 stroke:#a170ff
ParseData-fa09s -.- Prompt-atel3
linkStyle 4 stroke:#a170ff
TelegramWebhook-1wmai -.- ParseData-cl1k4
linkStyle 5 stroke:#a170ff
TelegramWebhook-1wmai -.- Prompt-atel3
linkStyle 6 stroke:#a170ff
Prompt-atel3 -.- AdvancedAgent-ob1ay
linkStyle 7 stroke:#a170ff
Airtable-po2dl -.- AdvancedAgent-ob1ay
linkStyle 8 stroke:#a170ff
Airtable-f0dty -.- AdvancedAgent-ob1ay
linkStyle 9 stroke:#a170ff
Airtable-l94gq -.- AdvancedAgent-ob1ay
linkStyle 10 stroke:#a170ff
Airtable-5g9n1 -.- AdvancedAgent-ob1ay
linkStyle 11 stroke:#a170ff
GoogleGenerativeAIModel-i707k -.- AdvancedAgent-ob1ay
linkStyle 12 stroke:#a170ff
AdvancedAgent-ob1ay -.- TelegramMessage-k3ykl
linkStyle 13 stroke:#a170ff
🧩 Descripción general
El flujo automatiza la interacción entre un usuario de Telegram y una base de datos de Airtable.
Recibe mensajes por webhook, identifica al remitente, comprueba sus permisos de escritura y, según la intención del mensaje, lee, crea, actualiza o elimina registros en Airtable, devolviendo la respuesta a través de Telegram.
⚙️ Funcionalidades principales
- Recepción y parsing de mensajes de Telegram mediante un webhook.
- Obtención de la identificación del chat y de los permisos del usuario en Airtable.
- Generación de un prompt dinámico que incluye permiso, nombre de usuario y el contenido del mensaje.
- Ejecutar acciones de lectura, escritura o borrado en Airtable según los permisos y la intención del usuario.
- Respuesta de la IA mediante un modelo de lenguaje (Gemini) y envío del texto resultante a Telegram.
🔄 Pasos del flujo de trabajo
| Nombre del componente | Rol en el flujo | Entradas clave | Salidas clave |
|---|---|---|---|
| Telegram Webhook | Recibe el mensaje entrante y crea la estructura de datos | bot_token, data (JSON del webhook) |
message, build_data |
| Parsear datos (chatid) | Extrae el chatid para la búsqueda de permisos | data (JSON del webhook) |
text (chatid) |
| Leer usuarios (Airtable) | Consulta Airtable con el chatid para obtener permisos | filter_by_formula (chatid), Operation: Read |
result (datos del usuario) |
| Parsear datos (permiso) | Obtiene el campo “Permisos de administrador” | result (datos del usuario) |
text (permiso) |
| Parsear datos (usuario) | Obtiene el nombre de usuario | result (datos del usuario) |
text (usuario) |
| Parsear datos (mensaje) | Extrae el texto del mensaje original | message |
text (mensaje) |
| Prompt | Construye el prompt con permiso, usuario y mensaje | permiso, usuario, mensaje |
prompt (texto de entrada) |
| Agente avanzado | Procesa el prompt con Gemini y los tools de Airtable | prompt (texto de entrada), llm (Gemini), tools (Airtable) |
response (texto de salida) |
| Mensaje Telegram | Envía la respuesta al chat | response (texto de salida) |
Telegram Response |
🧠 Notas
- El componente Telegram Webhook almacena el mensaje recibido en la historia si
should_store_messageestá activo. - Los components Airtable están configurados con operaciones “Read”, “Create”, “Update” y “Delete”; el agente decide cuál usar según el permiso del usuario.
- El modelo de lenguaje (Gemini) se ejecuta con un pensamiento limitado (pensamiento de 0 tokens) y no muestra pensamientos en la salida.
- Los prompts se construyen con variables
{permiso},{usuario}y{mensaje}, garantizando que la IA conozca los permisos y la identidad del remitente antes de decidir la acción. - El flujo garantiza que los usuarios sin permiso de escritura solo puedan realizar consultas de lectura; cualquier intento de escritura se ignora.
- El componente Telegram Message está configurado en modo “Basic”, utilizando el
chat_idproveniente del webhook. - El flujo no incluye IDs ni parámetros internos; los nombres de los componentes se presentan de forma legible y coherente en español.