Активация модуля по подписке доступна только для России и Украины.

• Убедитесь что у вас не установлена платная версия плагина. Если платная версия плагина установлена, ее необходимо удалить;
• Убедитесь, что у вас активирована подписка на Маркет+. Если не активирована, включите демо-режим или купите подписку;
• На странице приложения (в Битрикс24.Маркете или на сайте flamix.solutions) нажмите соответствующую кнопку (*.bitrix.ru - РФ, *.bitrix.ua - Украина);
• На странице приложения Битрикс24.Маркета нажмите кнопку "Установить".

Обратите внимание! Перед установкой платной версии модуля, необходимо удалить версию модуля по подписке (если ранее она была установлена).

• На сайте flamix.solutions найти необходимый модуль, перейти на блок "Варианты покупки";
• В блоке "Покупка" ввести домен Битрикс24 портала;
• В портале нажать кнопку "Установить", согласится со всеми условиями;
• Активировать демо-период или ввести лицензионный ключ.

Каждый модуль имеет бесплатный тестовый период, который можно активировать при установке приложения или в биллинг-кабинете.

Активация при установке

• При установке модуля, на странице ввода лицензионного ключа для модуля, нажмите кнопку "Активировать демо-период";
• Во сплывающем окне введите свою почту, на которую прийдет ключ. Если вы активируете первый раз, ввод пароля не требуется, система автоматически вас зарегистрирует и пришлет пароль на почту. Если вы являетесь нашим клиентом или ранее уже активировали модулю на вашу почту, система попросит ввести дополнительно пароль. Если пароля у вас нет, восстановите его - https://cp.flamix.solutions/index.php?forgot_password=yes
• Процесс активации закончен!

Обратите внимание! Активировать демо-период на одно приложение можно только 3 раза. На 4й раз система полностью заблокирует модуль с привязкой к порталу.

Активация в биллинг-кабинете

• Перейдите в биллинг кабинет https://cp.flamix.solutions/ и войдите в свою учетную запись или создайте новую;
• Перейдите в раздел Услуги, Лицензии и нажмите "Купить";
• Выберите нужный модуль и оформите демо-период. Обращаем внимание, купить модуль без демо-перода нельзя;
• При установке модуля, в поле запроса лицензионного ключа модуля, введите ключ, который получили на предыдущем шаге.

Чтобы написать в поддержку (добавить тикет) необходимо:

• Перейти на портал https://cp.flamix.solutions/
• Ввести почту и пароль. Если вы ранее не регистрировались, нужно зарегистрироваться. Если при попытке регистрации, система пишет что пользователь найден, необходимо сбросить пароль;
• После успешной авторизации, нажмите на пункт меню "Поддержка", затем кнопку "Добавить";
• Подробно опишите ошибку, приложите скриншоты и нажмите кнопку "Отправить".

Продлили лицензию, а срок не сдвинулся? Лицензионный ключ кэшируется при покупке и сбрасывается только при автоматическом продлении. Если по какой-то причине, он не продлился, попробуйте скинуть кэш лицензии в биллинге (Лицензии отображаются на странице Услуги->Лицензии) и обновить страницу "Лицензия" в модуле.

Если это не помогло, напишите в поддержку.

Лицензия Enterprise требуется в следующих случаях:

• У вас регулярно больше 500 обращений к плагину в день;
• Нужна модификация Битрикс24 плагина под вас;
• Вы просто хотите, чтобы все проходило через вас.

Реализация

• Подписываем NDA и договора на обслуживание;
• Выделяем для вас отдельный VPS;
• Настраиваем окружения, развертываем репозиторий с плагином (если нужна будет поддержка и обновления);
• Присылаем отдельные сборки плагинов для CMS или сами настраиваем интеграцию;
• Организовываем мониторинг и поддержку 24/7.

По вопросам приобретения пишите любым удобным способом.

Важно! Мы не передаем код заказчику.

