ВОЙТИ

Вебхуки

Последние изменения: 20.07.2016
добавить в избранные

Вебхуки (webhooks) — инструмент для оповещения сторонних сайтов об определённых событиях. Они позволяют отслеживать изменения на Омнидеске и отправлять нужную информацию на указанный вами URL, чтобы выполнять действия на других сервисах.

Примеры использования

а) У вас есть VIP клиенты. При поступлении входящих обращений от них вы хотите получать не только уведомления на почту, но и SMS.

б) Когда сотрудники не соблюдают минимальный уровень услуг (SLA), в обращение добавляется метка.

в) Если обращение помечается определённой меткой, автоматически ставьте задачу в Basecamp, JIRA или на любом другом сервисе.

Это лишь небольшая часть возможностей вебхуков. Способов их применения множество.

Настройка

Для большего удобства вебхуки размещены в правилах. Они добавляются в качестве обычного действия во всех типах правил (для входящих, изменённых и текущих обращений).

1) При добавлении действия «Выполнить вебхук» первым делом нужно выбрать метод отправки запроса: GET, POST, PUT и DELETE.

2) Далее указывается URL запроса, в который можно вставить переменные через ссылку, расположенную справа над полем.

3) Если для принятия запроса требуется аутентификация, достаточно отметить чекбокс и выбрать способ аутентификации:

4) При выборе методов POST и PUT появляются дополнительные поля для указания самого запроса и его формата:

Чтобы было понятнее, как это выглядит вживую, вот правило, которое мы используем для получения уведомлений в Slack:

Просто скопируйте текст нашего кастомного запроса и сэкономьте время :)

Настроенное таким образом уведомление в Slack выглядит так:

Ограничения

В час можно выполнить до 1000 вебхуков. Ограничение действует для всего аккаунта, поэтому учитываются вебхуки, настроенные во всех правилах.

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

Когда статус 2хх, вебхук считается успешно выполненным. Статус 3хх означает, что страница ведёт на другую страницу, поэтому выполняется редирект. Если статус ни 2хх, ни 3хх, значит, возникла проблема. В этом случае мы повторяем запрос каждые 30 минут, пока он не будет выполнен успешно, но совершаем не более 48 попыток.