Исходящий канал

Исходящий канал — это определяемый пользователем обратный вызов через HTTPS. Вы можете использовать канал для оповещения своего приложения, когда в системе происходят определенные события. Например, оповестить удалённое приложение о создании новой заявки, добавлении нового ответа или её при обновлении.
Использование канала для этих целей означает, что вашему приложению не нужно будет периодически опрашивать API, чтобы определить произошли ли изменения.

Этот канал по своим функциям напоминает отправку вебхука при помощи диспетчера, только исходящий канал работает асинхронно, а диспетчер — синхронно. Также здесь нельзя задавать тело вебхука и заголовки, ведь подразумевается, что данные будут фильтроваться уже на стороне сервиса, куда отправляются вебхуки. Как вариант, можно использовать сервисы pipedream или requestcatcher, чтобы просмотреть в каком формате приходят данные по разным событиям.

Например, информация по новому ответу в заявке приходит в JSON формате:

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

 

Для создания исходящего канала перейдите в меню "Настройка каналов связи" и нажмите кнопку "Добавить канал":

 

В списке каналов найдите "Исходящий канал" и укажите департамент, в заявках которого будут "отлавливаться" события.

Ниже укажите название канала и вставьте URL запроса, после чего сохраните настройки:

В случае успешного соединения в статусе канала будет написано "Соединение успешно установлено!". 

Ниже есть настройка "Повторы событий". Если включить её, то в случае HTTP статуса ниже 200 или выше 400, событие будет отправлено повторно с задержкой.

Над статусом канала доступна кнопка "журнал вебхуков":

 

Там хранится лог отправки запросов, включая дату и время, ответ запроса, http код и номер заявки:

 

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

  • Создание заявки;
  • Добавление ответа (в "классическом" интерфейсе заявки);
  • Добавление ответа в чат (в интерфейсе "омни");
  • Добавление комментария;
  • Изменение статуса;
  • Изменение приоритета;
  • Изменение типа;
  • Изменение исполнителя;
  • Закрытие заявки;
  • Изменение департамента;
  • Достигнут SLA (на выполнение заявки);
  • Добавлена оценка (оценка заявки от клиента).
     

Как только любое из активированных событий в заявке осуществится, вы получите соответствующее оповещение об этом.