Интеграция Roistat с RetailCRM¶

Интеграция CRM RetailCRM с Roistat. Как настроить отправку заявок в CRM через Roistat и загрузку из CRM контактов клиентов, выручки по заказу и себестоимости заказов.

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

Отправка заявок в CRM¶

Если заявка не была помечена как дубль, то:

1. Осуществляется поиск контактов (по всем контактам в CRM-системе) по номеру телефона или email-адресу.
2. Если контакт найден, то создается привязанная к нему новая сделка. Если контакт не найден, создается новый контакт и новая сделка.

Загрузка данных из CRM¶

Из CRM-системы в аналитику Roistat выгружаются данные по заказам и клиентам:

• Из CRM в Аналитику загружается выручка по заказу. Выручка рассчитывается по следующей формуле: сумма товаров + стоимость доставки.
• Загружается информация по себестоимости заказа по следующей формуле: себестоимость товаров + дополнительные статьи расходов. Для подсчета себестоимости используются значения из стандартных полей RetailCRM: purchaseSumm + delivery->netCost + сумма всех товаров сделки, полученных API-методом costs.
• Загружается контактная информация по клиентам для Управления клиентами.

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

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

1. В RetailCRM перейти на вкладку Настройки (на панели слева), раскрыть список Системные, выбрать пункт Пользовательские поля и нажать Добавить:

   

2. Ввести параметры поля:

   • Поле для: Заказ
   • Название: roistat или любое другое
   • Символьный код: roistat
   • Тип поля: Строка
   • Отображение: Редактируется

   

3. Нажать Сохранить.

Шаг 2. Подключите RetailCRM в каталоге интеграций¶

1. В интерфейсе Roistat откройте раздел Интеграции.
2. В блоке CRM выберите retailCRM и нажмите кнопку Настроить интеграцию.

3. Заполните поля для авторизации в RetailCRM:

   

   • В поле Адрес введите URL-адрес вашего проекта в RetailCRM. Обычно он выглядит так: https://<название проекта>.retailcrm.ru. 

   • В поле API-ключ введите API-ключ. Для этого скопируйте его в разделе RetailCRM Настройки → Интеграция → Ключи доступа к API:

     

     Обратите внимание на доступы в настройках API-ключа в интерфейсе RetailCRM:

     • В блоке Разрешенные действия в API должны быть выбраны все пункты.
     • Если вы хотите, чтобы заказы загружались для всех магазинов, укажите тип доступа Доступ ко всем магазинам.

     

4. В настройках интеграции в проекте Roistat нажмите кнопку Сохранить.

5. Откроется окно распределения статусов. При этом из RetailCRM загрузятся статусы сделок. Перетаскивая статусы сделок, распределите их по группам. Подробнее читайте в статье Распределение статусов сделок.
6. Прочитайте Инструкцию по включению отправки заявок и нажмите Следующий шаг.

7. Откроется окно расширенных настроек:

   

   В расширенных настройках интеграции вы можете:

   • Указать параметры для фильтрации сделок. Для этого прочитайте статью Фильтрация сделок.
   • Указать значения полей бизнес-показателей (поле с выручкой, поле себестоимости, поле с прибылью). Для этого прочитайте статью Поля бизнес-показателей.

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

8. На шаге Отправка заявок в CRM-систему: базовые настройки выберите из выпадающего списка магазин, в котором будут создаваться заказы. Укажите имена ответственных за заявки или оставьте это поле пустым. Нажмите кнопку Сохранить, чтобы применить изменения.

   

9. Откроется окно Отправка заявок в CRM-систему: создание задач:

   

   Чтобы включить данный механизм, активируйте переключатель Создавать задачи при создании сделки. Автоматическое создание задач нужно для того, чтобы менеджеры оперативно реагировали на поступающие заявки.

   Время на выполнение задачи – время, за которое задача должна быть выполнена. По умолчанию устанавливаются сутки, если в поле ничего не введено. Текст задачи – текст, который будет отображаться в CRM.

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

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

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

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

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

Настройка Товарной аналитики¶

Интеграция Roistat с RetailCRM позволяет использовать Товарную аналитику – инструмент, с помощью которого можно анализировать эффективность продаж категорий товаров и отдельных товаров.

Чтобы настроить Товарную аналитику:

1. Убедитесь, что в RetailCRM созданы товары. Для этого в личном кабинете RetailCRM перейдите в раздел Продажи → Склад → Товары. При необходимости создайте новый товар, нажав Новый товар.

   

2. В проекте Roistat откройте раздел Аналитика, перейдите на вкладку Товарная аналитика и нажмите Включить товарную аналитику:

   

