Как настроить входящий канал

Входящий канал принимает HTTP-запросы от приложения, скрипта или внешнего сервиса. У каждого канала есть собственный публичный адрес, базовый шаблон и настройки получателей. Подключённые правила обработки могут менять текст и маршрут в зависимости от события.

В личном контексте канал направляет уведомления в ваши исходящие каналы. В организации он назначает сообщения сотрудникам и командам; каждый получатель выбирает свои способы внешней доставки.

Подготовьте получателя

Сначала создайте и подтвердите хотя бы один исходящий канал. Уведомления можно получать на Email, в Telegram, группе Telegram, Пачке или в Depesher Desktop.

Сам личный входящий канал принимает и сохраняет сообщения и без внешней доставки. Если исходящие каналы не связаны и правило не выбрало их явно, уведомление останется только в истории.

Создайте входящий канал

1. Выберите в боковом меню «Личное», откройте «Входящие каналы» и нажмите «Создать канал».
2. Укажите понятное название, например «Сборка проекта».
3. При необходимости выберите заранее созданный шаблон.
4. Нажмите «Сохранить».

После создания в карточке появится публичный адрес вида https://depesher.ru/w/ВАШ_PUBLIC_ID. Скопируйте его и укажите в приложении или сервисе, который будет отправлять события.

Не публикуйте рабочий адрес в открытом репозитории или журнале сборки. Если адрес стал известен посторонним, удалите канал и создайте новый.

Привяжите исходящие каналы

В карточке входящего канала нажмите карандаш рядом с «Отправлять уведомления в:», отметьте «Прямое назначение» у одного или нескольких подтверждённых исходящих каналов и сохраните выбор. Неподтверждённые исходящие каналы выбрать нельзя.

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

Канал организации

Администратор или менеджер выбирает организацию в боковом меню и создаёт канал в её разделе «Входящие каналы». Вместо исходящих каналов укажите сотрудников и команды в поле «Получатели», при необходимости выберите шаблон из каталога этой организации. Эти базовые получатели назначаются каждому сообщению. Для назначения только при определённых событиях оставьте базовый список пустым и подключите правила, как описано ниже.

Каждый потенциальный получатель затем открывает «Мою доставку» и выбирает свои активные подтверждённые способы. Без внешних способов назначенное сообщение доступно ему в «Моих уведомлениях».

Пошаговый пример — уведомления для команды.

Настройте обработку по событию

Из карточки канала откройте «Правила обработки», подключите сохранённые правила и задайте порядок. Для каждого запроса выполняется первое совпадение, затем — default, если обычные правила не подошли, либо базовые настройки канала.

Действие доставки выбранного правила добавляет цели к базовым назначениям. В личном контексте это исходящие каналы, в организации — сотрудники и команды. Цели остальных правил не добавляются к этому сообщению. Пересечения устраняются: одна цель не получает повторную доставку из-за нескольких оснований назначения.

Отсутствие действия доставки и пустой выбор в нём одинаково не добавляют целей; базовая доставка сохраняется. В личном канале внешней отправки нет, если пусты и базовые связи, и цели выбранного правила. В организации при отсутствии получателей из обоих источников личные назначения не создаются.

Для полностью условной доставки оставьте базовые назначения пустыми. После подключения правил каждый потенциальный получатель организации сможет настроить канал в «Моей доставке», даже если правило или подключение отключено. Само наличие канала в списке не означает получение каждого сообщения. Default добавляет своих получателей для неизвестного события; базовые назначения он тоже не отменяет.

Настройка и проверка — в обзоре правил и рецепте JSON.

Проверьте основания назначения

В настройках личного и организационного канала одна цель показана со всеми основаниями:

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

Если цель выбрана несколькими правилами, все их названия находятся в одной строке цели. Команды показаны как команды, без раскрытия состава. Счётчик «Базовых получателей» в организации относится только к назначениям самого канала.

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

Пример с постоянным получателем, двумя правилами и удалением одного основания — в командном рецепте.

Найдите канал и сохраните изменения

В личном списке используйте поиск и сортировку по названию или времени создания. Внизу можно выбрать 10, 25 или 50 строк; запись 1–25 / 60 означает показанный диапазон и общее число результатов с учётом поиска. Изменение поиска, сортировки или размера страницы возвращает на первую страницу. Если канал не найден, очистите поиск и проверьте выбранный контекст: список организации открывается отдельно.

Изменение названия и выбор исходящих каналов вступают в силу после «Сохранить». Отметки в открытом списке получателей — ещё черновик. При переходе в другой раздел ЛК с изменённой формой, названием или выбором доставки появляется окно «Несохранённые изменения»:

• «Отмена» — остаться и продолжить редактирование.
• «Не сохранять» — перейти, отбросив несохранённое.
• «Сохранить и продолжить» — записать изменения и перейти после успешного сохранения.

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

Это защита переходов внутри ЛК, а не автоматическое сохранение. Перед закрытием окна формы, перезагрузкой страницы или вкладки сохраните данные явно. В формах организации предупреждение появляется также при закрытии изменённой формы. Несохранённый черновик не обещается восстановить после перезагрузки.

При необходимости включите защиту

Нажмите «Включить защиту» в карточке канала и сохраните показанный токен: после закрытия окна посмотреть его повторно нельзя. Защищённый канал принимает запросы с заголовком:

Authorization: Bearer ВАШ_ТОКЕН

При замене токена прежний сразу перестаёт работать. После отключения защиты канал снова принимает запросы без заголовка Authorization.

Проверьте канал

Отправьте тестовый запрос по инструкции «Первое уведомление». В личном контексте нажмите «Сообщения» в карточке канала. В организации назначенный получатель проверяет «Мои уведомления». Убедитесь, что текст соответствует обработке и шаблону, а маршрут объединяет базовые назначения с целями выбранного правила, затем проверьте фактическое получение выбранными способами.

Если запрос не появился или уведомление не было доставлено, воспользуйтесь диагностикой доставки.

Параметры запроса, ответы и подтверждённые размеры собраны в HTTP-справке. Фильтры и подробности сохранённого события — история сообщений.