Обзор
Webhook Service позволяет внешним системам подписываться на события, происходящие в системе vlApp.
При наступлении события система отправляет HTTP POST запрос на настроенный URL с данными о событии. На все запросы необходимо отвечать 200 OK.
После 5 неудачных попыток отправка вебхуков на ваш endpoint останавливается на 5 минут, через 5 минут система автоматически возобновит отправку.
Создание вебхука
Для создания вебхука перейдите в Настройки > Интеграции > WebHooks > Добавить WebHook
Формат Webhook уведомлений
Все вебхуки отправляются в формате JSON с единой структурой:
{
"event": "event_name",
"userId": "550e8400-e29b-41d4-a716-446655440001",
"timestamp": "2024-01-01T10:00:00Z",
"data": {
*// Данные события (зависят от типа события)*
}
}
event - строковый идентификатор типа события (например, "order_created", "customer_deleted")
data - объект с данными, специфичными для данного типа события
В разделах ниже приведены полные примеры payload для каждого типа события