Как работают вебхуки
Вебхук — POST-запрос от Дескуса на ваш адрес, когда что-то случилось: пришёл тикет, клиент написал, сотрудник ответил, сменился статус, появился клиент. Опрашивать API не нужно — событие придёт за секунды.
События
Событие | Когда | Нужно право |
|---|---|---|
| Новый тикет из любого канала |
|
| Сменились статус, приоритет, тема, ответственный, команда, клиент, срок «отложен» или тикет слит |
|
| Новое сообщение: от клиента, ответ сотрудника или заметка |
|
| Новая карточка клиента — из канала, вручную, импортом или через API |
|
Право нужно, если подписку создал ключ или приложение. Подписки из настроек получают всё, что отмечено. Формат каждого события — события.
Как подписаться
В кабинете: «Настройки → Компания → API и приложения → Вебхуки» → «Добавить вебхук». Укажите адрес и события, сохраните секрет подписи.
Через API: POST /webhooks — так подписываются коннекторы, когда клиент собирает связку.
Что должен уметь ваш адрес
Принять POST с JSON по https на порту 443 (http — на 80). Внутренние адреса и другие порты не принимаем, перенаправления не выполняем.
Проверить подпись
X-Deskus-Signature.Отсечь повтор по
idсобытия — одно и то же событие может прийти дважды.Ответить 2xx за 10 секунд. Долгую работу — в свою очередь, после ответа.
Полезно знать
Порядок не гарантирован:
message.createdможет прийти раньшеticket.created. Сверяйтеcreated_atи состояние тикета в теле.Событий раньше создания подписки не приходит — историю заберите через API.
Не принял — повторим: восемь попыток почти за сутки (повторы и журнал).
Проверить адрес можно сразу — кнопка «Проверить адрес» в меню подписки шлёт событие
ping.