Для интеграции нужно установить два модуля: модуль на Битрикс24 и модуль на сайт.

Установка модуля на Битрикс24 доступна в двух вариантах: по подписке и без подписки с помесячной оплатой.

Модули на сайт доступны бесплатно в неограниченном количестве.

После установки плагина на Битрикс24 и на сайте, необходимо их соединить между собой. Для этого, в Битрикс24 на странице интеграция копируем секретный токен интеграции и вставляем его в соответсвующее поле на сайте. Также на сайте вводим домен портала Битрикс24. Если все сделано верно - модуль отобразит успешный статус интеграции.

После, необходимо отправить все уникальные формы с сайта. Например, если у вас на сайте 100 страниц, а форм всего две - обратный звонок и заказ, то нужно отправить всего две формы с любых страниц. После этого, плагин на Битрикс24 узнает, какие поля доступны для интеграции.

Как только на странице интеграции появятся все поля, необходимо проставить соответствия полей на сайта и полей в CRM.

Интеграция закончена! Если на сайте через какое-то время добавится новое поле, оно станет доступно для интеграции после первой отправки формы с новым полем.

Плагин поддерживает синхронизацию статуса заказа в обе стороны: при изменении статуса ЛИДа или Сделки на сайте, статус может измениться в CRM, а при изменении статуса в CRM - статус смениться на сайте.

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

• Связать плагин сайта и Битрикс24;
• В Битрикс24 создать поле типа "Строка" и назвать "Номер заказа site.com". ВАЖНО, см. ниже.
• На сайте создать тестовый заказ и поочередно сменить там статусы заказа (можно все, можно только те, которые будут синхронизированы).
• В Битрикс24 перейти на страницу "Синхронизация статусов", выбрать нужный сайт (плагин поддерживает подключение нескольких сайтов), выбрать поля, где храним номер заказа (в нашем случае, "Номер заказа site.com".) и расставить соответствие статусов на сайте и Битрикс24.
• Проверить работу. При смене статуса на сайте или Битрикс24, вы увидите информационное сообщение в ленте ЛИДа или Сделки. 

Важно! Перед интеграцией, прочтите все пункты.

• Каждый сайт должен хранить номер заказа в уникальному поле. Например, если у вас два сайта site.com и site.net, то создайте два поля "Номер заказа site.com" и "Номер заказа site.net".
• Поля для хранения номера заказа создавайте только в ЛИДе! Если вы используете сделке, то все равно создайте поле в ЛИДе и сконвертируйте его в Сделку. При конвертации Битрикс24 создаст связанное поле. Иначе заказ из сайта не будет правильно передаваться в Сделку.
• Один статус на сайте = Один статус в CRM.

В этой инструкции мы расскажем как сделать простую отладку плагина интеграции.

1. Если вы хотите проверить данные, вам нужно перейти в нижний левый угол и перейти по ссылке “Logs”.

2. Скопируйте все содержимое как на скриншоте.

3. Перейдите на сайт - http://json.parser.online.fr/ и вставьте скопированное содержимое в левое поле.

4. В правой части экрана мы увидим данные сайтов (идентификатор заказа, цена доставки, продукты, валюту и другое).

5. Если вы не видите этих данных, убедитесь что плагин работает правильно.

Плагин умеет передавать товар в ЛИД и Сделку. Эта интеграция работает по умолчанию и никаких дополнительных настроек не требует.

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

• Поиск товара. Нужно для систем учета, типа 1С, и корректного учета остатков. Например, если пользователь купил товар с артикулом 007, в настройках плагина на CMS вы можете указать, что артикул в Битрикс24 хранится в поле PROPERTY_105. После этого, когда пользователь оформляет заказ, плагин не просто добавит товар в ЛИД или Сделку, а и привяжет тот товар, в которого PROPERTY_105 равно 007.
• Имя товара из Битрикс24. Например, пользователь покупает товар с артикулом 007. На сайте у вас название "Розовый утюг для женщин филипс купить", а в Битрикс24 товар с артикулом 007 называется "007 Philips RX-98830 Rose". То при включении данной опции, название товара в сделке будет "007 Philips RX-98830 Rose".
• Цена товара из Битрикс24. Алгоритм работы идентичный поиску по имени, только будет обновлена цена, которая указана в Битрикс24.

