Telegram-Integration

Erhalten Sie eine Nachricht in Telegram, wenn Ihr Feedback Aufmerksamkeit braucht. Voxtrics postet aus einer Warnung in Telegram: einer Regel, die eingehende Antworten beobachtet, zum Beispiel „mindestens 3 Bewertungen von 2 oder weniger innerhalb einer Stunde“. Die Nachrichten kommen von einem eigenen Telegram-Bot und gehen in einen Chat Ihrer Wahl: eine Gruppe, einen Kanal oder Ihren persönlichen Chat mit dem Bot. Voxtrics braucht eine Adresse, die beides enthält: das Token des Bots und die ID des Chats.

Warnungen erfordern einen kostenpflichtigen Tarif (ab Growth). Siehe Free- und kostenpflichtige Konten.

Einen Bot erstellen

Öffnen Sie in Telegram @BotFather und senden Sie /newbot.
Geben Sie dem Bot einen Namen, zum Beispiel Voxtrics alerts, und einen Benutzernamen, der auf bot endet.
BotFather antwortet mit dem Token des Bots, das so aussieht: 123456789:AAHf0x.... Kopieren Sie es.

Wer das Token hat, kann den Bot steuern und in seinem Namen posten. Halten Sie es – und die Adresse, die Sie unten daraus bilden – von öffentlichen Orten fern. Falls es bekannt wird, senden Sie BotFather /revoke, um ein neues Token zu bekommen, und tragen Sie es in Ihre Warnregeln ein.

Den Bot zum Chat hinzufügen

Eine Gruppe: Fügen Sie den Bot als Mitglied hinzu.
Ein Kanal: Fügen Sie den Bot als Administrator hinzu, der Nachrichten posten darf.
Ihr persönlicher Chat: Öffnen Sie den Bot und tippen Sie auf Start („Starten“). Ein Bot kann niemandem schreiben, der ihn nicht gestartet hat.

Senden Sie dann eine beliebige Nachricht in diesen Chat, damit Telegram im nächsten Schritt etwas anzeigen kann.

Die ID des Chats herausfinden

Öffnen Sie diese Adresse im Browser, mit Ihrem Token anstelle von YOUR_TOKEN:
```
https://api.telegram.org/botYOUR_TOKEN/getUpdates
```
Suchen Sie in der Antwort "chat":{"id": und kopieren Sie die Zahl danach. Die ID einer Gruppe oder eines Kanals beginnt mit einem Minus, zum Beispiel -1001234567890: Behalten Sie das Minus.

Wenn die Antwort leer ist ("result":[]), senden Sie eine weitere Nachricht in den Chat und laden Sie die Seite neu: Telegram speichert diese Daten nur 24 Stunden.

Warnungen an Telegram senden

Setzen Sie Token und Chat-ID in diese Adresse ein:

https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

Gehen Sie zu Warnungen und klicken Sie auf Neue Warnung oder bei einer bestehenden Regel auf das Stiftsymbol (Bearbeiten).
Legen Sie Name, Geltungsbereich, Zeitfenster und Bedingung der Regel fest, wie unter Warnungen beschrieben.
Wählen Sie unter Benachrichtigen über die Option Telegram und fügen Sie die Adresse in Telegram-Webhook-URL ein.
Klicken Sie auf Warnung erstellen bzw. bei einer bestehenden Regel auf Änderungen speichern.

Die Adresse postet nur in den Chat, den sie nennt. Um dieselben Warnungen auch in einem anderen Chat zu bekommen, bilden Sie eine Adresse für diesen Chat und fügen sie mit Telegram-Chat hinzufügen zur Regel hinzu. Mehrere Regeln können dieselbe Adresse verwenden.

Was in der Nachricht steht

Jedes Mal, wenn die Regel auslöst, bekommt der Chat eine kurze Textnachricht auf Englisch mit dem Namen der Regel, der Domain, der Anzahl der passenden Antworten im Zeitfenster und dem Grund für die Auslösung. Die Antworten selbst stehen nicht darin: Öffnen Sie die Auslösung unter Warnungen, um sie zu sehen.

Eine Regel löst höchstens einmal alle 30 Minuten aus, oder seltener, wenn Sie eine Drosselung festlegen. Die Warnungen eines Space posten zusammen höchstens 200 Nachrichten pro Tag an Telegram und Slack. Darüber hinaus löst eine Regel zwar weiterhin aus und die Auslösung erscheint unter „Warnungen“, gepostet wird aber nichts.

Wenn keine Nachrichten ankommen

Wenn sich die Warnung nicht speichern lässt, prüfen Sie, ob die Adresse mit https://api.telegram.org/ beginnt. Voxtrics akzeptiert nur die Bot-API-Adresse von Telegram, keinen t.me-Link zu einem Chat oder Bot.
Prüfen Sie, ob die Regel aktiviert ist und ausgelöst hat: Jede Auslösung ist unter Warnungen aufgeführt.
Wenn die Regel ausgelöst hat, aber nichts in Telegram angekommen ist, prüfen Sie, ob der Bot noch im Chat ist (und in einem Kanal Administrator), ob die Chat-ID ihr Minus behalten hat und ob das Token nicht widerrufen wurde. Wenn Telegram eine Gruppe in eine Supergruppe umwandelt, bekommt sie eine neue ID: Finden Sie sie erneut heraus und aktualisieren Sie die Adresse.