Інтеграція з Telegram — налаштування та використання

Один бот на проєкт. Кожен AI-воркер отримує власну тему в Telegram-супергрупі — повідомлення автоматично маршрутизуються до потрібного воркера, і відповідь повертається в ту саму тему.

Як це виглядає в дії

Supergroup "My Project"
├── 📌 General          ← загальний чат (не прив'язаний)
├── 🔵 Developer        ← повідомлення → воркер Developer
└── 🟢 Consultant       ← повідомлення → воркер Consultant

Ти пишеш у темі Developer → Arc OS обробляє це через Claude → відповідь з'являється в тій самій темі.

Telegram і CRM-дашборд — це два канали до того самого воркера. Можна почати розмову в Telegram і продовжити в CRM — контекст зберігається.

Налаштування

Крок 1 — створи бота у BotFather

1. Відкрий @BotFather у Telegram
2. Надішли /newbot
3. Введи назву бота (наприклад: My Project)
4. Введи username — він має закінчуватися на bot (наприклад: my_project_arc_bot)
5. BotFather поверне токен у форматі 123456789:AABBccDDee...

⚠️ Збережи токен — він знадобиться під час налаштування CRM.

Крок 2 — створи супергрупу з темами

2.1 Створи групу

Telegram Desktop / Mobile:

1. Натисни іконку олівця → New Group
2. Додай будь-якого учасника (його можна прибрати пізніше)
3. Дай групі назву → Create

2.2 Увімкни теми (Topics)

1. Відкрий налаштування групи (натисни на назву вгорі)
2. Edit → знайди розділ Topics
3. Увімкни перемикач — Telegram автоматично перетворює групу на супергрупу

2.3 Знайди ID супергрупи

ID супергрупи завжди починається з -100.

Варіант A — через @userinfobot:

1. Переслати будь-яке повідомлення з групи до @userinfobot
2. Бот поверне ID у форматі -1001234567890

Варіант B — через Telegram Web:

1. Відкрий групу на web.telegram.org
2. В адресному рядку буде URL на кшталт #-1001234567890
3. Скопіюй число разом зі знаком мінус

Крок 3 — додай бота як адміністратора

1. Відкрий налаштування групи → Administrators
2. Add Admin → у полі пошуку введи @your_bot_username (повний username із @)
3. Обери бота зі списку → OK
4. Стандартні права підходять — залиш їх як є

⚠️ Бот не з'явиться в пошуку, якщо ввести частковий username або пропустити @. Введи точний @username.

Крок 4 — створи теми для воркерів

У групі натисни + → New Topic:

• Називай теми за іменами воркерів: Developer, Consultant або власні назви
• Для зручності можна обрати кольори/іконки

Крок 5 — підключи в CRM

1. Відкрий arc-os.co → обери проєкт → Project Settings
2. Знайди розділ Channels → натисни Connect Telegram

5.1 Введи дані бота

Натисни Verify & get topics.

5.2 Верифікація

CRM перевіряє:

• ✅ Токен дійсний
• ✅ Бот є адміністратором групи
• ✅ Список тем завантажено

5.3 Прив'яжи теми до воркерів

Для кожної теми обери воркера з випадаючого списку:

Developer  →  [developer     ▾]
Consultant →  [consultant    ▾]
General    →  [(not bound)]

Натисни Save bindings.

Крок 6 — тест

1. Напиши будь-яке повідомлення в темі Developer
2. Бот відповідає в тій самій темі від імені воркера Developer
3. Повтори для Consultant

Щоденне використання

Робота через теми (рекомендовано)

Просто пиши текст задачі в потрібній темі — жодних префіксів не треба:

[Developer topic]
Виправ баг у формі логіну — поле email не валідується

[Consultant topic]
Проаналізуй архітектуру модуля auth — що можна покращити?

Якщо тема не прив'язана до воркера, відповідає стандартний воркер.

Команди в приватному чаті з ботом

У приватному чаті з ботом можна перемикати воркерів вручну через префікси:

Приклади:

/c Проаналізуй архітектуру модуля auth
/d Виправ баг у формі логіну
/w:sentinel Проведи аудит безпеки останніх змін

Повідомлення без префікса йде до поточного активного воркера — після /d Виправ баг наступні повідомлення без префікса теж ідуть до Developer.

Inline-кнопки під відповіддю

Кнопки керування з'являються після кожної відповіді AI-воркера:

Керування процесом:

Контекст і фідбек:

Навігація:

Контекст і пам'ять

• Кожен воркер має власну пам'ять (до 50 повідомлень)
• Reply на повідомлення → його текст додається як контекст до запиту
• Context Router автоматично обирає топ-5 скілів, релевантних твоєму повідомленню
• 👎 фідбек → система запам'ятовує помилку й враховує її в майбутніх запитах

Команди керування ботом

Зв'язок із CRM-дашбордом

Telegram topic  ──┐
                  ├──► Child Bot ──► Claude ──► Reply
CRM Dashboard   ──┘                              │
                                                 ▼
                                        Telegram + CRM (simultaneously)

• Повідомлення з CRM обробляються кожні 500мс
• Відповіді з'являються одночасно і в Telegram, і в CRM
• Вкладення (зображення, PDF) підтримуються через CRM-дашборд
• Можна почати розмову в Telegram і продовжити в CRM — контекст зберігається

Відключення бота

CRM → Project Settings → Channels → Disconnect.

Це прибирає токен і всі прив'язки тем. Бот залишається в групі — за потреби прибери його з адміністраторів вручну.

Усунення проблем