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

• Перейдите на портал 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, но используют на своем сайте совсем другой плагин, например, Интеграцию с Contact Form 7. Аналогично, некоторые пользователи устанавливают плагин Интеграция с формами WordPress в Битрикс24, но при этом на сайте используют интеграцию с WooCommerce.

Решение:

Убедитесь, что установленный в Битрикс24 плагин совпадает с тем, который вы используете на сайте. Если вы интегрируете заказы из WooCommerce, в Битрикс24 и на сайте должен быть установлен плагин интеграции с WooCommerce. Всегда сверяйте название плагина — иконки могут меняться со временем, но название должно точно совпадать.

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

После, необходимо отправить все уникальные формы с сайта. Например, если у вас на сайте 100 страниц, а форм всего две - обратный звонок и заказ, то нужно отправить всего две формы с любых страниц. После этого, плагин на Битрикс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 сам преобразует все Лиды в Сделки.

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

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

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

UTM метки не работаю

UTM-метки могут не передаваться по разным причинам, и это является нормальной частью политики защиты данных пользователей. Основной фактор – это блокировка cookies. Ниже приведены популярные причины:

• Режим инкогнито: Если пользователь заходит на сайт в режиме инкогнито, сохранение UTM-меток может быть заблокировано.
• Браузерный плагин: Установленные расширения в браузере могут скрывать или блокировать UTM-куки.
• Плагин на сайте: На сайте может быть активен плагин, автоматически обрезающий UTM-метки из URL.
• Использование другого браузера или устройства: Если клиент начал сессию в одном браузере, а заказ оформил в другом, метки не передадутся.
• Редиректы: Переход через промежуточные редиректы может привести к потере UTM-меток.
• Истечение срока хранения меток: Если cookies настроены на короткий срок хранения, данные могут быть утеряны.
• VPN или прокси: Использование технологий для защиты приватности, таких как VPN, может блокировать или изменять параметры URL.
• Неверно составленная ссылка: Ошибки при генерации UTM-ссылки могут привести к их некорректной обработке.
• Обрезка URL: Инструменты, автоматически очищающие ссылки, могут удалять параметры UTM.
• Вмешательство рекламной платформы: Некоторые рекламные площадки могут изменять или удалять метки при генерации ссылок.
• Ручное копирование ссылки: Если клиент копирует только основную часть URL без параметров, метки теряются.

Внимание! Мы не рассматриваем кейсы, почему вам не пришли UTM метки. Вы можете это сделать самостоятельно или уточнить у вашего программиста.

Данный механизм позволяет динамически устанавливать 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.

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

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

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

Когда мы добавляем лид в Битрикс24 с сайта, мы используем систему очередей. Очереди - это как линии ожидания, где каждая новая заявка занимает свою позицию в порядке поступления. Рассмотрим конкретные преимущества этого подхода:

• Гарантия обработки каждой заявки. Очереди гарантируют, что каждая заявка, поступившая с вашего сайта, будет 100% обработана. Это предотвращает потерю потенциальных клиентов из-за технических сбоев или перегрузки системы.
• Защита от сбоев Битрикс24. Если Битрикс24 временно не доступен или испытывает сбои, очередь позволяет сохранить все данные. Как только система восстановится, лиды из очереди будут добавлены без потерь.
• Время обработки Лидов. Время обработки одного Лида может занимать до минуты (обычно 6-10 секунд), особенно если в запросе много товаров. Это нормально и является частью процесса тщательной обработки каждого запроса.
• Скорость работы вашего сайта. Процесс добавления ЛИДа не быстрый. Без механизма очередей процесс оформления заказа или формы занимал бы продолжительное время (от 5 до 60 секунд). Очереди предоставляют возможность сократить это время до 0.001 секунды.

Недостатки данного подхода - иногда бывают задержки. Это происходит потому, что количество и продолжительность новых запросов может превышать текущую обработанную способность. Важно понимать, что небольшие задержки – это нормально и не должно вызывать беспокойства. Это просто значит, что ваши запросы находятся в очереди и скоро будут обработаны.

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

Максимальное количество очереди — это 1000 заявок, которые обрабатываются в среднем за 20-40 минут. Если больше, мы получаем уведомления и реагируем на проблему.

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

Иногда заказы могут дублироваться, и это нормальное поведение системы. Когда при добавлении заказа возникает ошибка (например, что-то не так с Битрикс24 или с настройками полей), плагин пытается повторно добавить заказ через заданный вами интервал времени. Из-за этого иногда появляются дубли.

Вы можете отключить повторные попытки в настройках, но тогда есть риск потерять заказ, если с Битрикс24 что-то будет не так. Мы всё же рекомендуем оставить эту функцию включенной, а дублирующие заказы удалять вручную. Отключить вы можете в настройках.

Если же дубли появляются постоянно, стоит проверить настройки интеграции и заглянуть в логи. Найдите ошибку, из-за которой заказы прерываются, и устраните её. Это может быть связано с некорректными полями или временной недоступностью CRM.

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

В ЛИДе или Сделке создаем текстовое поле "Домен сайта". В настройках плагина выбираем соответствие "Домен сайта" = HOSTNAME, где HOSTNAME — стандартное поле, содержащее доменное имя.

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

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

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

Важно знать:

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

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

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

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

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

• 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. Пример реализации задачи добавления название для Лида с нужной информацией: