Инбокс-группа в Telegram: тема — это проект

Вместо лички бота вы пишете в свою Telegram-группу с темами. Каждая тема — проект: всё, что вы отправите в тему, попадает в инбокс сразу с адресом этого проекта. Переключать режим и ставить метки больше не нужно — адрес задаёт место, куда вы написали.

Кому и что нужно заранее

Инструкция для эксперта, у которого уже работает личный инбокс в Telegram: подключён свой бот для личного инбокса и привязан ваш Telegram-аккаунт. Если этого ещё нет — начните со статьи «Личный инбокс в Telegram».

Ещё нужны:

1. Группа с включёнными темами. Создайте группу в Telegram и включите темы: настройки группы → «Темы». Группа только ваша: сообщения других участников в ваш инбокс не попадают.
2. Ваш бот — администратор группы с правом «Управление темами». Добавьте бота в группу и назначьте администратором с этим правом. Администратор видит все сообщения группы, поэтому менять настройки приватности у BotFather не нужно.

Как открыть

Всё делается в самой группе, сайт не нужен. Отправьте в группу команду /bind.

Бот ответит: «Группа привязана как личный инбокс. В теме напишите «/to #маркер», чтобы привязать её к проекту; General работает как личка.»

Что делать

Привязать тему к проекту

1. Создайте тему или откройте уже созданную.
2. Отправьте в неё /to #маркер — маркер вашего проекта, например /to #545.
3. Бот ответит: «Тема привязана: всё отсюда → #545».

Узнать, к чему привязана тема: отправьте в неё /to без маркера.

Писать в тему

Отправляйте в тему текст, голосовые, фотографии, документы и ссылки — как боту в личку. Каждое сообщение попадает в инбокс с адресом проекта темы. Карточка приёма приходит в ту же тему.

Если в сообщении есть маркер (#другой-проект), он сильнее темы: материал уйдёт по маркеру.

Темы для проектов создаются сами

Когда ваш агент сверяет справочник проектов с платформой, для каждого подтверждённого проекта без темы бот сам заводит тему — с названием вида «Область · Проект». За один раз — не больше 20 новых тем, остальные появятся при следующей сверке. Если вы переименуете проект на платформе, тема, которую завёл бот, переименуется при ближайшей сверке; тему, привязанную вами через /to, бот не переименовывает.

Ответ агента — в ту же тему

Когда агент разбирает материал и отвечает по нему, ответ приходит в тему, откуда материал пришёл, а не в личку.

Отвязать группу

Отправьте /unbind. Бот ответит: «Группа отвязана. Принятое остаётся на месте; /bind — привязать снова.»

Если что-то не так

• «Нужна группа с включёнными темами» — включите темы в настройках группы и повторите /bind.
• «Сделайте бота администратором группы с правом «Управление темами»…» — назначьте боту это право и повторите /bind.
• Бот не отвечает на /bind — инбокс-группы на платформе пока не включены. Это решает администратор.
• Бот молчит в группе — проверьте, что личный инбокс работает в личке: без привязанного аккаунта бот не отвечает и в группе. Проверьте, что вы пишете тому же боту, который ведёт ваш личный инбокс.
• «Не понял адрес … — тема не привязана» — маркер написан с ошибкой или содержит недопустимые знаки. Используйте буквы, цифры и дефис.
• «У проекта #… уже есть тема «…» — привязка не изменена» — у проекта может быть только одна тема. Пишите в ту тему или сначала удалите её.
• Материал из темы пришёл без адреса — тема не привязана к проекту или проект удалён. Привяжите тему заново: /to #маркер.
• Тему удалили — материал, который уже пришёл из неё, остаётся с прежним адресом. Новые ответы агента по нему придут в «General» с пометкой «тема удалена».

Что важно знать

• «General» работает как личка. Сообщение туда получает адрес по маркеру или по включённому режиму /to; без них — лежит в инбоксе без адреса.
• В теме режим не действует. Даже если в личке включён режим /to #x, сообщение в теме без адреса остаётся без адреса — место сильнее режима.
• Группа личная. Сообщения других людей в группе в ваш инбокс не попадают; командная группа — отдельная возможность, её пока нет.
• Переименование темы в Telegram меняет только название темы: имя проекта на платформе остаётся прежним.
• Чего пока нет: привязки группы из настроек на сайте (только командой /bind), вложенных тем — в Telegram их нет, область видна в названии темы.