Webhook для отправки заявок через Roistat¶

Введение¶

Использование webhook решит задачу получения данных о заявках с сайта, Коллтрекинга, Ловца лидов, Email-трекинга и интеграция со сторонними сервисами в CRM-систему через Roistat. Далее вы можете использовать эти данные по своему усмотрению – например, для отправки в собственную CRM или 1С:Предприятие.

Описание работы¶

При возникновении различных событий данные будут отправлены в виде GET-параметров, в зависимости от типа, на адреса, указанные в полях Адрес обработчика заявок и Адрес для получения доп. информации по сделке в настройках интеграции. Данная опция есть в интеграциях Своя CRM и 1C:Предприятие.

Типы событий – Сделка¶

Параметры запроса

Пример запроса:

http://{webhook_url}/?user=&token={id_token}&action=lead&visit=9&id=6&title={title}&text={text}&name={name}&phone={phone}&email={email}&data={"page":"http:\/\/site.ru\/"}&created_date={yyyy-mm-dd+hh%3Amin%3Asec}

Типы событий – доп. информация¶

Параметры запроса

Настройка¶

1. Зайдите в настройки интеграции с типом Своя CRM или 1C:Предприятие и укажите в полях Адрес обработчика заявок и Адрес для получения доп. информации по сделке адреса страниц (webhook), на которые будет отправляться информация о заявках. В примере мы будем использовать один адрес http://site.ru/webhook.php для обоих событий.

   

2. По адресу, указанному выше (http://site.ru/webhook.php), расположите скрипт, который будет получать GET-параметры и производить с ними какое-либо действие.

В ответ ожидается статус OK и ID сделки:

{
"status" : "ok",
"order_id" : "ID_сделки"
}

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

Пример скрипта для получения информации о заявке из Ловца лидов:

<?php

if (array_key_exists('id', $_GET)) {
    $leadId = $_GET['id']; // Идентификатор лида, например "123"
    $leadTitle = $_GET['title']; // Заголовок, например: "Пойманный лид: 79111234567"
    $leadText = $_GET['text']; // Содержание заполненной формы Ловца лидов, например: "79111234567"
    $roistatVisit = $_GET['visit']; // Номер визита, значение cookie roistat_visit, например: "1234"
    $data = json_decode($_GET['data'], true); // data - это JSON, в котором ключ – page и значение – Страница захвата
    $page = $data['page']; // Страница захвата лида, например: "http://site.ru"

    // Здесь происходит какое-либо действие. Например, отправка в CRM

    // Возвращаем ответ ok и ID созданной сделки, если все прошло успешно. Если не передать этот ответ, информация о лиде будет отправляться на эту страницу раз в несколько минут
    exit(json_encode(array("status" => "ok", "order_id" => $orderId)));
}

После настройки интеграции рекомендуем воспользоваться следующими вспомогательными инструментами:

• Управление клиентами
• Дашборд
• Экспериментальные возможности
• Управление ставками
• Email-трекинг
• Когортный анализ
• Ловец лидов
• События