База знаний

База знаний

callbackhunter.com

Есил Вам необходимо обрабатывать события виджета при помощи собственного обработчика, Вы можете задействовать внешний обработчик, указав его в личном кабинете.

Вебхуки позволяют перенаправлять доступные события на указанный Вами внешний адрес, который в свою очередь будет заниматься их обработкой.

Для обеспечения должной безопасности мы подписываем данные Вашим ключом,  чтобы Вы могли на своей стороне убедиться, что данные действительно получены от нашей системы.

Соответствующий блок настроек можно найти в индивидуальных настройках виджета

Webhook адрес

— прямая ссылка на Ваш обработчик. Например: myownsite.com/callbackhunter_handler.php

Webhook ключ

— ключ, которым будут подписаны, отсылаемые нашей системой, данные

События

— список событий, при которых происходит отправка вебхуков от нашей системы к указанному адресу

Информация будет отправляться Вашему обработчику(webhook адресу) через POST запрос и будет иметь следующий вид

{
    "event": "Название события",
    "status": "Статус или действие над событием",
    "data": "Информация по событию в формате JSON",
    "signature": "md5(Ваш_ключ + data)"
}

Реальный пример данных вебхука при заказе отложенного звонка

{
"event": "call",
"status": "deferred",
"data": {
"site": "yoursite.com",
"user_id": "123",
"user_language": "ru",
"widget_id": "456",
"widget_timezone_offset": "7200",
"call_client_name": "Артем Виляев",
"call_client_phone": "+79111111111",
"manager_phone": "+79222222222",
"referer": "yoursite.com\/somepage.html",
"referer_original": "yandex.ru\/click\/jsredir....",
"entrance_page": "yoursite.com\/somepage?somequery",
"planned_call_date": "2016-01-12 12:00:00",
"call_request_date": "2016-01-11 23:41:16",
"office_name": "Варшавский-Офис",
"custom_cookie": "{}",
"sess_ip": "194.186.207.1",
"geo_location": "Россия, Москва",
"utm_source": "yandex",
"utm_medium": "",
"utm_term": "",
"utm_content": "",
"utm_campaign": "",
"widget_show_reason": "1"
},
"signature": "60d6c9fa2d7c659fadb8420174eb8422"
}

Сигнатура сформирована ключом: adawdasda

Простой пример PHP скрипта, который обрабатывает вебхуки

$mySecretKey = 'adawdasda'; //Ключ, который указывается в кабинете,и, который используется проверки валидности запроса извне

if(isset($_POST['signature'], $_POST['data']) && md5($mySecretKey . $_POST['data']) === $_POST['signature']){
//Да, данные пришли от Callbackhunter/ Можно проводить обработку
} else {
//Не переданы данные или попытка передачи "фальшивых" данных(запрос не от Callbackhunter)
}

Подробную информацию по работе с каждым событием можно найти в соответствующих вкладках

ВАЖНО!

Включение вебхуков не отключает обработку событий по ним на стороне нашего сервиса.

Письма и уведомления будут отсылаться нашей системой в штатном режиме.

Source callbackhunter.com