Telegram

La integracion con Telegram conecta un bot de Telegram con Almirant para recibir feedback de usuarios, notificaciones de eventos y permitir interaccion basica con la plataforma directamente desde el chat.

Como funciona

Almirant se integra con Telegram a traves de un bot que actua como puente entre los usuarios de Telegram y la plataforma. El bot puede:

• Recibir feedback -- Los usuarios envian mensajes al bot y estos se registran como feedback en Almirant.
• Enviar notificaciones -- Almirant notifica via Telegram sobre eventos relevantes (cambios de estado, asignaciones, alertas de cuota).
• Ejecutar comandos -- Comandos basicos para consultar informacion del proyecto.

Configurar el bot de Telegram

1. Crear el bot

Si tu organizacion no tiene un bot configurado, necesitas crear uno:

1. Abre Telegram y busca @BotFather.
2. Envia el comando /newbot.
3. Sigue las instrucciones para definir el nombre y username del bot.
4. BotFather te proporcionara un token de API. Guardalo de forma segura.

2. Conectar el bot a Almirant

1. Accede a Configuracion > Integraciones > Telegram.
2. Introduce el token de API del bot.
3. Configura las opciones de notificacion deseadas.
4. Guarda la configuracion.
5. Almirant configurara automaticamente el webhook del bot para recibir mensajes.

3. Verificar la conexion

Envia un mensaje de prueba al bot desde Telegram. Deberia aparecer como feedback en Almirant.

Recibir feedback

Una de las funcionalidades principales del bot es recibir feedback de usuarios finales o stakeholders que no tienen acceso a Almirant.

Flujo de feedback

1. Un usuario envia un mensaje al bot de Telegram (texto, imagen o archivo).
2. El bot reenvia el mensaje a Almirant a traves del webhook.
3. Almirant registra el feedback vinculado a la organizacion.
4. El feedback aparece en la seccion de Ideas y Feedback del proyecto para su revision.

Feedback de clientes

El bot de Telegram es ideal para recoger feedback de clientes o usuarios finales que no necesitan acceso directo a Almirant. Comparte el enlace del bot con las personas que quieras que puedan enviar feedback.

Formato de mensajes

El bot acepta diferentes tipos de contenido:

Tipo	Como se procesa
Texto	Se registra como feedback textual
Imagen	Se almacena como adjunto del feedback
Archivo	Se almacena como adjunto del feedback
Respuesta a mensaje	Se vincula como hilo de conversacion

Notificaciones

Configura que eventos del proyecto quieres recibir como notificaciones en Telegram:

Evento	Descripcion
Work item asignado	Un work item se te asigna
Cambio de estado	Un work item cambia de columna en el board
Sprint iniciado/finalizado	Comienza o termina un sprint
Feedback recibido	Se registra nuevo feedback en el proyecto
Cuota de IA	Alerta cuando la cuota esta cerca de agotarse

Para configurar las notificaciones:

1. Accede a Configuracion > Integraciones > Telegram.
2. Activa o desactiva los eventos que quieres recibir.
3. Guarda los cambios.

Comandos del bot

El bot de Telegram soporta comandos basicos para consultar informacion:

Comando	Descripcion
/start	Inicia la interaccion con el bot y muestra un mensaje de bienvenida
/help	Muestra la lista de comandos disponibles
/status	Consulta el estado resumido del proyecto activo
/feedback [texto]	Envia feedback directamente con un comando

Desconectar Telegram

Para desconectar el bot:

1. Accede a Configuracion > Integraciones > Telegram.
2. Haz clic en Desconectar.
3. Confirma la desconexion.

aviso

Desconectar el bot detendra la recepcion de feedback y notificaciones via Telegram. El historial de feedback ya registrado se mantiene en Almirant.

Para Developers

Arquitectura de la integracion

La integracion de Telegram se compone de:

• Webhook endpoint: Recibe las actualizaciones del bot de Telegram (mensajes, comandos, callbacks).
• Procesador de mensajes: Clasifica el tipo de mensaje y lo enruta al servicio correspondiente (feedback, comando, notificacion).
• Servicio de notificaciones: Envia mensajes proactivos al chat de Telegram cuando ocurren eventos en Almirant.

Flujo del webhook

Telegram Bot API --> POST /webhooks/telegram --> Procesador de mensajes
                                                      |
                                        +-------------+-------------+
                                        |             |             |
                                    Feedback     Comando     Notificacion