Skip to end of metadata
Go to start of metadata

Видеоинструкция

Шаг 1. Установите счетчик на сайт

На каждую страницу, куда заходят посетители, нужно установить счетчик, который позволит Roistat получать данные о посетителях. Сразу будет доступна функциональность промокодирования (для отслеживания продаж через телефон). Счетчик установит в cookie переменную roistat_visit,  которая будет содержать номер визита.

О том, как установить счетчик на сайт, читайте в статье Установка счетчика.  Если на сайте уже есть счетчик, пропустите этот шаг.

Шаг 2. Добавьте дополнительное поле roistat

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

Для наглядности вы можете посмотреть, как создаются дополнительные поля в других CRM.

Шаг 3. Создайте страницу для выгрузки сделок

Необходимо создать страницу, которая при получении GET-запроса с параметрами будет выгружать информацию о сделках в формате JSON или XML.

Сервер Roistat делает GET-запрос:

http://example.com/integration.php?date= 1453836403&user=vasya&token=d41d8cd98f00b204e9800998ecf8427e&action=export&offset=0&limit=1000

Описание параметров в запросе:

ПараметрОписание
date Дата (в формате UNIX-time) после которой, были изменения в сделках
user Имя пользователя (Указывается в настройках интеграции)
token md5 ( $username . $password )
action Действие
limitЛимит количества выгружаемых сделок
offsetКоличество заявок от начала выборки которые нужно пропустить

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

Формат ответа:

 Пример в формате JSON
 Пример в формате XML

Тип полей в массивах statuses и orders принципиально не важен, как правило, это stringint. Для суммы сделки или себестоимости может быть float

Массив statuses  содержит список всех статусов сделок с их уникальными номерами и названиями.

Описание элементов массива statuses :

ЭлементОписание

id

Уникальный идентификатор статуса. Используется в массиве orders

name

Название статуса. Используется в интерфейсе Roistat

Массив orders содержит информацию о сделках, которые обновлялись в период с  date  (переданный нами GET-параметр) по текущую дату.

Описание элементов массива orders :

ЭлементОписаниеОбязательный
idУникальный идентификатор сделкиДа
nameНазвание сделки. Используется в интерфейсе RoistatНет
date_createДата создания сделки в формате UNIX-time или YYYY-MM-DD HH:MMДа
statusУникальный идентификатор статуса из массива statusesДа
priceСумма сделки. Используется в показателе «Выручка» в RoistatНет
costCебестоимость сделки. Используется в показателе «Себестоимость» в Roistat Нет
roistatНомер визита, сохраненный у сделки. Значение cookie roistat_visit. Используется для определения источника сделкиНет

client_id

Идентификатор клиентаНет

Описание элементов массива  pagination :

ЭлементОписание
total_count

Количество заявок, которые были изменены после заданной даты. Используется во фрагменте кода:

$query = "SELECT COUNT(`id`) FROM `orders` WHERE `edit_date` > {$editDate};";
$dbResult = $db->query($query);
$totalCount = $dbResult['0'];
limitКол-во заявок, которое будет выгружаться за один запрос

Пример кода на PHP для страницы выгрузки:

 Показать код

Шаг 4. Создайте страницу для выгрузки клиентов

По той же ссылке, которая отдает информацию о заказах, можно добавить также информацию о клиентах.
Сервер Roistat делает аналогичный GET-запрос, только отправляет в параметрах action=export_clients :

http://example.com/integration.php?date=1453836403&user=vasya&token=d41d8cd98f00b204e9800998ecf8427e&action=export_clients

Описание параметров в запросе:

ПараметрОписание
date Дата начиная с которой запрашиваются клиенты (В формате UNIX-time)
user Имя пользователя (Указывается в настройках интеграции)
token md5 ( $username . $password )
action export_clients

Формат ответа:

 Пример в формате JSON
 Пример в формате XML

Описание элементов массива clients:

ЭлементОписаниеОбязательный
idУникальный идентификатор клиентаДа
nameИмя клиентаДа
phoneНомер телефонаДа
emailЭл. почтаДа
companyНазвание компанииНет

birth_date

День рождения (В формате Y-m-d)Нет

Шаг 5. Подключите СвоюCRM в каталоге интеграций

Чтобы настроить передачу в Roistat данных со страницы выдачи сделок из вашей CRM:

  1. В проекте Roistat откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите Roistat API (Собственное решение для выгрузки информации о сделках в систему Roistat) и нажмите кнопку Подключить.
  3. В поле URL страницы введите URL страницы, на которую выгружаются данные о сделках, созданную в Шаге 3.
  4. Если страницы для выгрузки сделок защищена логином и паролем, введите их в одноименные поля.
  5. Нажмите Сохранить.
    Загрузятся поля для дополнительной настройки.  Если вы уже использовали API-метод для загрузки в Roistat статусов сделок из вашей CRM, они отобразятся в группе Не учитываются (см. информацию о массиве  statuses в Шаге 3).

  6. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей .
  7. В поле Ссылка на сделку в CRM введите URL, по которому хранятся сделки в вашей CRM. Вместо id сделки укажите в URL {order_id}. Например: http://mycrm.com/orders/ {order_id} /view.
  8. В поле Ссылка на контакт в CRM введите URL, по которому хранятся контакты клиентов в вашей CRM. Вместо id контакта укажите в URL {contact_id}. Например: http://mycrm.com/contacts/ {contact_id} /view.
  9. В поле Адрес обработчика заявок введите webhook-URL, на который Roistat будет отправлять информацию о звонках с сайта, проходящих через Коллтрекинг Roistat, и заявках с сайта, если вы настроите отправку заявок в CRM через Roistat. Подробнее читайте в статье Webhook для отправки заявок.
  10. В поле Адрес для получения доп. информации по сделке введите webhook- URL, на который Roistat будет отправлять дополнительную информацию по сделкам, если настроено. Подробнее читайте по    ссылке.
  11. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
  12. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье  Распределение статусов сделок.

Шаг 6. Настройте отправку сделок с сайта в CRM

Рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

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

Пример кода, с помощью которого можно получить значение этой куки:


  • No labels