Уведомления

GitRiver поддерживает 8 каналов уведомлений о событиях в репозиториях: push, пулл-реквесты, задачи, CI/CD, релизы и другие. Каналы настраиваются на уровне каждого репозитория.

Поддерживаемые каналы

Канал	Что нужно для настройки
Встроенные	Ничего - работают из коробки (колокольчик в интерфейсе)
Email	SMTP-сервер (настройка в Конфигурации)
Telegram	Токен бота + ID чата
Slack	Webhook URL (Block Kit формат)
Discord	Webhook URL (Embeds формат)
Microsoft Teams	Webhook URL (Adaptive Cards формат)
Matrix	URL сервера + токен + ID комнаты
Вебхуки	URL для получения POST-запросов

---

Настройка канала

Каналы настраиваются для каждого репозитория отдельно.

1. Откройте настройки

Репозиторий -> «Настройки» (шестерёнка) -> в списке найдите секцию каналов уведомлений.

2. Добавьте канал

Нажмите «Создать канал» и выберите тип.

3. Заполните параметры

Параметры зависят от типа канала:

Telegram:

• Токен бота - получите у @BotFather
• ID чата - ID группы или личного чата (число)

Slack:

• Webhook URL - создайте Incoming Webhook в настройках Slack workspace

Discord:

• Webhook URL - создайте в настройках канала Discord: Edit Channel -> Integrations -> Webhooks

Microsoft Teams:

• Webhook URL - создайте Incoming Webhook в канале Teams

Вебхук (общий):

• URL - адрес, на который GitRiver будет отправлять POST-запросы
• Запросы подписываются HMAC-SHA256 (заголовок X-GitRiver-Signature-256)

4. Протестируйте

Нажмите «Тест» - GitRiver отправит тестовое сообщение в канал.

---

Фильтрация событий

Не все события нужно отправлять во все каналы. Для каждого канала можно настроить фильтры:

• По типу события: push, пулл-реквест, задача, CI, релиз
• По веткам: только main, только release/*
• По авторам: только определённые пользователи

Настройка: при создании/редактировании канала, секция «События».

---

Настройки email для пользователя

Каждый пользователь управляет своими email-уведомлениями:

1. Настройки (аватар -> шестерёнка) -> Уведомления
2. Режимы:
   • Всё - все события в репозиториях, где вы участник
   • Упоминания - только когда вас @упомянули или назначили
   • Тихий режим - email не отправляются

---

Шаблоны сообщений

Администратор может настроить шаблоны email-сообщений:

Администрирование -> Шаблоны email

Доступные шаблоны:

• Уведомление о событии (push, PR, issue)
• Приглашение нового пользователя
• Сброс пароля

---

Вебхуки (подробно)

Вебхуки - универсальный способ интеграции GitRiver с внешними системами. При событии GitRiver отправляет POST-запрос с JSON-телом.

Настройка

1. Репозиторий -> «Настройки» -> «Вебхуки»
2. Нажмите «Добавить вебхук»
3. Укажите URL и секрет (для проверки подписи)
4. Выберите события

Проверка подписи

GitRiver подписывает каждый запрос с помощью HMAC-SHA256. Заголовок X-GitRiver-Signature-256 содержит подпись. Проверяйте её на стороне приёмника для защиты от подделки.

История доставки

На странице вебхука видна история всех доставок: статус, время, тело запроса и ответа. Можно повторить неудачную доставку кнопкой «Повторить».

Повторные попытки

При ошибке доставки (HTTP ≠ 2xx) GitRiver повторяет отправку с возрастающим интервалом: 1 сек, 5 сек, 30 сек, 2 мин, 15 мин.

Системные вебхуки

Администратор может создать вебхуки на уровне всего инстанса (для всех репозиториев):

Администрирование -> Вебхуки