Назад к blog
documentation

Авто- и ручной режим сохранения для привязанных чатов

Режим сохранения — последний шаг привязки чата, и он определяет, когда сообщение в чате превращается в issue: автоматически или только по запросу.

Каждое сообщение (авто-режим)

Каждое сообщение в чате сразу становится issue. Если отправитель редактирует сообщение позже, issue обновляется вслед за ним — авто-режим синхронизирует issue с актуальным сообщением.

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

Поскольку сохранение происходит тихо (подтверждается реакцией, а не ответным сообщением), используйте /info в ответ на сообщение (ниже), если захотите получить ссылку на карточку.

Только через /save (ручной режим)

Ничего не сохраняется автоматически. Сообщения отслеживаются, чтобы их можно было сохранить, но issue не создаётся, пока кто-то не сделает это явно.

Чтобы сохранить сообщение, ответьте на него командой /save, при желании добавив заметку:

/save follow up next sprint

Заметка становится верхней частью содержимого issue, а текст исходного сообщения идёт ниже, под разделителем ---, если присутствует и то, и другое.

Ответ на сообщение командой /save с заметкой в групповом чате

Это правильный выбор для активного группового чата, где только часть сообщений должна стать карточками.

Ответ на любое сообщение из фото- или видео-альбома сохраняет весь альбом как один issue — содержимое и подпись берутся из первого сообщения альбома, а каждое вложение прикрепляется к issue.

Повторный /save на уже сохранённом сообщении запускает синхронизацию и возвращает ссылку на ту же карточку. В ручном режиме это корректный способ сделать обновление карточки на доске, если сообщение в чате обновилось.

/aisave — сохранение с заголовком и описанием, очищенными через AI

/aisave сохраняет сообщение так же, как /save, — ответом на него, при желании с заметкой, — но перед созданием issue пропускает содержимое через AI, вместо того чтобы сохранять его как есть. Результат — структурированная карточка из двух частей:

  • Заголовок — короткое, сфокусированное резюме того, о чём сообщение, используется как заголовок issue
  • Описание — остальной текст, переписанный заново: грамматика исправлена, повторы убраны, а сумбурный текст организован в понятные пункты списка
/aisave Fix using incorrect endpoint while choosing user in filter in organization history

Issue, созданный через /aisave, с заголовком от AI и описанием в виде списка ниже

Используйте команду для сумбурных, «поток сознания» сообщений — гневного сообщения в групповом чате, наполовину сформулированного баг-репорта, — там, где читаемая карточка полезнее, чем копия исходного текста.

Всё остальное работает так же, как у /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 в выбранном эпике-назначении. Привязка чата не даёт всем его участникам право создавать там карточки. О том, как выдать это право, см. Управление правами доступа.

Связанные страницы