Telegram

L'intégration Telegram connecte un bot Telegram à Almirant pour recevoir du feedback utilisateur, des notifications d'événements et permettre une interaction de base avec la plateforme directement depuis le chat.

Fonctionnement

Almirant s'intègre à Telegram par l'intermédiaire d'un bot qui fait le lien entre les utilisateurs de Telegram et la plateforme. Le bot peut :

• Recevoir du feedback -- Les utilisateurs envoient des messages au bot et ceux-ci sont enregistrés comme feedback dans Almirant.
• Envoyer des notifications -- Almirant notifie via Telegram des événements pertinents (changements d'état, attributions, alertes de quota).
• Exécuter des commandes -- Des commandes de base pour consulter les informations du projet.

Configurer le bot Telegram

1. Créer le bot

Si votre organisation n'a pas de bot configuré, vous devez en créer un :

1. Ouvrez Telegram et recherchez @BotFather.
2. Envoyez la commande /newbot.
3. Suivez les instructions pour définir le nom et le username du bot.
4. BotFather vous fournira un token d'API. Conservez-le de manière sécurisée.

2. Connecter le bot à Almirant

1. Accédez à Configuration > Intégrations > Telegram.
2. Saisissez le token d'API du bot.
3. Configurez les options de notification souhaitées.
4. Enregistrez la configuration.
5. Almirant configurera automatiquement le webhook du bot pour recevoir les messages.

3. Vérifier la connexion

Envoyez un message de test au bot depuis Telegram. Il doit apparaître comme feedback dans Almirant.

Recevoir du feedback

L'une des principales fonctionnalités du bot consiste à recevoir le feedback d'utilisateurs finaux ou de stakeholders qui n'ont pas accès à Almirant.

Flux de feedback

1. Un utilisateur envoie un message au bot Telegram (texte, image ou fichier).
2. Le bot transfère le message à Almirant via le webhook.
3. Almirant enregistre le feedback lié à l'organisation.
4. Le feedback apparaît dans la section Ideas et Feedback du projet pour révision.

Feedback client

Le bot Telegram est idéal pour recueillir le feedback de clients ou d'utilisateurs finaux qui n'ont pas besoin d'un accès direct à Almirant. Partagez le lien du bot avec les personnes auxquelles vous souhaitez permettre d'envoyer du feedback.

Format des messages

Le bot accepte différents types de contenu :

Type	Traitement
Texte	Enregistré comme feedback textuel
Image	Stockée comme pièce jointe du feedback
Fichier	Stocké comme pièce jointe du feedback
Réponse à un message	Liée sous la forme d'un fil de conversation

Notifications

Configurez les événements du projet que vous souhaitez recevoir comme notifications dans Telegram :

Événement	Description
Work item attribué	Un work item vous est attribué
Changement d'état	Un work item change de colonne dans le board
Sprint démarré/terminé	Un sprint commence ou se termine
Feedback reçu	Un nouveau feedback est enregistré dans le projet
Quota IA	Alerte lorsque le quota est presque épuisé

Pour configurer les notifications :

1. Accédez à Configuration > Intégrations > Telegram.
2. Activez ou désactivez les événements que vous souhaitez recevoir.
3. Enregistrez les modifications.

Commandes du bot

Le bot Telegram prend en charge des commandes de base pour consulter des informations :

Commande	Description
/start	Démarre l'interaction avec le bot et affiche un message de bienvenue
/help	Affiche la liste des commandes disponibles
/status	Consulte l'état résumé du projet actif
/feedback [texte]	Envoie directement du feedback avec une commande

Déconnecter Telegram

Pour déconnecter le bot :

1. Accédez à Configuration > Intégrations > Telegram.
2. Cliquez sur Déconnecter.
3. Confirmez la déconnexion.

attention

Déconnecter le bot arrêtera la réception de feedback et les notifications via Telegram. L'historique du feedback déjà enregistré reste dans Almirant.

Pour les développeurs

Architecture de l'intégration

L'intégration Telegram se compose des éléments suivants :

• Webhook endpoint : Reçoit les mises à jour du bot Telegram (messages, commandes, callbacks).
• Processeur de messages : Classe le type de message et l'achemine vers le service correspondant (feedback, commande, notification).
• Service de notifications : Envoie des messages proactifs au chat Telegram lorsqu'un événement se produit dans Almirant.

Flux du webhook

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