3. После следующего импорта сделок из CRM информация о товарах попадет в Аналитику Roistat.

   Чтобы перейти в отчет по товарам, откройте раздел Аналитика → Отчеты. Затем кликните по названию текущего отчета, чтобы открыть список всех доступных отчетов:

   

   Раскройте группу Стандартные отчеты и выберите отчет Товары:

   

   Также подробная информация о товаре отображается в карточке сделки:

   

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

После того, как на сайте отправлена заявка, в RetailCRM создается новая сделка с заполненным полем Roistat ID. Сделки также отображаются и в Roistat:

1. В проекте Roistat откройте раздел Интеграции.
2. На виджете настроенной интеграции с RetailCRM нажмите кнопку Настроить интеграцию.
3. В окне настройки интеграции пройдите по ссылке Список отправленных заявок.

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

• Управление клиентами
• Дашборд
• Экспериментальные возможности
• Управление ставками
• Email-трекинг
• Когортный анализ
• Ловец лидов
• События
• Радар

Передача заявок при интеграции RetailCRM и Telegram¶

Вы можете настроить передачу заявок с номером визита из Telegram в Roistat, если у нас настроена интеграция RetailCRM с Telegram.

1. Убедитесь, что на сайте установлен счетчик Roistat. Сразу после кода счетчика вставьте следующий скрипт:

   <script>
       (function() {
           if (window.roistat !== undefined) {
               handler();
           } else {
               var pastCallback = typeof window.onRoistatAllModulesLoaded === "function" ? window.onRoistatAllModulesLoaded : null;
               window.onRoistatAllModulesLoaded = function () {
                   if (pastCallback !== null) {
                       pastCallback();
                   }
                   handler();
               };
           }
   
           function handler() {
               function init() {
                   appendMessageToLinks();
   
                   var delays = [1000, 5000, 15000];
                   setTimeout(function func(i) {
                       if (i === undefined) {
                           i = 0;
                       }
                       appendMessageToLinks();
                       i++;
                       if (typeof delays[i] !== 'undefined') {
                           setTimeout(func, delays[i], i);
                       }
                   }, delays[0]);
               }
   
               function replaceQueryParam(url, param, value) {
                   var explodedUrl = url.split('?');
                   var baseUrl = explodedUrl[0] || '';
                   var query = '?' + (explodedUrl[1] || '');
                   var regex = new RegExp("([?;&])" + param + "[^&;]*[;&]?");
                   var queryWithoutParameter = query.replace(regex, "$1").replace(/&$/, '');
                   return baseUrl + (queryWithoutParameter.length > 2 ? queryWithoutParameter  + '&' : '?') + (value ? param + "=" + value : '');
               }
   
               function appendMessageToLinks() {
                   var message = 'roistat_{roistat_visit}';
                   var text    = message.replace(/{roistat_visit}/g, window.roistatGetCookie('roistat_visit'));
                   text = encodeURI(text);
                   var linkElements = document.querySelectorAll('[href*="//t.me"]');
                   for (var elementKey in linkElements) {
                       if (linkElements.hasOwnProperty(elementKey)) {
                           var element = linkElements[elementKey];
                           element.href = replaceQueryParam(element.href, 'start', text);
                       }
                   }
               }
               if (document.readyState === 'loading') {
                   document.addEventListener('DOMContentLoaded', init);
               } else {
                   init();
               }
           };
       })();
   </script>
   

2. Если вы ещё не используете бота Telegram, создайте его:

   • Найдите бота @BotFather в Telegram.
   • Запустите бота, отправив в чат команду /start.
   • Отправьте в чат команду /newbot.
   • Создайте бота, следуя инструкции, которую предоставляет @BotFather.

   После создания бота вам будет выдан API-токен. Сохраните его, он понадобится для настройки интеграции.

   Если у вас есть готовый бот, зайдите в диалог с @BotFather и найдите в истории сообщений API-токен соответствующего бота.

3. В интерфейсе RetailCRM перейдите в раздел Администрирование → Интеграция → Ключи доступа к API и создайте API-ключ, который будет использоваться для передачи сообщений. При создании ключа выберите все метода раздела Интеграция:

   

4. Перейдите в раздел Администрирование → Интеграция → Маркетплейс, откройте модуль интеграции с Telegram и нажмите Подключить. На странице подключения укажите URL вашей RetailCRM и API-ключ, созданный в п.3 в разделе Ключи доступа к API. Затем сохраните изменения.

   

   После сохранения появится дополнительная вкладка Боты, где нужно указать API-токен, полученный в п.2 при создании бота:

   

5. Когда клиент впервые напишет в Telegram, в RetailCRM будет передан номер визита в формате /start roistat_{number}, где {number} – номер визита. В примере ниже номер визита – 100500:

   

   Чтобы данные по этой заявке передались в Roistat, при создании сделки номер визита нужно скопировать в поле roistat, созданное при интеграции с RetailCRM.

*Правообладателем Facebook является запрещенная на территории РФ компания Meta Platforms, признанная судом экстремистской.