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

Уведомления из Пачки ​

Допустим, команда обсуждает обращения в Пачке, а дежурному удобнее получать уведомления в Telegram или на Email. Для такого сценария можно связать Пачку с Депешером через вебхук.

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

Подготовьте Депешер ​

  1. Подключите и подтвердите нужный исходящий канал, например Telegram или Email.
  2. Откройте входящие каналы и создайте канал «События из Пачки».
  3. Свяжите его с подготовленным исходящим каналом и скопируйте публичный адрес вида https://depesher.ru/w/ВАШ_PUBLIC_ID.

Используйте адрес, скопированный из своего канала. Подробный пример настройки есть в статье «Первое уведомление».

Подключите Пачку ​

  1. В Пачке откройте «Автоматизации» → «Интеграции» → «Чат-боты и Вебхуки» и создайте бота.
  2. На вкладке «Исходящий Webhook» вставьте адрес входящего канала Депешера в поле «Webhook URL».
  3. Включите «Новые сообщения». Для проверки выберите режим «О любых сообщениях».
  4. Добавьте бота в чат, сообщения из которого нужно пересылать, и сохраните настройки.

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

Оформите уведомление ​

Пачка передаёт событие в JSON. Чтобы получатель увидел удобный текст, создайте шаблон с форматом «Обычный текст»:

text
Новое сообщение в Пачке

{{json.content}}

Открыть сообщение: {{json.url}}

Привяжите шаблон к входящему каналу «События из Пачки». Поле content содержит текст, а url — ссылку на сообщение.

Например, после сообщения «Нужна помощь с доставкой уведомлений» получатель увидит:

text
Новое сообщение в Пачке

Нужна помощь с доставкой уведомлений

Открыть сообщение: <ссылка на сообщение в Пачке>

Без шаблона Депешер включит в уведомление исходный JSON. Подробнее о доступных подстановках — в статье «Шаблоны и подстановки».

Направьте события команде ​

Для общего рабочего источника создайте канал «События из Пачки» в нужной организации и назначьте сотрудников или команды. В Пачке укажите публичный URL этого канала. Шаблон выше создайте в каталоге организации и выберите у канала.

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

Выберите получателей по событию ​

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

Общий рецепт — один JSON-поток для разных команд. Используйте его порядок, действия и default, заменив примерные поля и значения приложения на поля вашего события Пачки. В личном контексте выбирайте исходящие каналы, в организационном — сотрудников и команды.

Для полностью условной доставки очистите базовые назначения канала: в личном контексте — связи с исходящими каналами, в организации — сотрудников и команды. В каждом правиле задайте нужные цели, для остальных событий подключите default. Выполняется первое совпавшее правило; его цели добавляются к базе, а не заменяют её. Без совпадения и активного default при пустой базе сообщение останется только в личной истории; в организации личных назначений сотрудникам не будет.

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

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

Проверьте доставку ​

Напишите новое текстовое сообщение в чате Пачки, куда добавлен бот. В личном контексте откройте историю входящего канала; в организации назначенный сотрудник проверяет «Мои уведомления». Затем проверьте Telegram или почту получателя. При подключённых правилах ожидаемый маршрут объединяет базовые назначения с целями выбранной ветки.

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

Какие ещё сценарии можно настроить ​

Вместо всех сообщений можно отслеживать сообщения, начинающиеся с команды, например /notify. Это удобно для уведомлений по запросу: сотрудник пишет команду в чате, а Депешер передаёт сообщение получателю.

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

У сообщения только с файлом или картинкой поле content может быть пустым. Ссылка позволит открыть оригинал в Пачке; этот шаблон не пересылает вложения.

Оригинальная документация ​

Инструкция адаптирована под входящие каналы и шаблоны Депешера. Настройка бота и поля событий описаны в документации Пачки: