Projekte und Kanäle
Projekt erstellen, Bot verbinden und seinen Status prüfen. Mehrere Kanäle, Tokenwechsel, Pausieren und Wiederherstellung nach einer tarifbedingten Sperre.
Auf dieser Seite
Ein Projekt umfasst die Einstellungen, Reaktionen und Daten eines Bots oder Dienstes. Ein Kanal verbindet das Projekt mit einem Ort, an dem Menschen es erreichen: einem Telegram-Bot, einem Website-Chat oder einem anderen Messenger. Eine Schule kann zum Beispiel ein Projekt mit zwei Kanälen betreiben, Telegram und Website.
Erstellen Sie das Projekt unter Projekte und fügen Sie danach einen Kanal hinzu. Für Telegram brauchen Sie den Token von @BotFather, mit dem der Bot verwaltet wird. Oben im Dashboard können Sie zwischen Projekten wechseln.
Ein Bot ist nicht auf Telegram beschränkt. Sie können auch WhatsApp und VK verbinden und dieselben Reaktionen in allen Messengern nutzen. Einen Überblick finden Sie unter Kanäle, die WhatsApp-Einrichtung unter WhatsApp.
Bot verbinden
- Falls noch kein Projekt vorhanden ist, öffnen Sie Projekte und klicken auf Projekt hinzufügen. Klicken Sie auf der Projektkarte auf Kanal hinzufügen und wählen Sie Telegram. Für den ersten Bot können Sie auch den Einrichtungsassistenten nutzen.
- Fügen Sie den Token von @BotFather ein und klicken Sie auf Prüfen. GetMyBot zeigt den gefundenen
@username, damit Sie den richtigen Bot erkennen. - Klicken Sie auf Verbinden. Der Token wird verschlüsselt gespeichert; der Empfang von Ereignissen beginnt sofort.
Nach dem Verbinden erscheint Telegram neben den anderen Kanälen auf der Projektkarte. Dort sehen Sie den Projektnamen, den @username des Bots sowie die Zahl der Nutzer, aktiven Reaktionen und heutigen Anfragen. Das verbleibende Anfragenguthaben finden Sie unter Abrechnung oder Statistik.
Mehrere Bots
Ein Konto kann mehrere Projekte und Bots gleichzeitig verwalten. Die Zahl ist durch den Tarif begrenzt (Einstellung „maximale Bots“). Wechseln Sie oben oder unter Projekte zwischen ihnen. Bereiche wie „Reaktionen“, „Chats“ und „Statistik“ zeigen jeweils die Daten des ausgewählten Projekts.
Wie der Bot Nachrichten empfängt
Nach dem Verbinden empfängt GetMyBot Telegram-Ereignisse automatisch: Nachrichten, Tastendrücke, Beitritte zu einem Chat und Zahlungen. Sie brauchen den Empfang nicht gesondert einzurichten; ein gültiger Token genügt. Je nach Serverkonfiguration sendet Telegram Ereignisse an eine Adresse der Plattform (Webhook) oder GetMyBot fragt sie regelmäßig bei Telegram ab (Long Polling).
Ein- und Ausschalten
Jeder Bot kann eingeschaltet oder ausgeschaltet sein. Den Schalter finden Sie in der Karte Bot-Status unter Einstellungen. Ein ausgeschalteter Bot reagiert nicht auf Nachrichten. Die Änderung gilt sofort; Sie müssen den Kanal nicht neu verbinden.
Projektstatus und Erreichbarkeit der Kanäle
In der Liste Projekte wird der Projektstatus separat angezeigt: Aktiv, Pausiert oder Eingefroren. Er ist keine Zustellbestätigung von Telegram. Jeder Kanal hat daneben eine eigene Kennzeichnung: Online, Kein Signal, Konfiguriert, Deaktiviert oder Projekt inaktiv. Ein aktives Projekt mit Website-Chat und ohne Telegram erscheint deshalb nicht als gestoppt.
Hat ein aktives Projekt genau einen eingeschalteten Telegram-Kanal, bedeutet Online, dass sich der zuständige Prozess vor Kurzem gemeldet hat. Fehlt diese Meldung, steht dort Kein Signal. Bei mehreren eingeschalteten Telegram-Kanälen steht Konfiguriert, weil sich die gemeinsame Meldung des Projekts keinem einzelnen Kanal sicher zuordnen lässt. Bei eingeschalteten Kanälen anderer Plattformen bedeutet Konfiguriert, dass sie verbunden sind. Die Kennzeichnung garantiert nicht, dass jede einzelne Nachricht zugestellt wird.
Die Plattform besteht aus mehreren gleichberechtigten Prozessen. Jeder meldet sich alle 30 Sekunden für die Bots, die er betreut. Eine Meldung gilt eineinhalb Minuten lang als aktuell, damit eine einzelne ausgefallene Meldung den Status nicht sofort wechseln lässt.
Für die Praxis heißt das:
- Die Kennzeichnung kann verzögert erscheinen. Nach dem Verbinden oder Neustarten der Plattform kann es bis zu diesem Zeitfenster dauern, bis Online angezeigt wird.
- Steht bei einem eingeschalteten Telegram-Kanal Kein Signal länger als ein paar Minuten, prüfen Sie den Token und die Karte Bot health in den Einstellungen. Das Projekt bleibt trotzdem aktiv, solange Sie es nicht pausieren oder die Plattform es wegen des Tarifs einfriert.
- Die Meldung ist für alle Prozesse gemeinsam. Sie hängt nicht davon ab, welcher Server Ihre Anfrage beantwortet. Bei mehreren Telegram-Kanälen belegt sie nicht die Erreichbarkeit jedes einzelnen Kanals.
Wenn ein Bot offline ist
Einmal pro Minute prüft die Plattform die Meldungen. Fehlt für einen eingeschalteten Bot jede aktuelle Meldung, wird ein Vorfall angelegt. Die Plattform ermittelt einmal die Ursache und versucht anschließend selbst, den Bot wiederherzustellen.
Die Karte Bot health zeigt eine von vier Ursachen:
- Webhook: Telegram liefert keine Ereignisse an die Plattformadresse. Die Plattform registriert den Webhook erneut.
- Token widerrufen:
getMeantwortet mit401. Ein automatischer Neustart hilft hier nicht. Erstellen Sie in @BotFather einen neuen Token und tragen Sie ihn über Token wechseln ein. - Kein betreuender Server: Niemand verarbeitet die Ereignisse. Die Plattform startet den Bot neu.
- Ursache unbekannt: Telegram hat auf die Prüfung nicht geantwortet.
Ein Neustart führt dieselben Schritte aus wie Synchronisieren: Der Token wird mit getMe geprüft und der Webhook erneut registriert. Bei Fehlschlägen wartet die Plattform vor dem nächsten Versuch zunehmend länger. Jeder Versuch wird im Neustartprotokoll des Vorfalls erfasst, mit Uhrzeit, Ergebnis und gegebenenfalls Fehlermeldung. Dort sehen Sie auch, wann der nächste Versuch ansteht.
Bleibt der Bot länger offline als der in Bot health eingestellte Grenzwert (standardmäßig 5 Minuten), erhält der Eigentümer die Benachrichtigung „Bot offline“ über die Benachrichtigungsglocke und per E-Mail. Chats in der Liste der Benachrichtigungsempfänger erhalten eine Nachricht vom Bot. Pro Vorfall gibt es nur eine solche Warnung. Sobald wieder aktuelle Meldungen eintreffen, folgt „Bot wieder online“ mit der Dauer der Unterbrechung. Frühere Vorfälle mit Dauer und Ursache bleiben in derselben Karte sichtbar.
Tarifbedingtes Einfrieren
Neben „ein-/ausgeschaltet“ gibt es für Bots den Status eingefroren. Nicht der Nutzer, sondern die Plattform friert Bots ein, wenn der aktuelle Tarif die Zahl verbundener Bots nicht mehr abdeckt. Dafür gibt es genau zwei Gründe:
- Bot-Limit überschritten: Sie wechseln zu einem Tarif, der weniger Bots erlaubt, als derzeit verbunden sind.
- Abonnement nicht verlängert: Der bezahlte Tarif läuft aus und es gilt wieder das Limit des kostenlosen Tarifs.
Ein eingefrorener Bot empfängt keine Nachrichten; der Empfang seiner Ereignisse wird abgeschaltet. Seine Daten, Reaktionen und Abonnenten bleiben vollständig erhalten. Das Einfrieren lässt sich rückgängig machen.
So tauen Sie Bots wieder auf: Bezahlen Sie einen Tarif, der die benötigte Bot-Zahl abdeckt. Bei Aktivierung des bezahlten Tarifs werden Bots automatisch wieder gestartet, beginnend mit den ältesten, bis das neue Limit erreicht ist. Sie können nicht auswählen, welcher Bot zuerst zurückkehrt. Wenn Sie andere Bots bevorzugen, entfernen Sie vorher überzählige Verbindungen und bezahlen Sie anschließend den Tarif.
Davon zu unterscheiden ist das Einfrieren des gesamten Kontos: Dann sind alle Bots und Rundsendungen pausiert und im Dashboard erscheint der Hinweis „Konto eingefroren“. Nur der Support kann diese Sperre aufheben. Siehe auch Zahlungen und Guthaben.
Profil und Synchronisierung
Mit Synchronisieren unter Einstellungen aktualisieren Sie den Bot-Namen aus Telegram, zum Beispiel nach einer Umbenennung in @BotFather. Das Profilbild des Bots wird automatisch übernommen.
Token wechseln
Wenn Sie den Token in @BotFather neu ausgestellt haben (Bot-Einstellungen → Revoke / New token), aktualisieren Sie ihn unter Einstellungen → Kanäle → Telegram 🔑. Der neue Token muss zum gleichen Bot gehören (gleiche interne Telegram-ID) — so bleiben alle Reaktionen, Abonnenten und Daten erhalten. Wenn der Telegram-Kanal nicht angezeigt wird, wählen Sie «Token ändern» im selben Fenster.
Bot an ein anderes Konto übertragen
Unter Einstellungen → Eigentümer wechseln senden Sie per E-Mail eine Einladung, das Projekt an ein anderes GetMyBot-Konto zu übertragen. Die Einladung gilt 72 Stunden. Bis zur Annahme bleibt das Projekt bei Ihnen, und Sie können die Übergabe abbrechen. Nach der Annahme wechselt der Eigentümer und Sie verlieren den Zugriff auf das Projekt. Nutzen Sie diese Funktion beispielsweise bei der Übergabe an einen Kunden oder Kollegen.
Bot-Vorlagen
Eine Vorlage speichert die Einstellungen und alle Reaktionen eines Bots als Momentaufnahme, die Sie bei einem anderen Bot anwenden können:
- Vorlage erstellen unter Einstellungen speichert den aktuellen Bot unter einem Namen als Vorlage.
- Vorlage anwenden ersetzt die Einstellungen des ausgewählten Bots durch die Vorlageneinstellungen. Die Reaktionen aus der Vorlage werden zu den vorhandenen hinzugefügt.
So können Sie denselben grundlegenden Bot in mehreren Projekten einsetzen.
Fertige Lösung aus dem Katalog installieren
Für fertige Lösungen aus dem Katalog gibt es einen Einrichtungsassistenten. Geben Sie die benötigten Parameter ein, prüfen Sie die Kompatibilität und erforderlichen Verbindungen und sehen Sie sich an, welche Ressourcen angelegt werden. Erledigen Sie nach der Installation die verbleibenden Schritte und testen Sie den Ablauf mit einer Probe-Anfrage.
Dieser Assistent unterscheidet sich vom Anwenden einer Bot-Momentaufnahme aus dem vorherigen Abschnitt. Die Prüfung vor der Installation zeigt fehlende Parameter oder Funktionen an. Ein abgehakter Schritt bestätigt noch nicht, dass ein externer Dienst tatsächlich funktioniert.
Ergebnisse der fertigen Lösung
Wählen Sie den Zeitraum, für den Sie die installierte Lösung auswerten möchten. Für einen Vergleich wählen Sie einen verfügbaren Modus und prüfen die Größe der Datengrundlage sowie die Diagnose. Zu wenige Daten oder ein fehlender Vergleich sind etwas anderes als ein Ergebnis von null.
Nächste Schritte
- Einstellungen, Team und Zugriff: Verhalten, Rollen, Vorlagen und API-Tokens.
- Reaktionen: Grundlagen: Verhalten des Bots einrichten.
- Import aus sambot: einen bestehenden Bot übernehmen.
- Zahlungen und Guthaben: Tarife und Bot-Limits.