Alle Anleitungen

KI-Agenten per Telegram erreichbar machen

Eigenen Telegram-Bot bei @BotFather anlegen und mit dem MaxRechnung-KI-Agenten verbinden. Bot-Token und erlaubte Telegram-Nutzer sind in wenigen Minuten hinterlegt.

6 Min. LesezeitStand 14. Oktober 2026

Voraussetzungen: Gebuchtes KI-Agent-Add-on, ein Telegram-Konto


Inhalt

Der KI-Agent (Add-on) läuft standardmäßig im Web-Chat unter /app/ki. Zusätzlich lässt er sich per Telegram erreichen, mit deinem eigenen Bot, den nur du und die Personen kontrollieren, die du ausdrücklich freigibst. Diese Anleitung zeigt die Einrichtung in drei Schritten: Bot anlegen, deine Telegram-User-ID herausfinden, beides in MaxRechnung hinterlegen.

Voraussetzungen

  • Gebuchtes KI-Agent-Add-on, zu jedem Tarif, siehe KI-Agent buchen.
  • Ein Telegram-Konto (App oder Web).

Schritt 1: Bot bei @BotFather anlegen

  1. In Telegram den Chat mit @BotFather öffnen.
  2. /newbot senden und den Anweisungen folgen: einen Anzeigenamen vergeben, dann einen eindeutigen Nutzernamen, der auf bot enden muss (z. B. MeineFirma_Rechnungsbot).
  3. @BotFather antwortet mit dem Bot-Token, einer Zeichenkette wie 123456789:ABCdefGhIjKlmNoPQRstuVwxYZ.... Kopieren und sicher aufbewahren; wer diesen Token kennt, kann den Bot steuern.

Schritt 2: Eigene Telegram-User-ID herausfinden

Der Bot antwortet aus Sicherheitsgründen nur Nutzern, die du explizit erlaubst; sonst könnte theoretisch jede Person, die den Bot-Nutzernamen errät, mit deinem Agenten chatten und über die angebundenen Werkzeuge auf deine Rechnungsdaten zugreifen.

  1. Chat mit @userinfobot öffnen und /start senden.
  2. Der Bot antwortet u. a. mit deiner numerischen ID (z. B. 123456789); das ist nicht dein @nutzername, sondern eine reine Zahl.
  3. Mehrere Personen sollen mit dem Bot chatten dürfen (z. B. du und dein Steuerbüro)? Für jede Person einzeln die ID ermitteln.

Schritt 3: In MaxRechnung hinterlegen

  1. In MaxRechnung Einstellungen öffnen, Reiter KI-Agent (/app/einstellungen/ki). Unter Kanäle ist Web-Chat im Konto fest angehakt.
  2. Häkchen bei Telegram setzen; darunter erscheinen zwei Felder:
    • Bot-Token: den Wert aus Schritt 1 einfügen.
    • Erlaubte Telegram-User-ID(s): die ID(s) aus Schritt 2, bei mehreren durch Komma getrennt (123456789, 987654321).
  3. Kanäle speichern klicken.

Die Einrichtung läuft im Hintergrund (üblicherweise wenige Sekunden bis niedrige Minuten). Sobald sie fertig ist, in Telegram den Chat mit deinem Bot öffnen (Link/Nutzername aus Schritt 1) und /start senden; der Agent antwortet mit denselben Werkzeugen (Rechnungen lesen und Entwürfe anlegen, im Umfang deines Tarifs) wie im Web-Chat.

Ohne Freigabe keine Antwort, mit Absicht

Ein Bot-Token ohne hinterlegte User-ID lässt sich nicht speichern; das Formular meldet dann „Telegram-User-ID ungültig …“. Der Agent würde sonst jede eingehende Nachricht aus Sicherheitsgründen ohnehin stillschweigend ignorieren (Default-Deny). Bekommst du nach dem Speichern keine Antwort:

  • Prüfe, ob die hinterlegte ID wirklich deine numerische User-ID ist (nicht der @nutzername).
  • Prüfe, ob du den Chat mit dem richtigen Bot geöffnet hast (Nutzername aus Schritt 1).
  • Token neu von @BotFather anfragen (/mybots → Bot auswählen → API Token → Revoke current token) und erneut hinterlegen, falls der ursprüngliche Token nicht mehr passt.

Fotos und Dokumente schicken

Ein Foto, zum Beispiel von einer Handnotiz, schickst du dem Bot wie jedem anderen Kontakt und schreibst dazu, was passieren soll. Ein PDF mit Textebene liest der Agent ebenfalls. Enthält das PDF gescannte Seiten ohne Textebene, liest er es über Telegram nicht; schick die Seiten dann als Foto oder lade das PDF im Web-Chat hoch, dort läuft eine Texterkennung.

Bot-Token ändern oder Kanal wieder abschalten

  • Token austauschen: neuen Token bei @BotFather erzeugen, in /app/einstellungen/ki in das Bot-Token-Feld eintragen und speichern; der alte Token verliert damit seine Wirkung.
  • Nur die Erlaubnisliste ändern: das Bot-Token-Feld leer lassen (der bestehende, bereits gespeicherte Token bleibt erhalten) und nur die User-ID(s) anpassen.
  • Telegram abschalten: Häkchen bei Telegram entfernen und speichern. Der Not-Aus weiter unten auf derselben Seite (Agent sofort deaktivieren) legt stattdessen sofort alle Kanäle still, inklusive Web-Chat.

Zu beachten

  • Nachrichten über Telegram laufen über deinen eigenen Bot, aber der Agent selbst läuft auf der von MaxRechnung betriebenen Infrastruktur, anders als der First-Party-Web-Chat ist Telegram damit ein zusätzlicher, externer Übertragungsweg für deine Rechnungsdaten.
  • Den Kanal wählst du selbst und richtest ihn in eigener Verantwortung ein. Telegram ist kein Unterauftragsverarbeiter von MaxRechnung. Für die Übermittlung über diesen Kanal und die Bedingungen von Telegram bist du verantwortlich (AVV § 11 Abs. 5).
  • Wie im Web-Chat gilt: Der Agent legt Rechnungen nur als Entwurf an und schreibt sie nicht fest, nutzt ausschließlich die von MaxRechnung freigegebenen Werkzeuge und ist jederzeit über den Not-Aus stillzulegen.