Додавање повратних позива

Дефинисање повратног позива вам омогућава коришћење једне специфичну путање у неколико окидача или планера.

Основе

Путоказ

Имајте на уму да удаљена локација мора да буде у стању да разуме подразумеване податке повратног позива које Zammad шаље. Сазнајте више о прилагођавању података у следећем одељку.

To add a new regular webhook, click the New Webhook button. For a pre-defined webhook, click on the arrow button to the right and choose Pre-defined Webhook from the dropdown menu. In case you select a pre-defined webhook, you get asked to choose from one of the available pre-defined ones:

  • Mattermost

  • Microsoft

  • Rocket Chat обавештења

  • Slack

After you select one and click on Next, Zammad shows the webhook configuration dialog. This is what you see directly when creating a webhook from scratch. Read on for more information about the configuration of a webhook.

Подешавања

Можете да подесите следеће атрибуте повратних позива:

Назив

Овај назив ће бити приказан у оквиру избора окидача и планера.

Путања

Путања повратног позива на коју Zammad шаље своје податке. Имајте у виду да Zammad овде игнорише basic auth параметре. Погледајте у наставку како да подесите корисничко име и лозинку путем додатних поља.

Заглавља захтева

Одаберите између DELETE, PATCH, POST и PUT, у зависности од вашег случаја употребе.

SSL провера

Подразумевано је да - ако користите небезбедне самопотписане сертификате, подесите ову опцију на не.

Danger

Имајте на уму да искључивање SSL провере носи безбедносни ризик. Требало би је искључити само привремено или ради тестирања. Уколико је искључена, сертификати неће бити верификовани, што значи да ће било који достављени сертификат бити признат.

Аутентификација

Изаберите између HTTP Basic Authentication, Bearer Token или без аутентификације, у зависности од тога шта циљни сервис подржава.

Верификациони кључ

У случају да сте одабрали овај аутентификациони метод, унесите свој кључ овде.

Управљање корисницима

У случају HTTP Basic Auth, унесите корисничко име овде.

Лозинка

У случају HTTP Basic Auth, унесите вашу корисничку лозинку овде.

HMAC SHA1 кључ за потпис

Ако је подешено, сви послати повратни позиви садрже заглавље x-hub-signature које омогућава удаљеном сервису да верификује захтев.

Белешка

Ово не шифрује податке. Користите HTTPS протокол да бисте заштитили комуникацију. Садржи HMAC потпис тела захтева повратног позива. Сазнајте више о Hub потписима овде.

Повратни позив по шаблону

Ово поље се приказује само за повратне позиве по шаблону! Служи само као референца за повратне позиве по шаблону. Није могуће изменити га за постојеће повратне позиве. У зависности од врсте повратног позива по шаблону, додатна поља могу бити приказана испод овог. Могу се користити за додатно прилагођавање понашања повратног позива.

Пример сертификата:

Додатна поља повратног позива по шаблону
Прилагођени подаци

Подразумевано, искључено је и повратни позави ће увек слати подразумеване податке на циљну путању. Када је укључено, испод ће бити приказан уредник кода, где можете да подесите прилагођене податке за свој повратни позив у JSON формату. Да бисте уметнули подржане променљиве користите пречице : : или унесите #{ за претрагу.

Путоказ

  • Коришћење променљивих је ограничено у односу на остале контексте. Неке функције нису доступне у повратним позивима, нпр. екстензија .value, превод (#{t(object.attribute)}) и функције форматирање времена (#{dt(object.time_attribute, [...])}).

  • Прилагођени подаци морају бити у исправној JSON синтакси! Уредник кода ће вас обавестити путем аутоматизованих савета ако постоји проблем са кодом. Такође, неће бити могуће сачувати неисправну JSON структуру.

  • Унапред дефинисани повратни позиви ће увек обезбедити почетне прилагођене податке, специфичне за одговарајући сервис.

Уредник кода прилагођених података

Једноставан пример структуре изгледа овако:

{
  "ticket": "#{ticket.title}",
  "message": "#{notification.message}",
  "customer": "#{ticket.customer.fullname}"
}
Напомена

Ако је потребно, можете оставити корисне информације другим Zammad администраторима да боље разумеју дотични повратни позив.

Активно

Уколико је искључено, нећете бити у могућности да одаберете повратни позив у подешавањима окидача или планера. Искључени повратни позиви неће бити покренути. Ако окидачи или планери имају подешене и друге радње, оне ће се и даље извршавати.

Након што сте подесили свој повратни позив, не заборавите да га покренете путем окидача или планера. У случају да нешто не функционише, погледајте одељак о евиденцији позива.