Telegram

Die Telegram-Integration verbindet einen Telegram-Bot mit Almirant, um Nutzerfeedback und Benachrichtigungen zu Ereignissen zu empfangen und eine grundlegende Interaktion mit der Plattform direkt im Chat zu ermöglichen.

So funktioniert es

Almirant integriert sich über einen Bot mit Telegram, der als Brücke zwischen Telegram-Nutzern und der Plattform fungiert. Der Bot kann:

• Feedback empfangen -- Nutzer senden Nachrichten an den Bot, die in Almirant als Feedback erfasst werden.
• Benachrichtigungen senden -- Almirant benachrichtigt über Telegram über relevante Ereignisse (Statusänderungen, Zuweisungen, Kontingentwarnungen).
• Befehle ausführen -- Grundlegende Befehle zum Abrufen von Projektinformationen.

Den Telegram-Bot einrichten

1. Den Bot erstellen

Wenn deine Organisation keinen konfigurierten Bot hat, musst du einen erstellen:

1. Öffne Telegram und suche nach @BotFather.
2. Sende den Befehl /newbot.
3. Folge den Anweisungen, um den Namen und Benutzernamen des Bots festzulegen.
4. BotFather stellt dir einen API-Token bereit. Bewahre ihn sicher auf.

2. Den Bot mit Almirant verbinden

1. Gehe zu Einstellungen > Integrationen > Telegram.
2. Gib den API-Token des Bots ein.
3. Konfiguriere die gewünschten Benachrichtigungsoptionen.
4. Speichere die Konfiguration.
5. Almirant konfiguriert den Webhook des Bots automatisch, um Nachrichten zu empfangen.

3. Verbindung überprüfen

Sende über Telegram eine Testnachricht an den Bot. Sie sollte in Almirant als Feedback erscheinen.

Feedback empfangen

Eine der Hauptfunktionen des Bots ist das Empfangen von Feedback von Endnutzern oder Stakeholdern, die keinen Zugriff auf Almirant haben.

Feedback-Ablauf

1. Ein Nutzer sendet eine Nachricht an den Telegram-Bot (Text, Bild oder Datei).
2. Der Bot leitet die Nachricht über den Webhook an Almirant weiter.
3. Almirant erfasst das mit der Organisation verknüpfte Feedback.
4. Das Feedback erscheint zur Prüfung im Abschnitt Ideen und Feedback des Projekts.

Feedback von Kunden

Der Telegram-Bot eignet sich ideal, um Feedback von Kunden oder Endnutzern zu sammeln, die keinen direkten Zugriff auf Almirant benötigen. Teile den Bot-Link mit Personen, die Feedback senden können sollen.

Nachrichtenformat

Der Bot akzeptiert verschiedene Inhaltstypen:

Typ	Verarbeitung
Text	Wird als Textfeedback erfasst
Bild	Wird als Anhang des Feedbacks gespeichert
Datei	Wird als Anhang des Feedbacks gespeichert
Antwort auf Nachricht	Wird als Konversationsthread verknüpft

Benachrichtigungen

Konfiguriere, welche Projekt-Ereignisse du als Benachrichtigungen in Telegram erhalten möchtest:

Ereignis	Beschreibung
Work Item zugewiesen	Ein Work Item wird dir zugewiesen
Statusänderung	Ein Work Item wechselt die Spalte im Board
Sprint gestartet/abgeschlossen	Ein Sprint beginnt oder endet
Feedback empfangen	Neues Feedback wird im Projekt erfasst
KI-Kontingent	Warnung, wenn das Kontingent fast aufgebraucht ist

So konfigurierst du Benachrichtigungen:

1. Gehe zu Einstellungen > Integrationen > Telegram.
2. Aktiviere oder deaktiviere die Ereignisse, die du erhalten möchtest.
3. Speichere die Änderungen.

Bot-Befehle

Der Telegram-Bot unterstützt grundlegende Befehle zum Abrufen von Informationen:

Befehl	Beschreibung
/start	Startet die Interaktion mit dem Bot und zeigt eine Willkommensnachricht
/help	Zeigt die Liste der verfügbaren Befehle
/status	Ruft den zusammengefassten Status des aktiven Projekts ab
/feedback [texto]	Sendet Feedback direkt mit einem Befehl

Telegram trennen

So trennst du den Bot:

1. Gehe zu Einstellungen > Integrationen > Telegram.
2. Klicke auf Trennen.
3. Bestätige die Trennung.

Warnung

Das Trennen des Bots beendet den Empfang von Feedback und Benachrichtigungen über Telegram. Der bisherige Feedbackverlauf bleibt in Almirant erhalten.

Für Entwickler

Architektur der Integration

Die Telegram-Integration besteht aus:

• Webhook-Endpunkt: Empfängt Aktualisierungen des Telegram-Bots (Nachrichten, Befehle, Callbacks).
• Nachrichtenprozessor: Klassifiziert den Nachrichtentyp und leitet ihn an den entsprechenden Dienst weiter (Feedback, Befehl, Benachrichtigung).
• Benachrichtigungsdienst: Sendet proaktive Nachrichten an den Telegram-Chat, wenn Ereignisse in Almirant eintreten.

Webhook-Ablauf

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