Если необходимо доработать или изменить логику.

Все наши плагины к CMS и SDK разработаны с учетом умного отслеживания и передачи UTM-меток. Если пользователь перешел на сайт по UTM-метке, то мы сохраняем ее в Cookie браузера на 90 дней (все происходит на Back-end стороне, поэтому любой бан со стороны Facebook исключен). При отправке запроса или заказа, мы считываем Cookie и передаем их. Таким образом, если человек переходит по страницах, мы всегда помним его первоисточник.

Особенность. Если пользователь переходит с сайта, например google.com без указания UTM-метки, то мы автоматически создаем UTM-метку google_com и передаем ее. Таким образом, вы сможете точно знать, откуда пришел клиент, даже если нет UTM-меток.

Плагин по умолчанию передает уникальные идентификаторы посетителя Google Client ID, Facebook Pixel ID и Яндекс.Метрика ID. Данные поля передаются в поле с кодом (не путать с названием) UF_CRM_FX_CONVERSION.

Варианты создания данного поля:

• Установить наш плагин по отправке конверсии и создать одну цель. При создании цели, плагин сам создаст поле UF_CRM_FX_CONVERSION . Если плагин в дальнейшем вам не нужен, просто удалите;
• Используя веб-хуки - обратитесь к вашему интегратору, или к нам (Стоимость данной работы у нас $20);

Обратите внимание! Данные идентификаторы передаются в том случае, если на сайте установлены счетчики аналитики. Например, если у вас стоит счетчик Google Analytics, то в поле UF_CRM_FX_CONVERSION попадет только Google Client ID.

Если у Вас есть несколько направлений на сайте, есть возможность настроить попадание Сделки в разные воронки (направления) с помощью бизнес-процесса или робота. Алгоритм решения в обеих случаях одинаковый, поэтому рассмотрим пример с роботом, т.к. они проще и поддерживаются младшими тарифами.

В ЛИДе или Сделке (в зависимости от того, где будет срабатывать робот) создаем текстовое поле "Домен сайта". В настройках плагина, выбираем соответствие Домен сайта = HOSTNAME, где HOSTNAME - стандартное поле, в котором приходит доменное имя.

Переходим в CRM, выбираем нужную сущность (ЛИД или Сделка), добавляем робота, который будет срабатывать, если поле "Домен сайта" содержит нужный нам домен. Данный робот будет менять стадию Сделки только тех заявок, которые поступили с нужного нам сайта. Варианты

• Если работаете с ЛИДами. На первой стадии создайте робота для конвертации в Сделку, где выберете нужное направления и стадию.
  
• Если работаете только со Сделками. То же самое, только робот называется "Сменить направление". Важно - Поле должно передаваться из ЛИДа, поэтому поле создавайте именно там!
  

Важно знать.

• Создавайте поле в ЛИДе, даже если вы пользуетесь Сделками. При конвертации ЛИДа в Сделку, Битрикс24 сам создаст нужное поле и автоматически будет передавать значение.
• Бизнес-процессы запускаются раньше роботов и содержат расширенный функционал.

Один плагин на Битрикс24 поддерживает неограниченное количество сайтов.

Единственное, нужно понимать, что плагины не совместимы между собой. Например, если у вас есть 2 сайта на WordPress и 4 сайтов на OpenCart, то вам необходимо установить 2 модуля - WordPress Contact Forms 7 и OpenCart. А если у вас 2 сайта на WordPress и 4 самописные, то нужно всего один плагин на Битрикс24, поскольку самописные подключатся к любому плагину.

