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

Как работает интеграция

При оформлении на сайте заявки в системе YCLIENTS автоматически создаются следующие сущности: новая запись на услугу и клиент (в случае если новый).

В запись на услугу передается номер визита из куки браузера roistat_visit  в дополнительное поле с именем roistat. Если менеджер принимает заказ по телефону, он может спросить промокод (настраивается отдельно) и ввести этот код в поле roistat.

(warning) Данные о клиентах YCLIENTS передаются в Roistat (раздел Управление клиентами), но они не связываются со сделками.

 

 (info) Если значение из поля Roistat будет случайно удалено, то при загрузке сделок наша система самостоятельно определит источник обращения, чтобы сделка попала в нужный рекламный канал.

Настройка интеграции

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

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

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

Измените код формы YCLIENTS

Найдите следующий код YCLIENTCS

<script type="text/javascript" src="https://wXXXXX.yclients.com/widgetJS" charset="UTF-8"></script>

где wXXXXX - ID вашей формы.

И замените его на следующий:

<script>
window.roistatVisitCallback = function(visitId) {
document.cookie = 'yextrafield_roistat=' + visitId;
var script = document.createElement('script');
script.src = "https://wXXXXX.yclients.com/widgetJS";
document.getElementsByTagName('body')[0].appendChild(script);
};
</script>

Вместо wXXXXX вставьте ID вашей формы.

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

Дополнительное поля для интеграции включается в YCLIENTS в разделе Аналитика - Интеграция с Roistat.

Шаг 3. Подключите YCLIENTS в каталоге интеграций

  1. Откройте Каталог интеграций.
  2. В блоке CRM / CMS выберите YCLIENTS и нажмите кнопку Подключить.
  3. Заполните поля для авторизации в YCLIENTS:
    1. В поле Логин введите адрес электронной почти или номер телефона, на который зарегистрирован ваш аккаунт. Номер нужно вводить без знака +, скобок и пробелов. Например, 7xxxxxxxxxx.
      (warning) Необходимо убедится, что данный пользователь добавлен в настройках главной сети и имеет администраторский доступ.

       Как проверить, что пользователь добавлен в настройки главной сети

      1. Необходимо проверить, какая сеть является главной у настраиваемого филиала. В интерфейсе филиала перейдите во вкладку "Настройки" - "Сеть"

      2. Перейдите в настройки нужной сети, являющейся главной, (маркер 1) и перейдите во вкладку "Настройки" - "Пользователи" (маркер 2). Проверьте, что пользователь добавлен в настройки сети и имеет полные права.
      (warning) Если вы не можете выбрать сеть в интерфейсе, обратитесь к администратору этой сети, чтобы он проверил настройки.

    2. В поле Пароль введите пароль для входа в ваш аккаунт.
  4. Нажмите кнопку Сохранить.
    Загрузятся статусы сделок из YCLIENTS .
  5. Перетаскивая статусы сделок, распределите их по группам. Подробнее об этом читайте в статье  Распределение статусов сделок.
  6. Нажмите кнопку Продолжить.
  7. Укажите параметры для расширенной настройки:
    1. Укажите параметры для фильтрации сделок, для этого читайте статью Фильтрация сделок.
    2. Укажите значения полей бизнес-показателей, для этого читайте статью Поля бизнес-показателей.
    3. Нажмите кнопку Сохранить.

    В поле Ответственные за заявки введите через запятую идентификаторы сотрудников. С помощью этого списка Roistat автоматически распределяет сделки по указанным сотрудникам.

     Как узнать идентификатор менеджера
    1. В личном кабинете YCLIENTS раскройте раздел Сотрудники и нажмите на имя интересующего вас сотрудника.
    2. В адресной строке браузера после master_id= отображается идентификатор сотрудника:
  8.   В поле Компания ответственных введите идентификатор компании, в которой состоят ответственные за заявки сотрудники.  
    Как узнать идентификатор компании в YCLIENTS.

  9. Нажмите Сохранить.
  10. В YCLIENTS откройте Онлайн-запись → Вебсайт → Инъекция скрипта.
  11. В поле HTML код удалите имеющийся и вставьте следующий код:
     

    <script>
    (function(w, d, s, h, id) {
       w.roistatProjectId = id; w.roistatHost = h;
       var p = d.location.protocol == "https:" ? "https://" : "http://";
       var u = /^.*roistat_visit=[^;]+(.*)?$/.test(d.cookie) ? "/dist/module.js" : "/api/site/1.0/"+id+"/init";
       var js = d.createElement(s); js.charset="UTF-8"; js.async = 1; js.src = p+h+u; var js2 = d.getElementsByTagName(s)[0]; js2.parentNode.insertBefore(js, js2);
    })(window, document, 'script', 'cloud.roistat.com', '{ключ счетчика}');
    </script>
    <script>
       window.onRoistatModuleLoaded = function () {
           var params = window
           .location
           .search
           .replace('?','')
           .split('&')
           .reduce(
               function(p,e){
                   var a = e.split('=');
                   p[ decodeURIComponent(a[0])] = decodeURIComponent(a[1]);
                   return p;
               },
               {}
           );
           if (params['yextrafield_roistat']) {
               window.roistat.setVisit(params['yextrafield_roistat']);
           }
       };
    
    window.roistatVisitCallback = function (visitId) {
          console.log('visitId', visitId);
            
    window.yclientsAdditionalOptions = {
                bookingCustomFields: {
                    roistat: visitId
                }
            };
        };
    </script>
    
    

    где вместо {ключ счетчика} введите ключ счетчика (подробнее читайте в статье Установка счетчика).

  12. Нажмите Сохранить.

Шаг 4. Настройте автоматическую отправку сделок в YCLIENTS

Если вы на сайте используете сторонние формы (кроме виджета YCLIENTS), рекомендуем настроить передачу сделок в CRM через Roistat - механизм отправки сделок, при котором сделки сначала передаются в Roistat, затем отправляются в CRM. Механизм обладает рядом преимуществ. Подробнее читайте в статье Передача заявок в CRM через Roistat.

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

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

 

$roistatVisitId array_key_exists('roistat_visit'$_COOKIE) ? $_COOKIE['roistat_visit'] : "неизвестно";

 

Проверка работы 

  1. Создайте заявку на сайте.
  2. В проекте Roistat откройте Каталог интеграций.
  3. В блоке Сейчас подключено на виджете настроенной интеграции с YCLIENTS   нажмите кнопку Настроить.
  4. В окне настройки интеграции пройдите по ссылке Список отправленных заявок и найдите созданную заявку.
  5. Проверьте, что в поле Промокод указан номер визита.
  6. Проверьте статус отправки заявки: в поле Отправлен  должен появиться успешный статус отправки , а в  YCLIENTS – новая запись на услугу с номером визита. 


  • No labels