Каналы доставки

Найти новость — половина дела. Вторая половина — чтобы сообщение дошло туда, где вы его прочитаете: в почту, в рабочий чат или в вашу собственную систему. Канал — это адрес доставки вместе с настройками доступа к нему.

Семь видов каналов

  • Почта — самый универсальный вариант: подходит для сводок и для тех, кто не живёт в мессенджерах. Требует настроенного почтового сервера отправки.
  • Telegram — быстро и привычно для команды. Нужен бот и получатель (личный чат или группа).
  • Slack — для компаний, которые работают в Slack.
  • Discord — то же для сообществ и команд в Discord.
  • Microsoft Teams — для компаний на Microsoft 365.
  • Вебхук — обращение к адресу вашей системы с подписью. Нужен, когда событие должно попасть не человеку, а программе — в CRM, склад или систему поддержки.
  • Вызов API — как вебхук, но с тонкой настройкой: способ обращения, заголовки и тело запроса задаются вручную. Для нестандартных служб.

Настройка

Каналы создаёт агент по вашей просьбе: «подключи рассылку на этот адрес», «заведи бота в нашу рабочую группу». Частные случаи, о которых стоит знать заранее:

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

Обязательная проверка канала

Пока канал не проверен тестовым сообщением, он не отправляет ничего. Это защита от очень дорогой ошибки: настроили, решили, что работает, а сообщения всё это время молча не уходили.

Проверка отправляет настоящее сообщение по настоящему адресу — и, если всё в порядке, открывает канал. После смены адреса, получателя или токена проверку нужно пройти заново: проверено было прежнее место, а не новое.

Что входит в сообщение

  • Краткое содержание — или честная пометка о том, что подтверждения для него не нашлось.
  • Оценка значимости — число и полоса.
  • Изменения значений — «12 900 → 9 600 (минус 26%)».
  • Имя монитора и источника — чтобы сразу понимать, о чём речь.
  • Ссылка на событие — открывает карточку с доказательствами.

Вебхук получает не текст для человека, а полный набор данных о событии — чтобы ваша программа обработала его сама.

Журнал доставки

Каждая отправка оставляет запись: статус, сколько было попыток, что ответил сервер, а также тексты запроса и ответа. Это отвечает на вопросы «дошло ли» и «почему нет» без переписки с поддержкой: видно, что именно ушло и что вам ответили.

Повторы

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

Безопасность

  • Защита от отправки на внутренние адреса. Вебхук и вызов API не отправят данные на служебные адреса вашей сети — так чужая настройка не превратится в способ заглянуть внутрь.
  • Секреты маскируются. Токены, пароли и адреса с ключами при чтении настроек заменяются на «***». В интерфейсе и в ответах агента настоящих секретов не видно.
  • Ключ можно отозвать. Испортился токен или ушёл подрядчик — доступ закрывается одним действием.

Дальше → Публикация

← Оглавление документации