Вебхуки: события и проверка подписи

Вебхуки настраиваются в Настройки → API и вебхуки (только для администраторов). Адрес вебхука должен быть https.

Можно выбрать пять событий:

• conversation.created: обращение создано.
• conversation.handed_off: обращение передано оператору.
• conversation.resolved: обращение решено.
• ticket.reply: оператор или ассистент ответил клиенту. В данных есть номер обращения, external_id контакта, автор ответа, его имя для клиентов и начало текста (до 280 символов). Внутренние заметки и неотправленные черновики событие не вызывают.
• idea.status_changed: идея сменила статус.

Gladask отправляет POST-запрос с JSON. В заголовках приходят:

• X-Gladask-Event: название события.
• X-Gladask-Delivery: идентификатор доставки. По нему можно отсеять повторную доставку.
• X-Gladask-Signature: вида t=<время>,v1=<подпись>. Подпись — HMAC-SHA256 от строки <время>.<тело запроса> с секретом вебхука.

Секрет показывается один раз при создании вебхука. Последние доставки видны на той же странице: статус, код ответа и число попыток.