Вебхуки

Владелец и Администратор компании открывают Администратор компании → Продажи и интеграции → Интеграции → API и вебхуки. Вебхук отправляет в вашу систему HTTPS POST с JSON каждый раз, когда происходит выбранное событие.

#Создание вебхука

1. В разделе Вебхуки выберите Новый вебхук.
2. Введите Название и URL. Только HTTPS. Внутренние и частные сетевые адреса заблокированы.
3. В разделе События отметьте, что отправлять: lead.created, deal.created, deal.stage_changed, deal.won, deal.lost, contact.created, contact.updated, company.created, company.updated.
4. Выберите Создать вебхук, скопируйте секрет подписи и выберите Я сохранил(а). Используйте его для проверки заголовка X-Dromix-Signature в каждом запросе. Он показывается только сейчас; позже его можно сменить.

Выберите Отправить тест, чтобы сразу отправить событие ping.

#Проверка подписи

Каждый запрос содержит заголовки X-Dromix-Event, X-Dromix-Event-Id, X-Dromix-Delivery, X-Dromix-Timestamp (секунды Unix) и X-Dromix-Signature. Подпись: sha256= + HMAC-SHA256(secret, {timestamp}.{body}). Вычислите её у себя, сравните и отклоняйте запросы старше 5 минут.

После повтора одно и то же событие может прийти дважды. Используйте X-Dromix-Event-Id, чтобы пропускать дубликаты.

Если секрет утёк, выберите Сменить секрет. Старый секрет сразу перестанет работать. Сразу после этого обновите получателя.

#Доставки и повторы

Выберите Журнал доставок, чтобы увидеть каждую доставку со статусом, попытками и следующей попыткой. Неудачные доставки повторяются через 1 мин, 5 мин, 30 мин, 2 ч, 6 ч и 24 ч. Вебхук отключается после 50 ошибок подряд или если получатель отвечает 410 Gone.

Когда приёмник снова работает, включите вебхук переключателем Вкл..