Telegram-Integration — Einrichtung und Nutzung

Ein Bot pro Projekt. Jeder AI-Worker bekommt sein eigenes Topic in einer Telegram-Supergroup — Nachrichten werden automatisch an den richtigen Worker geroutet und die Antwort kommt im selben Topic zurück.

So sieht es in der Praxis aus

Supergroup "My Project"
├── 📌 General          ← allgemeiner Chat (ohne Zuordnung)
├── 🔵 Developer        ← Nachrichten → Developer Worker
└── 🟢 Consultant       ← Nachrichten → Consultant Worker

Du schreibst in das Topic Developer → Arc OS verarbeitet die Nachricht über Claude → die Antwort erscheint im selben Topic.

Telegram und das CRM Dashboard sind zwei Kanäle zum selben Worker. Du kannst einen Dialog in Telegram beginnen und im CRM fortführen — der Kontext bleibt erhalten.

Einrichtung

Schritt 1 — Bot im BotFather erstellen

1. Öffne @BotFather in Telegram
2. Sende /newbot
3. Gib den Namen des Bots ein (z. B. My Project)
4. Gib einen Username ein — er muss auf bot enden (z. B. my_project_arc_bot)
5. BotFather gibt einen Token im Format 123456789:AABBccDDee... zurück

⚠️ Bewahre den Token auf — du brauchst ihn bei der Einrichtung im CRM.

Schritt 2 — Supergroup mit Topics erstellen

2.1 Gruppe erstellen

Telegram Desktop / Mobile:

1. Klicke auf das Stift-Symbol → New Group
2. Füge ein beliebiges Mitglied hinzu (kann später entfernt werden)
3. Gib der Gruppe einen Namen → Create

2.2 Topics aktivieren

1. Öffne die Gruppeneinstellungen (oben auf den Namen klicken)
2. Edit → suche den Abschnitt Topics
3. Aktiviere den Schalter — Telegram konvertiert die Gruppe automatisch in eine Supergroup

2.3 Supergroup-ID herausfinden

Die Supergroup-ID beginnt immer mit -100.

Variante A — über @userinfobot:

1. Leite eine beliebige Nachricht aus der Gruppe an den Bot @userinfobot weiter
2. Der Bot gibt die ID im Format -1001234567890 zurück

Variante B — über Telegram Web:

1. Öffne die Gruppe auf web.telegram.org
2. In der Adresszeile steht eine URL der Form #-1001234567890
3. Kopiere die Zahl samt Minuszeichen

Schritt 3 — Bot als Administrator hinzufügen

1. Öffne die Gruppeneinstellungen → Administrators
2. Add Admin → gib in der Suche @username_deines_bots ein (vollständiger Username mit @)
3. Wähle den Bot aus der Liste → OK
4. Die Standardrechte reichen aus — lass alles wie es ist

⚠️ Der Bot erscheint nicht in der Suche, wenn du einen unvollständigen Username oder einen ohne @ eingibst. Gib den exakten @username ein.

Schritt 4 — Topics für Worker erstellen

Klicke in der Gruppe auf + → New Topic:

• Benenne die Topics nach Workern: Developer, Consultant oder eigene Namen
• Du kannst Farben/Icons zur besseren Übersicht wählen

Schritt 5 — Im CRM verbinden

1. Öffne arc-os.co → wähle das Projekt → Project Settings
2. Suche den Abschnitt Channels → klicke auf Connect Telegram

5.1 Bot-Daten eingeben

Klicke auf Verify & get topics.

5.2 Verifizierung

Das CRM prüft:

• ✅ Token ist gültig
• ✅ Bot ist Administrator der Gruppe
• ✅ Topic-Liste wurde geladen

5.3 Topics an Worker binden

Wähle für jedes Topic einen Worker aus dem Dropdown:

Developer  →  [developer     ▾]
Consultant →  [consultant    ▾]
General    →  [(nicht zugeordnet)]

Klicke auf Save bindings.

Schritt 6 — Test

1. Schreibe eine beliebige Nachricht in das Topic Developer
2. Der Bot antwortet im selben Topic vom Developer Worker
3. Wiederhole das für Consultant

Tägliche Nutzung

Arbeiten über Topics (empfohlen)

Schreibe den Aufgabentext einfach in das passende Topic — keine Präfixe nötig:

[Developer Topic]
Behebe den Bug im Login-Formular — das E-Mail-Feld wird nicht validiert

[Consultant Topic]
Analysiere die Architektur des Auth-Moduls — was lässt sich verbessern?

Wenn ein Topic keinem Worker zugeordnet ist, antwortet der Standard-Worker.

Befehle im Privatchat mit dem Bot

Im Privatchat mit dem Bot ist das manuelle Umschalten der Worker über Präfixe verfügbar:

Beispiele:

/c Analysiere die Architektur des Auth-Moduls
/d Behebe den Bug im Login-Formular
/w:sentinel Führe ein Security-Audit der letzten Änderungen durch

Nachrichten ohne Präfix gehen an den aktuell aktiven Worker — nach /d Behebe den Bug gehen auch die folgenden Nachrichten ohne Präfix an den Developer.

Inline-Schaltflächen unter der Antwort

Nach jeder Antwort eines AI-Workers erscheinen Steuerungs-Schaltflächen:

Prozesssteuerung:

Kontext und Feedback:

Navigation:

Kontext und Gedächtnis

• Jeder Worker hat ein eigenes Gedächtnis (bis zu 50 Nachrichten)
• Reply auf eine Nachricht → ihr Text wird als Kontext an die Anfrage angehängt
• Context Router wählt automatisch die Top-5-Skills aus, die für deine Nachricht relevant sind
• 👎-Feedback → das System merkt sich den Fehler und berücksichtigt ihn bei künftigen Anfragen

Steuerbefehle des Bots

Verbindung zum CRM Dashboard

Telegram Topic  ──┐
                  ├──► Child Bot ──► Claude ──► Antwort
CRM Dashboard   ──┘                              │
                                                 ▼
                                        Telegram + CRM (gleichzeitig)

• Nachrichten aus dem CRM werden alle 500ms verarbeitet
• Antworten erscheinen gleichzeitig in Telegram und im CRM
• Anhänge (Bilder, PDFs) werden über das CRM Dashboard unterstützt
• Du kannst einen Dialog in Telegram beginnen und im CRM fortführen — der Kontext bleibt erhalten

Bot trennen

CRM → Project Settings → Channels → Disconnect.

Das löscht den Token und alle Topic-Zuordnungen. Der Bot bleibt in der Gruppe — entferne ihn bei Bedarf manuell aus den Administratoren.

Problembehebung