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


Интеграция YCLIENTS работает с записями и контактами. 

Шаг 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) Если вы не можете выбрать сеть в интерфейсе, обратитесь к администратору этой сети, чтобы он проверил настройки.

      b. В поле Пароль введите пароль для входа в ваш аккаунт. 

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

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

    В поле Компания ответственных введите идентификатор компании, в которой состоят ответственные за заявки сотрудники.  
    Как узнать идентификатор компании в 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>
    
    

    где вместо 'ключ счетчика' нужно ввести 'ключ счетчика Roistat' в кавычках (подробнее читайте в статье Установка счетчика).

  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