Intégration Telegram — configuration et utilisation

Un bot par projet. Chaque worker AI obtient son propre topic dans un Supergroup Telegram — les messages sont automatiquement routés vers le bon worker et la réponse revient dans le même topic.

À quoi ça ressemble en pratique

Supergroup "My Project"
├── 📌 General          ← chat général (sans liaison)
├── 🔵 Developer        ← messages → worker Developer
└── 🟢 Consultant       ← messages → worker Consultant

Tu écris dans le topic Developer → Arc OS traite via Claude → la réponse apparaît dans le même topic.

Telegram et le CRM Dashboard sont deux canaux vers le même worker. Tu peux commencer une conversation dans Telegram et la poursuivre dans le CRM — le contexte est conservé.

Configuration

Étape 1 — Créer un bot dans BotFather

1. Ouvre @BotFather dans Telegram
2. Envoie /newbot
3. Saisis le nom du bot (par exemple : My Project)
4. Saisis le username — il doit se terminer par bot (par exemple : my_project_arc_bot)
5. BotFather renvoie un token au format 123456789:AABBccDDee...

⚠️ Garde le token — il sera nécessaire lors de la configuration dans le CRM.

Étape 2 — Créer un Supergroup avec Topics

2.1 Créer le groupe

Telegram Desktop / Mobile :

1. Clique sur l'icône crayon → New Group
2. Ajoute n'importe quel participant (tu pourras le retirer ensuite)
3. Donne un nom au groupe → Create

2.2 Activer les Topics

1. Ouvre les paramètres du groupe (clique sur le nom en haut)
2. Edit → trouve la section Topics
3. Active l'interrupteur — Telegram convertit automatiquement le groupe en Supergroup

2.3 Récupérer le Supergroup ID

Le Supergroup ID commence toujours par -100.

Option A — via @userinfobot :

1. Transfère n'importe quel message du groupe au bot @userinfobot
2. Le bot renvoie l'ID au format -1001234567890

Option B — via Telegram Web :

1. Ouvre le groupe sur web.telegram.org
2. La barre d'adresse affiche une URL du type #-1001234567890
3. Copie le nombre avec le signe moins

Étape 3 — Ajouter le bot comme administrateur

1. Ouvre les paramètres du groupe → Administrators
2. Add Admin → dans la recherche, saisis @username_de_ton_bot (username complet avec @)
3. Sélectionne le bot dans la liste → OK
4. Les droits par défaut conviennent — laisse tel quel

⚠️ Le bot n'apparaîtra pas dans la recherche si tu saisis un username incomplet ou sans @. Saisis le @username exact.

Étape 4 — Créer les topics pour les workers

Dans le groupe, clique sur + → New Topic :

• Nomme les topics d'après les workers : Developer, Consultant, ou des noms personnalisés
• Tu peux choisir des couleurs/icônes pour plus de lisibilité

Étape 5 — Connecter dans le CRM

1. Ouvre arc-os.co → choisis le projet → Project Settings
2. Trouve la section Channels → clique sur Connect Telegram

5.1 Saisir les données du bot

Clique sur Verify & get topics.

5.2 Vérification

Le CRM vérifie :

• ✅ Le token est valide
• ✅ Le bot est administrateur du groupe
• ✅ La liste des topics est chargée

5.3 Lier les topics aux workers

Pour chaque topic, choisis un worker dans le menu déroulant :

Developer  →  [developer     ▾]
Consultant →  [consultant    ▾]
General    →  [(non lié)]

Clique sur Save bindings.

Étape 6 — Test

1. Écris n'importe quel message dans le topic Developer
2. Le bot répond dans le même topic au nom du worker Developer
3. Répète pour Consultant

Utilisation quotidienne

Travailler via les topics (recommandé)

Écris simplement le texte de la tâche dans le bon topic — aucun préfixe nécessaire :

[Topic Developer]
Corrige le bug du formulaire de connexion — le champ email n'est pas validé

[Topic Consultant]
Analyse l'architecture du module auth, qu'est-ce qu'on peut améliorer ?

Si un topic n'est lié à aucun worker — c'est le worker par défaut qui répond.

Commandes en chat privé avec le bot

En chat privé avec le bot, le basculement manuel entre workers est disponible via des préfixes :

Exemples :

/c Analyse l'architecture du module auth
/d Corrige le bug du formulaire de login
/w:sentinel Fais un audit de sécurité des derniers changements

Un message sans préfixe va au worker actif courant — après /d Corrige le bug, les messages suivants sans préfixe iront aussi au Developer.

Boutons inline sous la réponse

Après chaque réponse d'un worker AI, des boutons de contrôle apparaissent :

Contrôle du processus :

Contexte et feedback :

Navigation :

Contexte et mémoire

• Chaque worker a une mémoire séparée (jusqu'à 50 messages)
• Reply sur un message → son texte est ajouté comme contexte à la requête
• Le Context Router sélectionne automatiquement le top-5 des skills pertinents pour ton message
• Feedback 👎 → le système mémorise l'erreur et en tient compte dans les requêtes suivantes

Commandes de gestion du bot

Lien avec le CRM Dashboard

Topic Telegram  ──┐
                  ├──► Child Bot ──► Claude ──► Réponse
CRM Dashboard   ──┘                              │
                                                 ▼
                                        Telegram + CRM (simultanément)

• Les messages du CRM sont traités toutes les 500 ms
• Les réponses apparaissent à la fois dans Telegram et dans le CRM
• Les pièces jointes (images, PDF) sont prises en charge via le CRM Dashboard
• Tu peux commencer une conversation dans Telegram et la poursuivre dans le CRM — le contexte est conservé

Déconnecter le bot

CRM → Project Settings → Channels → Disconnect.

Cela supprime le token et toutes les liaisons de topics. Le bot reste dans le groupe — retire-le manuellement des administrateurs si nécessaire.

Dépannage