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

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

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

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

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

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

 

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

 

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

 

 

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

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

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

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

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

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

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

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

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

 

Взаимосвязь

 

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

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

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

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

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

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

 

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

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

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

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

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

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