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

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

Заявка успешно создана!
Не рекомендуется закрывать вкладку до решения проблемы, так как письма с ответами иногда попадают в спам!

• Перейдите на страницу модуля и найдите блок «Установить»;
  
• В поле рядом с кнопкой «Установить» введите домен вашего портала Битрикс24 и нажмите кнопку «Установить»;
  
• Примите все соглашения и нажмите "Установить";
• Нажмите кнопку "Начать бесплатную пробную версию" (1) или вставьте свой лицензионный ключ (2), если он у вас есть;
  
• Если вы активировали пробную версию, обязательно введите свой действующий адрес электронной почты, на него мы отправим лицензионный ключ (проверьте спам, если вы его не получили).

Все наши приложения доступны по подписке Битрикс24 Маркет.Плюс. По возможности, мы рекомендуем использовать именно данный способ установки (если у вас нет подписки, купите ее у вашего интегратора или у нас). Активация модуля по подписке доступна только для России, Беларусии и Украины.

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

• Откройте приложение на портале Битрикс24, перейдите на страницу «Лицензия» (1) и выберите нужный период подписки (2).
  
• Перейдите на страницу проверки лицензии — https://flamix.solutions/license/ (1) и введите лицензионный ключ (2), нажмите кнопку «Проверить» (3). Если лицензионный ключ правильный, вы увидите кнопку «Продлить» внизу (4).
  

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

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

Всем, кто покупает годовую подписку, предоставляется скидка 20–25 %. Размер скидки указан на странице «Лицензия» приложения.

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

Примечание! Если у вас уже есть интегратор, мы не сможем снова стать вашим интегратором, даже если вы захотите сменить его.

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

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

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

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

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

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

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

• Откройте приложение и прокрутите вниз;
• Нажмите ссылку "Logs".

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

Кроме того, мы иногда запрашиваем ссылку на логи. Чтобы сгенерировать ее, просто нажмите кнопку "Создать ссылку". Скопируйте и отправьте нам эту ссылку. Ссылка действительна 2 дня.

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

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

Лицензия 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.

UTM-теги - это метки в ссылке, которые помогают узнать, откуда пришел посетитель на ваш сайт.

Обычно эти метки добавляются вручную. Некоторые рекламные системы устанавливают их автоматически, когда человек кликает на рекламу. Но вот если посетитель приходит на ваш сайт не по рекламе, такие метки обычно отсутствуют.

Представьте, что вы заказали рекламный баннер на сайте SITE.COM. Если на баннере указана простая ссылка "https://mysite.com", то при клике по ней на ваш сайт не придут никакие дополнительные данные. Чтобы ваш сайт узнал, что посетитель пришел с SITE.COM, ссылка должна выглядеть так: "https://mysite.com/?utm_source=site.com". Таким образом, ваш сайт увидит эту метку и поймет, что посетитель пришел с сайта SITE.COM.

Данный механизм позволяет динамически устанавливать UTM-теги, определяя источник клика. Давайте рассмотрим два сценария, когда кто-то заходит на ваш сайт из органического трафика:

• Без SmartUTM: Клики из органического поиска Google автоматически не устанавливают UTM-теги, поэтому на вашем сайте не будет отображаться тег "utm_source".
• С SmartUTM: Если кто-то кликает из органического поиска Google, наш плагин определяет источник перехода и автоматически устанавливает на вашем сайте “utm_source=google.com”.

Данная функциональность работает для любого веб-сайта. Помните, что ручная установка UTM имеет приоритет перед динамической. Таким образом, если ссылка уже содержит “utm_source”, Smart UTM её не переопределит.

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

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

• Поиск товара. Нужно для систем учета, типа 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.

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

Плагин по умолчанию передает уникальные идентификаторы посетителя 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 $products, $order_id
• 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 );