Интеграция с Битрикс24¶
Если у вашего аккаунта в Битрикс24 (лиды + сделки) права, отличные от прав администратора, то после настройки интеграции возможны ошибки в передаче информации между R7K12 и Битрикс24 (лиды + сделки). Чтобы проверить права в Битрикс24 (лиды + сделки):
- В личном кабинете в Битрикс24 откройте раздел Компания.
- Перейдите на закладку Сотрудники.
- Нажмите Редактировать напротив пользователя Битрикс24 (лиды + сделки), который будет настраивать интеграцию с R7K12:
- На странице настроек профиля пользователя в блоке Информация о пользователе убедитесь, что установлен флажок Разрешить пользователю редактировать портал:
Как работает интеграция¶
При оформлении заявки на сайте автоматически создается новая сделка в CRM, в которую передается идентификатор визита из куки браузера r7k12_si в дополнительное поле с именем r7k12id.
Настройка интеграции¶
Шаг 1. Установите счетчик на сайт¶
Подробное описание того, как установить счетчик на сайт описано в разделе справки Установка счетчиков.
Шаг 2. Добавьте дополнительное поле¶
Добавьте пользовательское поле r7k12id в сущностях "Лид" и "Сделка":
- В Bitrix24 откройте закладку CRM → Ещё → Настройки → Настройки форм и отчетов → Пользовательские поля.
2. Для сущности “Лид” нажимаем “Добавить поле” в открывшемся окне, в поле “Название” вносим “r7k12id”, в поле “Тип” выбираем “Строка”.
3. Аналогично добавляем поле r7k12id к сущности "Сделка".
Шаг 3. Подключите Битрикс24 в каталоге интеграций¶
В системе R7K12 Переходим в закладку “Интеграции”, выбираем плашку “Битрикс24”.
В открывшемся окне, в поле “Введите портал” вводим адрес вашего проекта, который можно взять из Url bitrix24. Например, https://<имя проекта>.bitrix24.ru, соответственно берем <имя проекта>.bitrix24.ru. В правом, верхнем углу нажимаем “Создать”.
В вашем профиле в Битрикс24 откроется страница с информацией о приложении для интеграции с R7K12. Отмечаем пункты “Я ознакомлен и согласен с лицензионным соглашением” и “Я ознакомлен и согласен с политикой конфиденциальности”.
Если окно с информацией о приложении для интеграции R7K12 не открывается и в Marketplace вы не находите его, напишите нам, мы поможем.
Установите флажки Я ознакомлен и согласен с лицензионным соглашением и Я ознакомлен и согласен с политикой конфиденциальности и нажмите Установить.
Для установки приложения у вашей учетной записи в Битрикс24 должны быть права администратора.
Если все прошло успешно, у Вас откроется следующее окно:
Выставляем статусы сделок:
Статусы сделок могут иметь следующие значения:
- “Не учитывается” - Если сделке присвоен данный статус, она в аналитике находится в столбце "Обращения"..
- “В обработке” - означает, что сделка находится столбце "Заявки".
- “Успешно реализовано” - сделка успешно закрыта и находится в столбце "Продажи".
- “Отказ” - Означает что сделка закрыта и не реализована, находится в столбце "Отмененные заявки".
Далее выбираем ответственных за сделку менеджеров:
Выбираем “Статус по умолчанию”:
Сохраняем конфигурацию кнопкой “Сохранить”, расположенной в правом верхнем углу.
Шаг 4. Настройте автоматическую отправку сделок в Битрикс24¶
Session_id храниться в:
- куках (cookie) браузера (r7k12_si);
- локальном хранилище (localStorage) браузера (r7k12_si);
- в глобальной переменной JS (r7k12_si).
Получение ID визита рекомендуется реализовать через функцию “R7K12_CallBack”. Данная функция будет автоматически вызвана после отправки “pageview” и получения ID визита. Функция должна быть объявлена до инициализации скрипта счетчика. Информация с форм может отправляться в CRM как с помощью PHP, так и с помощью JavaScript. Скрипты равнозначны и выполняют одну и ту же функцию. 4.1. Скрипт PHP:
<?php
$KEY = 'PROJECT KEY';//ключ проекта
$CRM = array(
'r7k12id' => isset($_COOKIE['r7k12_si']) ? $_COOKIE['r7k12_si'] : null,
'type' => 'Form',//Тип заявки (ОБЯЗЯТЕЛЬНО)
'title' => 'Проверка макросов',//Заголовок заявки (НЕ ОБЯЗАТЕЛЬНО)
'comment' => 'Коментарий к сделке',//Комментарий к сделке (НЕ ОБЯЗАТЕЛЬНО)
'name' => 'Имя клиента',//Название контакта (НЕ ОБЯЗАТЕЛЬНО)
'email' => '[email protected]',//E-mail адрес контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН ТЕЛЕФОН КОНТАКТА)
'phone' => '79001234567',//Телефон контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН E-MAIL КОНТАКТА)
'create_new_lead' => '1' //'0' - новая сделка создается только если нет сделки или предыдущая в статусе "успешно реализовано" или "возврат"; '1' - новая сделка создается в любом случае
);
$context = stream_context_create(array(
'http' => array(
'method' => 'POST',
'content' => json_encode($CRM),
),
));
file_get_contents("https://r7k12.ru/".$KEY."/crm/", false, $context);
При использовании отправки через PHP более приемлемо использовать библиотеку cURL вместо функции file_get_contents(). Пример:
<?php
define('KEY','YOUR PROJECT KEY');
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://r7k12.ru/'.KEY.'/crm/');
curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt(
$curl,
CURLOPT_POSTFIELDS,
urlencode(
json_encode(
[
'r7k12id' => !empty($_COOKIE['r7k12_si']) ? $_COOKIE['r7k12_si'] : null,
'type' => 'Form',
'comment' => 'Комментарий к сделке',
'name' => 'Имя клиента',
'email' => 'E-mail клиента',
'phone' => 'Телефон клиента',
'create_new_lead' => '0'
],
JSON_UNESCAPED_UNICODE
)
)
);
$out = curl_exec($curl);
curl_close($curl);
4.2. JavaScript:
r7k12.push({
hit: 'crm',
data: {
type: "Form",//тип заявки
title: "Заявка с сайта",//Заголовок заявка
comment: "Сделка созданная с фронта",//комментарий
name: "Алексей Владимирович",//имя контакта
phone: "8-912-345-67-89",//телефон
fields: {//доп. поля
lead: {
cost: "{cost}",
revenue: "{revenue}",
price: 100,
'127633': 'Текст' // Заполнение доп. поля с ID ‘127633’
// Подробную информацию о наименовании полей и получить список доп. полей вы можете в документации Битрикс24: https://dev.1c-bitrix.ru/rest_help/crm/fields.php
},
contact: {
'3124124': 'Текст' // Заполнение доп. поля с ID ‘3124124’
// Подробную информацию о наименовании полей и получить список доп. полей вы можете в документации Битрикс24: https://dev.1c-bitrix.ru/rest_help/crm/fields.php
}
}
}
});
Если отправка форм настроена успешно, тогда на закладке “Лог заявок” будут отображаться поступающие в систему заявки.
Подключение CRM-форм в Битриксе¶
Для того, чтобы отслеживать обращения с данных форм, необходимо передавать r7k12id в сделки.
Откройте настройки формы (в Битриксе CRM -> Ещё -> CRM-формы):
