Режим сохранения — последний шаг привязки чата, и он определяет, когда сообщение в чате превращается в issue: автоматически или только по запросу.
Каждое сообщение (авто-режим)
Каждое сообщение в чате сразу становится issue. Если отправитель редактирует сообщение позже, issue обновляется вслед за ним — авто-режим синхронизирует issue с актуальным сообщением.
Это хороший выбор для личного или персонального чата — например, вашего чата "заметки для себя", привязанного к конкретному проекту, где любое сообщение должно стать карточкой.
Поскольку сохранение происходит тихо (подтверждается реакцией, а не ответным сообщением), используйте /info в ответ на сообщение (ниже), если захотите получить ссылку на карточку.
Только через /save (ручной режим)
Ничего не сохраняется автоматически. Сообщения отслеживаются, чтобы их можно было сохранить, но issue не создаётся, пока кто-то не сделает это явно.
Чтобы сохранить сообщение, ответьте на него командой /save, при желании добавив заметку:
/save follow up next sprint
Заметка становится верхней частью содержимого issue, а текст исходного сообщения идёт ниже, под разделителем ---, если присутствует и то, и другое.
Это правильный выбор для активного группового чата, где только часть сообщений должна стать карточками.
Ответ на любое сообщение из фото- или видео-альбома сохраняет весь альбом как один issue — содержимое и подпись берутся из первого сообщения альбома, а каждое вложение прикрепляется к issue.
Повторный /save на уже сохранённом сообщении запускает синхронизацию и возвращает ссылку на ту же карточку. В ручном режиме это корректный способ сделать обновление карточки на доске, если сообщение в чате обновилось.
/aisave — сохранение с заголовком и описанием, очищенными через AI
/aisave сохраняет сообщение так же, как /save, — ответом на него, при желании с заметкой, — но перед созданием issue пропускает содержимое через AI, вместо того чтобы сохранять его как есть. Результат — структурированная карточка из двух частей:
- Заголовок — короткое, сфокусированное резюме того, о чём сообщение, используется как заголовок issue
- Описание — остальной текст, переписанный заново: грамматика исправлена, повторы убраны, а сумбурный текст организован в понятные пункты списка
/aisave Fix using incorrect endpoint while choosing user in filter in organization history
Используйте команду для сумбурных, «поток сознания» сообщений — гневного сообщения в групповом чате, наполовину сформулированного баг-репорта, — там, где читаемая карточка полезнее, чем копия исходного текста.
Всё остальное работает так же, как у /save: альбомы обрабатываются точно так же, повторный запуск на уже сохранённом сообщении запускает пересинхронизацию карточки, и действует та же проверка права на создание issue.
/info — посмотреть без сохранения
/info работает одинаково в обоих режимах: ответьте на отслеживаемое сообщение, чтобы увидеть тот же превью карточки. Особенно полезно в авто-режиме, где сохранение происходит тихо, а вам понадобилась ссылка.
/info также работает только на чтение и независимо от режима сохранения чата — для неё не требуется, чтобы что-то вообще было сохранено ботом.
Распознавание ссылок на issue прямо в сообщении
Если сообщение, на которое вы отвечаете, содержит одну или несколько ссылок на issue в Boards, /info распознаёт их и обрабатывает каждую по отдельности, даже если это сообщение никогда не сохранялось ботом как карточка. Распознаются два формата ссылок, оба привязаны к URL вашей организации в Boards:
-
Страница issue:
https://boards.laraue.com/organizations/{orgKey}/issues/{KEY} -
Вид доски (открывает конкретный issue через query-параметр):
https://boards.laraue.com/organizations/{orgKey}/spaces/{spaceKey}/{boardId}?issue={KEY}
Похожая ссылка на другом домене никогда не распознаётся как наша. Для каждой распознанной ссылки /info проверяет, существует ли issue и есть ли у вас право на чтение:
-
Если issue существует и доступен вам для чтения, бот отвечает тем же превью карточки, что и
/saveи inline-поиск — ключ, проект, фрагмент содержимого и кнопка Open issue. - Если issue не существует или у вас нет права на чтение, бот в обоих случаях отправляет одно и то же общее уведомление о недоступности. Это сделано намеренно: по вставленной ссылке нельзя проверить, существует ли конкретный issue в организации, которую вы иначе не видите.
Если в сообщении нет распознаваемой ссылки на issue, /info возвращается к своему обычному поведению — проверке, является ли само сообщение отслеживаемой карточкой. Если нет, ответ теперь также показывает пример ожидаемого формата ссылки.
/delete — удалить сообщение и его issue
Ответьте на сообщение командой /delete, чтобы удалить его. Это сработает, только если верно оба условия: для сообщения действительно создан issue, и у вас есть право Delete на этот issue. Если хоть одно условие не выполнено, ничего не произойдёт.
Права доступа
При сохранении система проверяет, есть ли у вас право на создание issue в выбранном эпике-назначении. Привязка чата не даёт всем его участникам право создавать там карточки. О том, как выдать это право, см. Управление правами доступа.
Связанные страницы
- Привязка чата Telegram к Boards
- Сохранение сообщений Telegram — пересылка сообщений без привязки чата
- Управление правами доступа