Иногда бывает так, что стандартная работа плагина не подходит под ваши задачи. Поэтому, любой CMS плагин можно адаптировать/дописать/переписать. У нас есть единое API (фактически, это один запрос) и SDK для PHP (набор готовых функций).

• API - после установки плагина на Битрикс24, открываем плагин и переходим на страницу "Интеграция";
• SDK - https://github.com/FLAMIXSOFTWARE/b24-lead

Важно!
Учитывайте, что каждый плагин интеграции имеет свой модификатор (URL), который указан на странице "Интеграция" в самом плагине.

Если у вас нет программистов, которые смогут помочь модифицировать плагин, обращайтесь к нам.

В плагине доступно несколько способов добавления дополнительных полей. Рассмотрим пример добавления кастомных полей на WordPress. Остальные CMS имеют аналогичный функционал (название фильтров или хуков ищите в документации плагина для нужной CMS). Данна инструкция предназначена для веб-мастеров.

Универсальный способ

Данный способ хорош тем, что он построен на базе SDK и не имеет привязки к CMS и применяется при любой отправки. Для примера, давайте рассмотрим задачу, где при отправке любой формы или заказа нужно всегда добавлять HTTP_REFERER, SITE_DOMAIN и Google Client ID без GA. Минус этого способа - он отрабатывает до момента получения всех полей, т.е. фактически вы не будуте знать какие поля у вас передаются. Если это WordPress, то первой и стабильной точкой входа любого файла есть functions.php. Для решения этой задачи добавляем такой код в файл functions.php:

try {
	$flamix_extra_fields = [
		'HTTP_REFERER' => $_SERVER['HTTP_REFERER'] ?? '',
                'SITE_DOMAIN' => 'mysite.com',
	];

	$cookie_ids = \Flamix\Conversions\Conversion::getFromCookie();
	if(!empty($cookie_ids) && isset($cookie_ids['_ga']))
		$flamix_extra_fields['google_client_id'] = preg_replace('/GA[0-9].[0-9]./', '', $cookie_ids['_ga']);

    \Flamix\Bitrix24\Lead::getInstance()->setExtraFields($flamix_extra_fields);
    unset($cookie_ids, $flamix_extra_fields);
} catch (\Exception $e) {
    //$e->getMessage();
}

Фильтры WordPress

При необходимости изменять поля заявки или товары используя созданные ранее поля (например, номер заказ, имя клиента и т.д.) необходимо воспользоваться фильтрами. Фильтры размещаем в файле functions.php. Доступные такие фильтра:

• flamix_bitrix24_integrations_fields_filter $fields
• flamix_bitrix24_integrations_product_filter $order_id, $products
• flamix_bitrix24_integrations_filter $data

Обратите внимание! Фильтры универсальные для всех WordPress плагинов! Это значит, что если вы будете менять поля с помощью flamix_bitrix24_integrations_fields_filter, то фильтр будет применен как для модуля WooCommerce, так и для Contact Form 7 или Ninja Form. Данное ограничение обязывает вас не быть на 100% уверенным что некоторые из входящих параметром точно будут. Например, ORDER_ID будет только в WooCommerce. Пример реализации задачи добавления название для Лида с нужной информацией:

function flamix_bitrix24_integrations_fields_example_callback($fields) {
    if(isset($fields['ORDER_ID']) && $fields['ORDER_ID'] > 0)
        $fields['MY_BITRIX24_LEAD_TITLE'] = 'Order #' . ($fields['ORDER_ID'] ?? 0) . ' from wp.app.flamix.solutions at ' . ($fields['DATE'] ?? date('Y-m-d H:m:s'));
    else 
        $fields['MY_BITRIX24_LEAD_TITLE'] = 'Request from wp.app.flamix.solutions at ' . ($fields['DATE'] ?? date('Y-m-d H:m:s'));

        return $fields;
}
add_filter( 'flamix_bitrix24_integrations_fields_filter', 'flamix_bitrix24_integrations_fields_example_callback', 10, 3 );