Перейти к содержимому

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

Входящий вебхук приложения Slack и подключение в Statuser — пошагово со скриншотами

Statuser присылает уведомления в канал Slack через входящий вебхук приложения. Настройка займёт несколько минут: создайте в Slack приложение, включите у него входящие вебхуки, выберите канал и вставьте адрес в Statuser — уведомления начнут приходить в канал.

Что понадобится

  • Воркспейс Slack, в который вам разрешено устанавливать приложения. Если установку одобряет администратор, на шаге 3 Slack предложит отправить ему запрос.
  • Интерфейс Slack — на английском, поэтому названия кнопок ниже приведены так, как они написаны в самом Slack.

Шаг 1. Создайте приложение

Откройте api.slack.com/apps и нажмите Create New App (или Create an App, если приложений у вас ещё нет). Выберите Blank app и нажмите Continue. Введите имя Statuser, выберите воркспейс и нажмите Create.

С этим именем будут приходить уведомления. Значок приложения можно сменить позже на странице Basic Information → Display Information.

Шаг 2. Включите входящие вебхуки

В меню приложения слева откройте Incoming Webhooks и переведите переключатель Activate Incoming Webhooks в положение On. Затем внизу страницы нажмите Add New Webhook.

Шаг 3. Выберите канал

Slack откроет экран разрешения. В поле Channel for webhook выберите канал для уведомлений и нажмите Allow.

Slack вернёт вас на страницу Incoming Webhooks: в таблице появится адрес вида https://hooks.slack.com/services/…. Скопируйте его кнопкой Copy.

Адрес вебхука работает как пароль: токен лежит прямо в нём, и любой, кто его знает, может писать в канал. Не пересылайте его в открытых чатах.

Один вебхук пишет в один канал. Чтобы уведомления приходили ещё в один канал, нажмите Add New Webhook снова и подключите новый адрес в Statuser отдельно — различать каналы поможет подпись.

Шаг 4. Подключите Slack в Statuser

  1. Откройте Настройки аккаунта → Уведомления и нажмите Добавить канал.
  2. Выберите Slack и вставьте скопированный адрес. Подпись необязательна — она пригодится, если каналов Slack будет несколько.
  3. Нажмите Отправить тест — в канал придёт тестовое сообщение Statuser.
  4. Нажмите Подключить и отметьте проекты, уведомления которых должны приходить в этот канал.

Как выглядят уведомления

Уведомление приходит от приложения обычным сообщением: заголовок со значком события, подробности и ссылка на инцидент или сервер в Statuser. Сообщения, пришедшие подряд, Slack собирает под одним заголовком приложения.

Какие события уходят в канал, настраивается в правилах уведомлений: у события можно раскрыть список каналов и выключить в нём Slack. Из каких проектов — решают тумблеры каналов в настройках проекта. Подробнее — в статье Каналы уведомлений.

Если тест не проходит

  • Statuser пишет, что это не адрес входящего вебхука Slack — вставлена ссылка на страницу приложения, а не адрес из таблицы. Нужен адрес, который начинается с https://hooks.slack.com/services/.
  • Чат вернул HTTP 403 — адрес скопирован не целиком. Скопируйте его заново кнопкой Copy.
  • Чат вернул HTTP 404 — вебхук удалён или приложение удалено из воркспейса. Создайте новый вебхук, начиная с шага 2.
  • Чат вернул HTTP 410 — канал архивирован. Верните его из архива или создайте вебхук для другого канала.
DiscordПачка