Zum Hauptinhalt springen

🤖 Telegram Bot

PulseHub verbindet sich über die Bot API mit Telegram. Wenn Benutzer Ihrem Telegram-Bot Nachrichten senden, erscheinen diese in PulseHub.


Voraussetzungen

Ein Telegram-Konto und Zugang zu @BotFather zum Erstellen eines Bots.


Einrichtungsschritte

1. Bot mit BotFather erstellen

  1. Öffnen Sie Telegram und suchen Sie nach @BotFather
  2. Senden Sie /newbot
  3. Wählen Sie einen Anzeigenamen (z.B. „Acme Support")
  4. Wählen Sie einen Benutzernamen, der auf bot endet (z.B. acmesupport_bot)
  5. BotFather antwortet mit Ihrem Bot Token

2. Kanal in PulseHub hinzufügen

  1. Gehen Sie zu Kanäle → Kanal hinzufügen
  2. Wählen Sie Telegram
  3. Fügen Sie Ihr Bot Token ein
  4. Klicken Sie auf Kanal speichern
  5. Kopieren Sie die Webhook-URL

3. Webhook bei Telegram registrieren

Öffnen Sie diese URL in Ihrem Browser:

https://api.telegram.org/bot{IHR_BOT_TOKEN}/setWebhook?url={IHRE_PULSEHUB_WEBHOOK_URL}

Telegram antwortet mit: {"ok": true, "result": true, "description": "Webhook was set"}

4. Testen

Öffnen Sie Ihren Bot in Telegram und senden Sie eine Nachricht. Sie sollte in PulseHub innerhalb von Sekunden erscheinen.


Telegrams Webhook-Anforderungen

  • Die Webhook-URL muss HTTPS mit einem gültigen SSL-Zertifikat verwenden
  • Telegram erwartet eine 200-Antwort innerhalb von 60 Sekunden

Häufige Probleme

SymptomWahrscheinliche Ursache
Webhook nicht gesetztURL muss HTTPS mit gültigem Zertifikat sein
Bot antwortet nichtPrüfen Sie, ob telegram_chat_id in contacts.external_ids vorhanden ist
Alte Nachrichten erneut zugestelltNormal bei Webhook-Neuregistrierung