Интеграция с Bitrix24¶
Ако вашият акаунт в Bitrix24 (лидове + сделки) има права, различни от правата на администратор, след настройката на интеграцията са възможни грешки при предаването на информация между R7K12 и Bitrix24 (лидове + сделки). За да проверите правата в Bitrix24 (лидове + сделки):
- В личния кабинет в Bitrix24 отворете раздела Компания.
- Отидете в раздела Служители.
- Щракнете върху Редактирай срещу потребителя на Bitrix24 (лидове + сделки), който ще настройва интеграцията с R7K12:
- На страницата с настройките на профила на потребителя, в блока Информация за потребителя, се уверете, че е поставена отметка в Разреши на потребителя да редактира портала:

Как работи интеграцията¶
При оформяне на заявка на сайта автоматично се създава нова сделка в CRM, в която идентификаторът на посещението от бисквитката на браузъра r7k12_si се предава в допълнителното поле с име r7k12id.
Настройка на интеграцията¶
Стъпка 1. Инсталирайте кода за проследяване на сайта¶
Подробно описание на това как да инсталирате кода за проследяване на сайта има в раздела на помощната информация Инсталиране на кода за проследяване.
Стъпка 2. Добавете допълнително поле¶
Добавете потребителско поле r7k12id в обектите „Лид“ и „Сделка“:
- В Bitrix24 отворете раздела CRM → Още → Настройки → Настройки на формите и отчетите → Потребителски полета.
2. За обекта „Лид“ щракваме върху „Добави поле“, в отворилия се прозорец в полето „Име“ въвеждаме „r7k12id“, а в полето „Тип“ избираме „Низ“.
3. По същия начин добавяме полето r7k12id към обекта „Сделка“.
Стъпка 3. Свържете Bitrix24 в каталога с интеграции¶
В системата R7K12 отиваме в раздела „Интеграции“ и избираме плочката „Bitrix24“.
В отворилия се прозорец, в полето „Въведете портал“, въвеждаме адреса на вашия проект, който можете да вземете от URL адреса на bitrix24. Например https://<име на проекта>.bitrix24.ru, съответно вземаме <име на проекта>.bitrix24.ru. В горния десен ъгъл щракваме върху „Създай“.
Във вашия профил в Bitrix24 ще се отвори страница с информация за приложението за интеграция с R7K12. Отбелязваме точките „Запознат съм и съм съгласен с лицензионното споразумение“ и „Запознат съм и съм съгласен с политиката за поверителност“.
Ако прозорецът с информация за приложението за интеграция с R7K12 не се отваря и не можете да го намерите в Marketplace, пишете ни и ще ви помогнем.
Поставете отметки в Запознат съм и съм съгласен с лицензионното споразумение и Запознат съм и съм съгласен с политиката за поверителност и щракнете върху Инсталирай.
За да инсталирате приложението, вашият потребителски акаунт в Bitrix24 трябва да има права на администратор.
Ако всичко е минало успешно, ще се отвори следният прозорец:
Задаваме статусите на сделките:
Статусите на сделките могат да имат следните стойности:
- „Не се отчита“ – ако на сделката е присвоен този статус, в аналитиката тя се намира в колоната „Запитвания“..
- „В обработка“ – означава, че сделката се намира в колоната „Заявки“.
- „Успешно реализирано“ – сделката е успешно приключена и се намира в колоната „Продажби“.
- „Отказ“ – означава, че сделката е приключена и не е реализирана; намира се в колоната „Отменени заявки“.
След това избираме отговорните за сделката мениджъри:
Избираме „Статус по подразбиране“:
Запазваме конфигурацията с бутона „Запази“, разположен в горния десен ъгъл.
Стъпка 4. Настройте автоматичното изпращане на сделки в Bitrix24¶
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' => '380501234567',//Телефон контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН 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.com/".$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.com/'.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 формите в Bitrix¶
За да проследявате запитванията от тези форми, трябва да предавате r7k12id в сделките.
Отворете настройките на формата (в Bitrix CRM -> Още -> CRM форми):
Изберете нужната форма и щракнете върху „Редактирай“. Най-долу щракнете върху „Допълнително“.
Превъртете до раздела „Стойности на полетата по подразбиране“.
Изберете нужното поле на лида или сделката (зависи от това дали чрез формата се създава лид или сделка). Щракнете върху „Добави поле“ r7k12id.
В стойността напишете %r7k12id%: