Loading...
Page tree
Skip to end of metadata
Go to start of metadata

Введение

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

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

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

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

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

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

ПараметрПримерОписание
id90Уникальный идентификатор отправляемой заявки
visit12852Номер визита, в котором содержится источник заявки
title

Звонок от 79990001122
Пойманный лид: 79990001122
JivoSite Lead

Для звонка из Коллтрекинга
Для заявки из Ловца лидов
Для заявки из JivoSite 
text

Данные формы: 79990001122
Промокод: 1674
Страница захвата: http://site.ru
Дата отправки: 17:22 15.04.2015

Дополнительная информация о заявке. Обычно отправляется в комментарий к сделке
Для Коллтрекинга здесь же передается информация о набранном номере 
nameИванИспользуется для поля Имя в форме Ловца лидов
phone+79990001122Номер набранного телефона или поле Телефон в форме Ловца лидов
emailemail@mail.ruИспользуется для адреса почты в форме представления для JivoSite
data

Используется для Ловца лидов
data - это json, в котором ключ page и значение - Страница захвата

Дополнительные поля и значения дополнительных полей также передаются в data

created_date2015-06-28 09:12:54Дата и время получения лида сервером Roistat (UTC+0)
token6512bd43d9caa6e02c990b0a82652dca

Токен генерируется из логина и пароля указанного в настройках интеграции.

 md5('username' + 'password')

actionleadТип события

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

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Полная история переписки оператора и клиента

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

ПараметрПримерОписание
leadId155Идентификатор сделки
titleПовторная заявкаЗаголовок
textПовторная заявка от {Имя клиента} {Эл. почта} {Номер телефона} с текстом {Сообщение в лиде...}Текст уведомления
actionmessageТип события
userdemouserИмя пользователя указанное в настройках интеграции
token6512bd43d9caa6e02c990b0a82652dcaТокен генерируется из логина и пароля указанного в настройках интеграции. md5('username' + 'password')

Настройка

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

2) По адресу, указанному выше (http://site.ru/webhook.php), расположите скрипт, который будет получать GET-параметры и производить с ними какое-либо действие.
(info) в ответ ожидается статус 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))); 
}
  • No labels