Тема (ветка) в группе

Действие блок-схемы «Тема (ветка) в группе» создаёт, переименовывает, закрывает, открывает и удаляет темы в группе Telegram с включёнными темами (форум). Главный сценарий — поддержка в группе: на каждый вопрос участника бот заводит отдельную тему, и обсуждение идёт внутри неё, не смешиваясь с другими.

Действие находится в каталоге действий блок-схемы: вкладка «Интеграции», раздел «Телеграм».

Что нужно для работы

В настройках группы Telegram включены темы.
Бот — администратор группы с правом управлять темами.
Действие работает в той группе, где запущена блок-схема, — то есть блок-схему должно запустить событие из этой группы (сообщение, вступление участника и т.п.).
Telegram позволяет создавать темы и в личном чате с ботом, если у бота включён режим тем.

Поля

Поле	Зачем
«Что сделать»	«Создать тему», «Переименовать», «Закрыть» (писать в тему больше нельзя), «Открыть снова», «Удалить вместе с сообщениями».
«Название темы»	Для создания и переименования. До 128 символов, переменные работают: `Заявка {user:first_name}`.
«Цвет иконки»	Для создания: голубой, жёлтый, фиолетовый, зелёный, розовый или красный — других цветов Telegram не принимает. Позже цвет поменять нельзя.
«ID темы»	Для остальных операций — какую тему менять. По умолчанию `{var:effect.topic.id}` — тема, созданная этим действием раньше в той же блок-схеме. Тема, в которой написали сообщение: `{var:object.topic.id}`.

Пример: тема на каждый вопрос

Событие «Входящее сообщение в чате» в группе поддержки (с условием, что сообщение пришло в общую тему).
Действие «Тема (ветка) в группе»: «Создать тему», название Вопрос: {user:first_name}.
Действие «Отправить сообщение» с опцией «Отвечать внутри ветки форума» и «ID ветки форума» {var:effect.topic.id}: «Ваш вопрос перенесён сюда, менеджер ответит в этой теме».
Когда вопрос решён — действие «Тема (ветка) в группе» с «Закрыть».

Результат и ошибки

После создания темы:

{var:effect.topic.id} — ID новой темы (число);
{var:effect.topic.name} — её название (текст).

Ошибки (текст доступен в {var:error.message}):

Topic name is empty — пустое название при создании или переименовании.
Topic ID is empty — не указан ID темы для переименования, закрытия, открытия или удаления.
Chat ID is undefined — не удалось определить группу.
Ошибки с текстом от Telegram (начинаются с Bad Request) — например, в группе не включены темы, у бота нет права управлять темами, тема не найдена.

Что делать, если…

Симптом	Причина и что сделать
Ошибка `Bad Request: the chat is not a forum`	В группе не включены темы. Включите их в настройках группы Telegram.
Ошибка про права	Дайте боту права администратора с управлением темами.
Сообщение пришло не в тему, а в общий чат	В действии отправки не включена опция «Отвечать внутри ветки форума» или в «ID ветки форума» не та переменная — нужна `{var:effect.topic.id}`.
Нужно писать в тему из другой блок-схемы	`{var:effect.topic.id}` живёт только внутри одной блок-схемы. Сохраните ID темы в поле пользователя или сделки и подставляйте его оттуда.