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

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

Введение

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

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

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

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

Событие Описание
Заявка из Ловца лидов Данные будут отправлены, если установлена опция Отправлять в CRM в настройках Ловца лидов.
Звонок из Коллтрекинга Данные будут отправлены при звонке по телефону из Коллтрекинга. Важно: данные будут отправлены только для первого звонка с номера. Данные с повторных звонков не отправляются.
Заявка из интеграции с JivoSite Данные будут отправлены, если настроена интеграция с JivoSite.

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

Параметр Пример Описание
id 90 Идентификатор отправляемой заявки
visit 12852 Номер визита, в котором содержится источник заявки
title Звонок от 79990001122. Пойманный лид: 79990001122. JivoSite Lead Для звонка из Коллтрекинга. Для заявки из Ловца лидов. Для заявки из JivoSite
text Данные формы: 79990001122. Промокод: 1674. Страница захвата: http://site.ru. Дата отправки: 17:22 15.04.2015 Дополнительная информация о заявке. Обычно отправляется в комментарий к сделке. Для Коллтрекинга здесь же передается информация о набранном номере
name Иван Используется для поля Имя в форме Ловца лидов
phone +79990001122 Номер набранного телефона или поле Телефон в форме Ловца лидов
email email@mail.ru Используется для адреса почты в форме представления для JivoSite
data - Используется для Ловца лидов. data – это JSON, в котором ключ – page и значение – Страница захвата. Дополнительные поля и значения дополнительных полей также передаются в data
created_date 2015-06-28 09:12:54 Дата и время получения лида сервером Roistat (UTC+0)
token 6512bd43d9caa6e02c990b0a82652dca Токен генерируется из логина и пароля, указанного в настройках интеграции. md5('username' + 'password'). При интеграции по API токен генерируется из пустой строки, так как логин и пароль не передаются.
action lead Тип события

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

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}

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

Уведомление Описание
Повторная заявка Информация о входящем вызове от клиента, для которого в CRM уже есть сделка
История переписки JivoSite Полная история переписки оператора и клиента

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

Параметр Пример Описание
leadId 155 Идентификатор сделки
title Повторная заявка Заголовок
text Повторная заявка от {Имя клиента} {Эл. почта} {Номер телефона} с текстом Текст уведомления
action message Тип события
user demouser Имя пользователя, указанное в настройках интеграции
token 6512bd43d9caa6e02c990b0a82652dca Токен генерируется из логина и пароля, указанного в настройках интеграции. md5('username' + 'password'). При интеграции по API токен генерируется из пустой строки, так как логин и пароль не передаются.

Внимание!

Roistat не отправляет Webhook повторно. Повторно отправляются только заявки. Заявки-дубли повторно отправляться не будут.

Настройка

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

    1.png

  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)));
}

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