Вэб хуки, Web hooks #127

  • webhook.jpg
    webhook.jpg

Многим требуется интеграция HelpDeskEddy со сторонними системами, либо же рассылка уведомлений. В нашей системе присутствует мощное API, которое позволяет обмениваться информацией с внешними системами. Однако зачастую необходимо из HelpDeskEddy получить информацию по какому либо событию, например отправить уведомление при поступлении срочной заявки. Для этого HelpDeskEddy умеет вызывать Webhook.

Вебхуки – позволяют оповещать/вызывать внешние системы о событиях в HelpDeskEddy. Например, при помощи вебхуков можно отправлять SMS уведомления клиентам/сотрудникам, интегрироваться с CRM системой и так далее.

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

При добавление вебхука необходимо:

  • Выбрать HTTP метод: GET, POST, PUT, PATCH, DELETE.
  • Указать ссылку, куда будет отправлен запрос. В ссылке можно использовать теги.
  • Указать формат отправляемых данных: JSON, XML, X-FORM-URLENCODED.
  • Если необходима авторизация, то нужно выбрать тип авторизации: имя пользователя, пароль/API ключ.
  • Сформировать запрос с данными в выбранном формате использую теги. В случае X-FORM-URLENCODED, разделителем для переменных необходимо использовать “&”.

Если сервер, на который отправляется запрос, отвечает HTTP кодом 2ХХ/3ХХ, то запрос считается успешным, в другом случае, например, если сервер недоступен, запрос будет повторяться каждые 30 минут в течение 24 часов.

 

Пример вебхука для отправки уведомления сотруднику в Telegram при поступлении новой заявки:

 

Необходимо использовать следующий URL:

https://api.telegram.org/bot*/sendMessage, где * - ключ бота (API Token).

 

"chat_id":* отвечает за id пользователя (сотрудника), которому будет отправлено уведомление о поступлении заявки.

Чтобы узнать id, необходимо сначала написать с Telegram аккаунта нужного пользователя в систему, после чего просмотреть эту информацию в его карточке пользователя и вставить её в само правило:

 


Аналогичный пример вебхука для отправки смс с помощью сервиса prostor-sms:

 

 

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

 

1267