gitlab-notification/documentation/ru/docs/features/notify.md

🔔 Уведомления

Основное предназначение бота - это уведомления от GitLab. Вы будете получать только те уведомления, которые касаются вас непосредственно.

Новый репозиторий

Если во время первичной настройки вы указали, что хотите получать уведомления о новых репозиториях, то при появлении нового репозитория получите соответствующее уведомление:

{ loading=lazy width="500" }

Уведомление содержит:

• Project name — название репозитория.
• Project description — описание репозитория. Опционально, может быть пусто.
• Struchkov Mark — имя создателя репозитория в GitLab

Доступно три быстрых действия:

• 🔗 — ссылка на новый репозиторий в GitLab.
• 🔔 — поставить на отслеживание. Вы начнете получать уведомления о событиях в MR, тредах и сборках.
• 🔕 — не получать уведомления. Используется по умолчанию, по факту просто удаляет сообщение уведомления.

!!! warning ""

Пока вы явно не нажмете :bell:, вы не будете получать никаких уведомлений. Более того, приложение даже не будет запрашивать MR и прочие сущности репозитория, не будет сохранять их в БД.

Новый MR

Это уведомление приходит, когда вас назначают ответственным и/или ревьювером. При этом не важно когда это произошло: вас указали при создании MR, или потом заменили кого-то вами. Вы в любом случае получите уведомление.

{ loading=lazy width="500" }

Уведомление содержит:

• Название MR.
• Описание MR. Опционально.
• Labels. Метки репозитория.
• Имя проекта.
• Ветки откуда куда мержим.
• Автор MR.
• Ответственный/Ревьюверы MR. Заполнение зависит от вашей позиции в этом MR. Если вы ответственный, то вам покажут ревьюверов. Если вы ревьювер, то ответственного.

Доступные быстрые действия:

• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на MR.
• 🔕 — не получать уведомления по MR.

!!! warning ""

Учтите, что отключение уведомлений отключает только уведомления об изменениях в MR. Например, обновление статуса MR. Но уведомления по пайплайнам проекта, по тредам MR продолжат приходить.

Конфликт в MR

Если в вашем MR возник конфликт, то вы будете своевременно оповещены. В этом уведомлении указывается название MR, проект и ветка.

{ loading=lazy width="500" }

Доступные быстрые действия:

• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на MR.
• 🔕 — не получать уведомления по этому MR.

Обновление MR

Если в MR, в котором вы являетесь ответственным/ревьювером, добавляются коммиты, вы получаете уведомление.

{ loading=lazy width="500" }

Уведомление содержит:

• Название MR.
• Отношение количества закрытых тредов к общему количеству созданных тредов.
• Отношение количества закрытых вами созданных тредов к общему количеству созданных вами тредов.
• Название репозитория.
• Имя создателя MR.

Доступные быстрые действия:

• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на MR.
• 🔕 — не получать уведомления по этому MR.

Изменение статуса MR

Когда статус вашего MR меняется, вы получаете уведомление.

{ loading=lazy width="500" }

Доступные быстрые действия:

• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на MR.

Новый тред в MR

В GitLab можно создавать не просто комментарии, а треды. Если кто-то создаст такое обсуждение в вашем MR, то вы сразу об этом узнаете.

Это уведомление поддерживает уровни конфиденциальности:

1. WITHOUT_NOTIFY — уведомления по тредам не отправляются совсем.
2. NOTIFY_WITHOUT_CONTEXT — вы получаете уведомление о факте нового треда, но без текста сообщений и отправителей.
3. NOTIFY_WITHOUT_CONTEXT — самое подробное уведомление. Содержит текст сообщений и имена отправителей.

=== "NOTIFY_WITH_CONTEXT"

<figure markdown>
![notify about new thread in merge request](img/notify-new-thread.png){ loading=lazy width="500" }
</figure>

Уведомление содержит:

- Название MR
- Первое сообщение треда с автором треда
- Остальные сообщения треда, если таковые имеются.

=== "NOTIFY_WITHOUT_CONTEXT"

<figure markdown>
![notify about new thread in merge request](img/notify-new-thread-without-context.png){ loading=lazy width="500" }
</figure>

Уведомление содержит:

- Название MR

Доступные быстрые действия:

• Ответ в GitLab из Telegram.
• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на тред.
• 🔕 — не получать уведомления по этому треду. Уведомления по другим тредам в это MR продолжат поступать.

Новое сообщение в треде

Важно оставаться в теме обсуждения, поэтому при появлении новых ответов в тредах, в которых вы участвовали, вы получите уведомление.

Это уведомление поддерживает уровни конфиденциальности:

1. WITHOUT_NOTIFY — уведомления по тредам не отправляются совсем.
2. NOTIFY_WITHOUT_CONTEXT — вы получаете уведомление о факте нового треда, но без текста сообщений и отправителей.
3. NOTIFY_WITHOUT_CONTEXT — самое подробное уведомление. Содержит текст сообщений и имена отправителей.

=== "NOTIFY_WITH_CONTEXT"

<figure markdown>
![notify about new message in thread](img/notify-new-comment-in-thread.png){ loading=lazy width="500" }
</figure>

Уведомление содержит:

- Название MR
- Первое сообщение треда с автором треда
- Предпоследнее сообщение треда
- Новое сообщение треда

!!! tip ""

    Такой объем информации должен помочь вам вспомнить/понять контекст обсуждения и ответить прямо из Telegram.

=== "NOTIFY_WITHOUT_CONTEXT"

<figure markdown>
![notify about new comment in thread without context](img/notify-new-comment-in-thread-without-context.png){ loading=lazy width="500" }
</figure>

Уведомление содержит:

- Название MR

Доступные быстрые действия:

• Ответ в GitLab из Telegram.
• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на тред.
• 🔕 — не получать уведомления по этому треду. Уведомления по другим тредам в это MR продолжат поступать.

Упоминание в треде

Допустим, кто-то упомянул вас в MR используя тегирование GitLab (@GitlabLogin). Автор этого MR не вы, ответственным назначали тоже не вас.

Если вы отслеживаете репозиторий этого MR, но не участвовали в дискуссии, то в этом случае вам придет уведомление. Так вы не пропустите сообщения с вашим упоминанием.

Формат и быстрые действия такие же, как у уведомления "Новое сообщение в треде".

Уведомление о решенном треде

Уведомление о пайплайне

Полезно сразу узнавать, что сборка закончилась успешно или упала.

{ loading=lazy width="500" }

Уведомление содержит:

• Предыдущий статус пайплайна и новый

Доступные быстрые действия:

• 👀 — прочитано. Удаляет сообщение.
• 🔗 — ссылка на результат работы пайплайна.