AiHummer
Deutsch▾
AnmeldenKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanäle/Telegram

Telegram

v1.0.x · aktualisiert 2026-06-26

Telegram ist AiHummer’s Produktionsreife, empfohlener erster Kanal. Es ist der schnellste Weg, einen funktionierenden Agenten vor echten Menschen zu bekommen: Erstellen Sie einen Bot mit @BotFather, geben Sie dem Connector das Token, und eingehende Nachrichten beginnen, zum Gateway zu fließen.

Der Telegram-Connector wird aus dem Produkt heraus installiert Marktplatz und in der Admin-Benutzeroberfläche konfiguriert. Es läuft host-nativ und kommuniziert über die eingehende API mit dem Gateway, sodass es unabhängig von der Turn-Engine skaliert und neu startet.

Telegram in 6 Schritten verbinden

Hier ist der End-to-End-Pfad von null zu einem Bot, der dir auf Telegram antwortet. Alles, was du brauchst, ist ein Telegram-Konto und Zugriff auf deine AiHummer Web-Admin-Oberfläche.

  1. Erstelle einen Bot mit BotFather. In Telegram öffnen @BotFather, senden /newbot, und den Namen des Bots festlegen und Benutzername. Was Sie sehen werden: BotFather gibt ein Token mögen 123456789:AA… — Dies ist der Zugriffsschlüssel des Bots, kopiere ihn.
  2. Installieren Sie den Telegram-Connector. In der Admin-Oberfläche öffnen Plugins/Marktplatz, finden Sie den Telegram-Anschluss in den Katalog und klicken Sie auf “Installieren”. Warten Sie, bis die Karte auf “online” wechselt (ein Installieren Fortschrittsbalken wird angezeigt).
  3. Fügen Sie das Token ein. Gehe zu dem Kanäle Bildschirm → der Installierte Kanäle konfigurieren blockieren, die Telegram-Karte öffnen und einfügen Bot-Token in das Feld vom Anschlussformular. Speichern.
  4. Erstelle einen Agenten (falls Sie noch keines haben) — siehe Agenten: ein Name und ein System-Prompt reichen aus.
  5. Binden Sie den Agenten an den Kanal. Auf dem Kanäle Bildschirm, im Bindungen Block, wähle einen Standardagent für Telegram — der Regel „Neue Telegram-Konversationen werden von Agent Y geführt“. Die Auswahl wird sofort gespeichert.
  6. Schicke dem Bot eine Nachricht. Öffne deinen Bot in Telegram und sende ihm eine Nachricht. *Was Sie werden sehen: * der Agent antwortet im Chat, und das passende Gespräch erscheint auf dem Bildschirm „Sitzungen“ in der Admin-Benutzeroberfläche.

[!NOTE] Standardmäßig antwortet der Agent nur bekannte Benutzer (Personen registriert in AiHummer). Wenn der Bot auf Ihre Nachricht schweigt — fügen Sie entweder sich selbst als hinzu Instanzbenutzer oder schalten Sie “Nur bekannten Benutzern antworten” aus auf dem Kanäle Bildschirm.

Warum mit Telegram anfangen

Telegram hat die geringste Reibung aller AiHummer-Kanäle: kein Betreiber, kein OAuth-Zustimmungsbildschirm, keine App-Überprüfung. Ein Bot-Token reicht aus, um Nachrichten zu senden und zu empfangen, und derselbe Connector deckt sowohl interne Mitarbeiter-Chats als auch kundenorientierte Bots ab. Da es produktionsreif und umfassend getestet ist, ist es der Kanal, den wir empfehlen, zuerst bei der Evaluierung von AiHummer zu integrieren.

Abfrage oder Webhook

Der Connector unterstützt beide Aufnahmeverfahren, sodass er funktioniert, unabhängig davon, ob Ihr Gateway aus dem öffentlichen Internet erreichbar ist oder nicht.

  • Langes Abfragen — Der Connector zieht Updates von Telegram. Kein eingehender Port oder TLS erforderlich ist, was es ideal für die lokale Entwicklung und private Nutzung macht Netzwerke.
  • Webhook — Telegram sendet Updates an eine öffentliche HTTPS-URL. Geringere Latenz und besser geeignet für den Einsatz hinter einem Reverse-Proxy, der TLS beendet.

