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

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

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

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

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

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

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

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

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

• Откройте приложение и прокрутите вниз;
• Нажмите ссылку "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.

Чтобы наш плагин увидел ваше поле, оно должно быть создано ТОЛЬКО в Лиде. Если вы создадите поле в Лиде, а затем преобразуете Лид в Сделку, то Битрикс24 автоматически создаст поле в Сделке и "свяжет" его с полем в Лиде. Таким образом, наш плагин перенесет информацию в поле Лида, и Битрикс24 создаст Сделку и автоматически перенесет это значение в Сделку. Как это сделать:

1. Перейдите в Настройки CRM, Настройки полей, ЛИД и создайте необходимое поле.

2. Создайте нового Лида через сайт, например, заполнив форму или оформив заказ, и проверьте, как работает наше новое поле.

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

Автоматическое преобразование ЛИДА в Сделку.

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

1. Создайте поле, которое будет служить индикатором того, что этот Лид нужно преобразовать в Сделку. Например, это может быть поле "Номер заказа" или поле "Источник", где указан ваш сайт (1).

2. Создайте нового робота, который будет работать Немедленно (1), если у Лида есть наш индикатор конверсии (2), и создаст Сделку и Контакт* (3) в нужной воронке (4).

3. Создайте нового Лида через сайт, например, заполнив форму или оформив заказ, и проверьте, как работает наша настройка.

Контакт* - Контакт будет создан только если он не найден при создании Лида. Если у вас ранее был этот Контакт в CRM, он будет найден и прикреплен к Лиду (дубликат Контакта не будет создан).

Видео урок: https://youtu.be/mACtqEEAq-I?t=359

Если у вас CRM без Лида, то вам не нужно это делать, Битрикс24 сам преобразует все Лиды в Сделки.

Заказы в нашей системе обычно отправляются моментально. Однако, если по какой-то причине заказ не может быть отправлен сразу, он помещается в очередь на отправку через 1 минуту. Эта очередь обрабатывается либо по расписанию (крон), либо когда пользователь посещает сайт.

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

Рекомендация: Для более надежной и своевременной отправки заказов рекомендуется перенести все на обработку по крону и убедиться, что крон активен. Подробнее о том, как настроить и активировать крон в WordPress, вы можете прочитать в этой статье. 

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), который указан на странице "Интеграция" в самом плагине.

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

Статусы, в отличие от ЛИДов, не имеют гарантии доставки из-за различных технических и логических причин. Обратите внимание! Мы не анализируем, почему вам не дошел статус, поскольку он может не доходить по разным не зависящим от нас причинам. Поэтому внимательно ознакомьтесь с этим описанием, чтобы иметь возможность самостоятельно проверить и исправить ошибки, в случае их обнаружения.

Базовые правила

• 1.1. Включите обмен статусами в настройках плагина.
• 1.2. Статус не может менять сущности и направления. Например, статус не может конвертировать ЛИД в Сделку или менять направления Сделки.
• 1.3. Статус блокируется на 20 минут с привязкой к заказу. Например, если ваш сайт передал, что заказ #2 поменял статус на PAID, потом вы сразу переключили статус на сайте на любой другой, а потом через 10 минут вернули на PAID, то наш плагин блокирует данный запрос как повторный.
• 1.4. Статусы имеют наименьший приоритет очереди, следовательно, они могут исполняться с большой задержкой.
• 1.5. Сущность должна иметь номер заказа в поле, которое указано в настройках плагина.
• 1.6. Ваш сайт должен корректно работать по протоколу https.

Передача статуса с Битрикс24 на Сайт

Битрикс24 сообщает нам об изменении статуса сущности (проблема 2.1). Наш плагин ищет номер заказа в сущности (проблема 1.5), получает из настроек, какой статус нужно установить на сайте, формирует вебхук (который отображается в логах приложения) и отправляет его на сайт (проблема 1.6).
Проблемы и решения:

• 2.1. Наш плагин не получает уведомления об изменении сделки из-за проблем на стороне Битрикс24. Нужно подождать, пока Битрикс24 исправят проблему.
• 2.2. В приложении не отображается вебхук отправки на сайт. Необходимо проверить базовые правила и убедиться, что статус сопоставлен.
• 2.3. Вебхук есть, но статус не меняется. Скопируйте вебхук и откройте его в браузере. Если появится техническая причина, сайт отобразит её. Нужно консультироваться с программистами или заказать у нас разбор вашего кейса.
  
  

Передача статуса с Сайта на Битрикс24

Плагин на сайте по событию смены заказа берет секретные токены авторизации, формирует вебхук и посылает его нашему плагину (Проблема 3.1). Наш плагин проверяет наличие сделки или ЛИДа с таким номером (Проблема 3.2), находит, на какую стадию изменить сущность в Битрикс24, и запускает смену.
Проблемы и решения:

• Неверные настройки интеграции или указан не тот Битрикс24. Если все верно, то в Битрикс24 в логах вы увидите, что плагин получил задание на смену статуса.
• Не находит номер заказа в CRM. Проверьте настройки и поищите сущность вручную через поиск.

Для диагностики вы можете повторить запрос вручную через браузер (везде нужно подставить ваши данные):
https://lead.app.flamix.solutions/api/v1/status/change?DOMAIN=your.bitrix24.com&api_token=secret_token&HOSTNAME=test.com&STATUS=NEW&ORDER_ID=1001

Расследования инцидента. Мы предлагаем услугу расследования инцидента. Наши специалисты проверят все за вас и определят причину проблемы. Если проблема окажется на нашей стороне, мы вернем вам деньги.
Стоимость услуги составляет $99. Заказать можно здесь. Обязательно присылайте доступы к Битрикс24 и вашему сайту.

В плагине доступно несколько способов добавления дополнительных полей. Рассмотрим пример добавления кастомных полей на 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 );