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
- In Telegram den Chat mit @BotFather öffnen.
/newbotsenden und den Anweisungen folgen: einen Anzeigenamen vergeben, dann einen eindeutigen Nutzernamen, der aufbotenden muss (z. B.MeineFirma_Rechnungsbot).- @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.
- Chat mit @userinfobot öffnen und
/startsenden. - Der Bot antwortet u. a. mit deiner numerischen ID (z. B.
123456789); das ist nicht dein@nutzername, sondern eine reine Zahl. - 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
- In MaxRechnung Einstellungen öffnen, Reiter KI-Agent
(
/app/einstellungen/ki). Unter Kanäle ist Web-Chat im Konto fest angehakt. - 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).
- 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/kiin 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.
Weitere Anleitungen
KI-Agent buchen: Preis, Kontingent und was er darf
Den KI-Agenten zu jedem Tarif dazubuchen und wieder kündigen, das Monatskontingent im Blick behalten und wissen, was der Agent in deinem Konto darf. Dazu: Not-Aus und Kanäle.
3 Min.
Den Web-Chat des KI-Agenten nutzen
Fragen zu deinen Rechnungen stellen, Entwürfe aus Handnotizen, Fotos und Scans anlegen lassen und diktieren wie eine Sprachnachricht: der Web-Chat am Desktop und am Handy.
8 Min.
MaxRechnung an Stripe anbinden
Aus jeder bezahlten Stripe-Transaktion automatisch eine festgeschriebene MaxRechnung-Rechnung erzeugen, mit API-Key, Scopes, Idempotency und signierten Webhooks in beide Richtungen.
12 Min.