Логи веб-хуков

Лог веб-хуков  – это подробная история обмена данными, фиксирующая время запроса, его содержимое и ответ сервера. Без этих данных поддержка интеграции превращается в поиск ошибок вслепую. 

 Логи помогают решить следующие основные задачи: 

 Ÿ   отладка – на этапе настройки разработчик сразу видит корректность передачи данных; 

 Ÿ   контроль доставки – если ваш сервер станет недоступен, логи зафиксируют тип ошибки (404, 502, timeout); 

 Ÿ   автоматизация возврата – видя сбой в логах, система лояльности сама инициируют повторные попытки, пока данные не будут доставлены. 

   

 Список логов веб-хуков 

   

 Для просмотра и работы со списком логов, необходимо перейти в раздел  События - Логи веб-хуков 

   

 

   

 На текущей закладке отображается список логов веб‑хуков и набор инструментов для работы со списком: 

 Ÿ   Поисковая строка  – обеспечивает поиск необходимого лога веб-хука; 

 Ÿ   Фильтры  – позволяет проводить поиск логов по определенным критериям. Доступны фильтры: 

 - 

 Начало периода ; 

 - 

 Конец периода ; 

 - 

 Фильтр по ошибкам ; 

 - 

 Поиск по идентификатору хука ; 

 Ÿ    – позволяет просмотреть информацию о логе веб‑хука; 

 Ÿ   – удаляет веб-хук. 

   

 Взаимосвязь 

   

 Логику работы системы можно представить как цепочку: 

 1. 

 Действие – покупатель сканирует карту на кассе. 

 2. 

 Событие – в базе данных системы лояльности фиксируется запись. 

 3. 

 Формирование веб-хука – система лояльности видит, что на событие подписан адрес (URL) вашего сервера или CRM. Она берет данные (ID клиента, сумму, количество баллов) и упаковывает их в JSON-пакет. 

 4. 

 Отправка – система лояльности «стучится» на ваш сервер. 

 5. 

 Логирование – факт отправки и ответ вашего сервера записываются в логи. 

   

 Техническая связь с сервером происходит по протоколу HTTP (обычно через метод POST). На стороне системы управления лояльностью настраивается URL-эндпоинт (адрес, куда слать данные) и типы событий. 

 На стороне вашего сервера должен быть написан небольшой скрипт (обработчик), который: 

 1. 

 Принимает входящий запрос. 

 2. 

 Проверяет его подлинность (например, через секретный ключ или токен). 

 3. 

 Отдает ответ 200 OK (подтверждение получения). 

 4. 

 Запускает дальнейшую логику (например, обновляет баланс в мобильном приложении).