Настройка Telegram

Используйте это руководство, чтобы подключить Clark к Telegram и проверить, что бот видит нужные чаты.

Личный чат

1. Откройте Telegram и найдите @xdocai_bot.
2. Нажмите Start или отправьте /start.
3. Отправьте /help, чтобы увидеть доступные команды.
4. Задайте простой вопрос, например: Clark, чем ты можешь помочь?

В личном чате Clark отвечает на обычные сообщения, потому что разговор идёт напрямую с ботом.

Групповой чат

1. Откройте вашу группу Telegram.
2. Добавьте @xdocai_bot как участника.
3. Дайте боту разрешение читать сообщения.
4. Привяжите группу к workspace:

/link ваш-tenant-id

Команду можно отправлять обычным сообщением в группе. Упоминать Clark или тегать бота не нужно. Если Telegram показывает команду как /link@xdocai_bot ваш-tenant-id, это тоже работает.

Если группа раньше была привязана к другому workspace, Clark перенесёт чат на новый Tenant ID и покажет подтверждение.

5. Отправьте сообщение с упоминанием Clark, например: Clark, сделай сводку сегодняшнего обсуждения.

В групповых чатах Clark тихо сохраняет контекст и отвечает только при упоминании, теге или ответе на сообщение бота. Это не мешает обычному командному разговору.

Частые команды

Команда	Результат
/help	Показать доступные команды.
/link <tenant_id>	Привязать или перепривязать Telegram-чат к workspace.
/link_admin <tenant_id>	Сделать этот Telegram-чат единственным Admin / Master Chat.
/docs	Показать историю обработанных документов.
/templates	Показать загруженные шаблоны документов.
/memory	Показать сохранённые сущности и факты.
/task Prepare report @anna by 15.04 !high	Создать задачу.
/tasks	Показать задачи текущего чата.
/sum	Создать сводку текущего чата.
/sum all	Создать сводку по подключённым чатам из master chat.

Автоматические сводки

Администраторы могут включить автоматические сводки в настройках чата в панели. Clark делает ежедневный /sum с понедельника по четверг в локальное время конца дня, но только если за последние 24 часа в чате были сообщения. Каждый понедельник в 10:00 по часовому поясу CEO/администратора Clark делает /sum_week за прошлую неделю. Сводки отправляются в Telegram или, если включено, приватно CEO/администратору, и сохраняются в Memory для будущего контекста.

Документы в Telegram

Можно отправлять PDF, DOCX, XLSX, CSV, TXT и изображения. Добавьте подпись, если нужно конкретное действие:

Clark, найди сумму договора в этом файле

template Sales proposal

Clark обработает файл и покажет его в разделах Documents или Templates в панели управления.

Master chat

Master chat — это административный чат для сводок по нескольким чатам и обзора задач. Это может быть личный чат с ботом или отдельная admin-группа. Назначается командой /link_admin <tenant_id>. На workspace может быть только один master chat; при назначении нового Clark снимает master-доступ со старого. Используйте его для:

• /link_admin <tenant_id>
• /sum all
• /tasks all
• еженедельных обзоров
• вопросов о том, что изменилось в подключённых командных чатах

Этот сценарий должны использовать только подтверждённые администраторы workspace. Команды с all принимаются только из Admin / Master Chat.

Решение проблем

Проблема	Что проверить
Бот не отвечает в группе	Упомяните Clark, отметьте бота или ответьте на сообщение бота.
Бот не видит сообщения	Проверьте разрешения группы Telegram и privacy settings.
Документы не появляются	Дождитесь обработки и обновите раздел Documents в панели.
Команды игнорируются	Убедитесь, что команда отправлена в подключённом чате и workspace активен.
/link уходит в AI-ответ	Отправьте /link <tenant_id> ещё раз после добавления Clark в группу; упоминание Clark не требуется.