Перейти к содержанию

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

Вебхук (Webhook) в Ловце лидов – это механизм отправки стороннему приложению информации о пользователях, оставляющих заявки через форму Ловца лидов.

Принцип работы

При отправке формы Ловца лидов Webhook автоматически отправляет POST-запрос по адресу назначения.

Тело POST-запроса содержит JSON-объект, отображающий информацию о пользователе, который оставил заявку:

{
  "id": "111",// уникальный номер письма в Roistat
  "visit_id": "123456", // номер визита
  "name": "Test", // имя клиента
  "phone": "+79990009900", // номер телефона
  "date": "2019-02-18 13:28:48", // дата пойманного лида
  "page": "test.com/new", //страница захвата
  "marker": "vk_new", // источник визита
  "city": "Москва", // город
  "country": "Россия", // страна
  "ip": "100.100.1.1", // IP-адрес
  "first_visit": "1001", // первый визит
  "referrer": "vk.com", // источник перехода
  "domain": "www.test.com", // домен сайта
  "landing_page": "test.com/new", // посадочная страница
  "utm_source": null,
  "utm_medium": null,
  "utm_campaign": null,
  "utm_term": null,
  "utm_content": null,
  "roistat_param_1": null,
  "roistat_param_2": null,
  "roistat_param_3": null,
  "roistat_param_4": null,
  "roistat_param_5": null,
  "google_client_id": null,
  "metrika_client_id": null,
  "source_level_1": "vk",
  "source_level_2": "new"
}

Пример обработчика, дополняющего лог:

<?php
$data = json_decode(trim(file_get_contents('php://input')), true);
file_put_contents('webhook-log.html', serialize($data) . '<br />', FILE_APPEND); // В $data будет массив ключ => значение с информацией о звонке, описанной выше

Настройка Webhook

  1. Скопируйте URL-адрес стороннего приложения, на который должны приходить уведомления из Roistat.

  2. В проекте Roistat откройте Ловец лидов.

  3. В блоке Настройка уведомлений о пойманных лидах активируйте переключатель Webhook и в поле ниже вставьте URL-адрес, скопированный в пункте 1 инструкции:

    1.png

    Настройки сохранятся автоматически после ввода URL-адреса.

Уведомления могут отправляться только на один URL-адрес.

Чтобы отменить отправку данных из форм Ловца лидов, отключите опцию Webhook.