Der Anschluss hört auf Port 8800 in einer normalen Bereitstellung, oder 8091 für einen lokalen Lauf. Jede eingehende Nachricht wird an die im Gateway konfigurierte URL gesendet AIHUMMER_INBOUND_URL, authentifiziert mit dem gemeinsamen eingehenden Geheimnis.

Reiche Nachrichten, Nachrichtenreaktionen und Umfragen

Über reinen Text hinaus stellt der Telegram-Kanal dar Reiche Nachrichten — formatierte Antworten, die die strukturierte Ausgabe eines Agenten auf die nativen Nachrichtenfunktionen von Telegram abbilden. Es unterstützt außerdem Nachrichtenreaktionen und Umfragen, sodass ein Agent auf die Nachricht eines Benutzers reagieren oder eine kurze Umfrage als Teil eines Durchlaufs in einen Chat einfügen kann.

[!TIP] Telegram ist der Kanal, der AiHummer als identifiziert wurde telegram. Benutze diesen Kanal ID, wenn Sie einen Agenten binden oder Gespräche nach Quelle filtern.

Bot-zu-Bot mit einer Schleifenschutz

Agenten können mit anderen Bots sprechen. Um das sicher zu machen, liefert der Connector einen Schleifenwächter: Es erkennt und unterbricht außer Kontrolle geratene Bot-zu-Bot-Austausche, bevor sie zu einem unendlichen Ping-Pong werden. So können Sie Multi-Bot-Workflows erstellen, ohne den klassischen Fehler durch Rückkopplungsschleifen zu riskieren.

Geheime Vermittlung über OIDC

Das Bot-Token und andere Connector-Geheimnisse werden niemals in den Dienst fest codiert. Stattdessen ruft der Connector sie zur Laufzeit von einem Geheimdienst über OIDC — es authentifiziert, dann ruft es die benötigten Anmeldedaten ab. Geheimnisse bleiben im verschlüsselten Tresor und außerhalb von Konfigurationsdateien und Prozessargumenten.

[!NOTE] Eingehende Nachrichten werden gepostet an AIHUMMER_INBOUND_URL und gesichert durch die gemeinsames HMAC-Eingangsgeheimnis (AIHUMMER_INBOUND_SECRET). Das Gateway muss ein Standard-Arbeitsbereich konfiguriert, um sie zu versenden.

Wenn es nicht funktioniert hätte

  • Der Telegram-Connector befindet sich nicht auf dem Bildschirm “Kanäle” — installiere es zuerst auf der Plugins/Marktplatz Bildschirm; bis installiert der Kanal wird nicht angezeigt. Im Community-Plan ist nur Telegram verfügbar; der Rest benötigt ein Upgrade (HTTP 402).
  • Der Bot antwortet nicht — prüfen: (1) der Token ist korrekt eingefügt und der Die Telegram-Karte ist „online“; (2) der Kanal ist in „Bindings“ an einen Agenten gebunden; (3) Der Absender ist im System registriert (standardmäßig antwortet der Agent nur bekannte Benutzer).
  • Antworten sehen wie Vorlagen aus — das Modell zum Testen ist wahrscheinlich noch aktiv; verbinden Sie ein Anbieter auf der Modelle Seite.
  • “Unautorisiert” / Token abgelehnt — das Token ist falsch oder widerrufen; erstelle ein neuer mit @BotFather (/token) und füge es wieder ein.
  • Der Webhook kommt nicht an — im Webhook-Modus muss das Gateway erreichbar sein unter eine öffentliche HTTPS-URL; in einem privaten Netzwerk verwenden Sie Long Polling, das keine eingehenden Verbindungen benötigt Port oder TLS.

Wohin als Nächstes