Интеграция MODX-сайта с CRM Битрикс24

Веб-студия МедиаСпектр предлагает интеграцию вашего сайта на системе управления MODX Revo с CRM-системой Битрикс24.

Являясь партнёром Битрикс24 мы предлагаем развертывание и поддержку коробочных и облачных порталов, переезд из облака в коробку а также приобретение лицензий. По всем вопросам обращайтесь: info@rams.pro

Для интеграции сайта с CRM мы разработали и поддерживаем компонент-модуль для MODX

MODX-компонент собственной разработки

Назначение компонента b24leads от РАМС

Компонент отправляет все заявки, оставленные в формах на сайте в CRM-систему Битрикс24. Создаются «лиды», если настроен «Упрощенный режим CRM» в Битрикс24, то лиды автоматически конвертируются в «сделки».

Проверка дубликатов контактов. Функция, которой нет у аналогов на момент выпуска компонента: при создании заявки проверяется существование контакта по телефону и email клиента. Если совпадение найдено — к сделке прикрепляется существующий в Битрикс24 контакт без создания дубликата. Если найдено несколько совпадений, привяжется первый найденный контакт. Важно: не перезаписывает контакты у существующих клиентов при повторных заявках, но обогащает их: если в первый раз клиент указал только 1 контакт (телефон например) и потом прислал вторую заявку, в которой снова указал тот же телефон, имя и еще почту, то по телефону компонент найдет контакт, имя не перезапишет, но добавит к нему почту, раз её раньше не было. Если в третьей заявке клиент напишет тот же телефон, но другую почту (или ту же почту, но другой телефон), то компонент не затронет карточку контакта. В любом случае, переданные в каждой заявке контакты добавляет в текст комментария к лиду/сделке и менеджер может вручную сравнить их с карточной контакта.

Проверка дубликатов сделок. При создании новой сделки проверяется существование открытых сделок в нужных категориях (воронках), если таковые найдены - не создаем новую сделку, а у найденных сделок передвигаем стадию согласно настройке ++bitrix24_check_deal_category (с версии 2.5.0). Это позволяет вернуть например зависшую сделку в стадию, из которой менеджеры разбирают их в работу.

Интеграция с сервисом записи звонков. Изменение имени контакта, если он был добавлен сервисом записи звонков по шаблону ("+xxxxxxxxxx - Пропущен", "+xxxxxxxxxx - Отвечен") (с версии 2.2.10)

Поддержка глубокой веб-аналитики для маркетинга. Поля из форм, попадающие под настройку ++bitrix24_analytics_fields передаются в Битрикс24. Дополнительно передается trace wamseo.analytics.client_b24 (с версии 2.3.0). При установленном компоненте wamseo в лид/сделку Б24 попадут также ClientID из всех подключенных рекламных/аналит. систем для составления аудиторий ретаргетинга, отчетов и склейки визитов.

Интеграция с всплывающими онлайн-консультантами. 

1. Venyoo (v1.0.10) Если на сайте установлен активный онлайн-консультант — заявки с него принимаются на стороне сайта, сохраняются в общую таблицу заявок в formit и тоже отправляются в Битрикс24 используя общие настройки компонента.
2. TalkMe (v 2.2.0) — поддерживается создание лидов/сделок при отправке в оффлайн-форму (когда оператор не онлайн)
3. Возможность расширения списка поддерживаемых консультантов (идеально, если у сервиса есть поддержка вебхуков).

Другие особенности компонента

• Не тормозит отправку формы для клиента (все задания складываются в очередь и разбираются оттуда асинхронно)
• Поддерживается не только облачные порталы Битрикс24, но и коробочные.
• При должной настройке прямо в сделке CRM будет виден список визитов и посещенных клиентом страниц сайта:  также подобный функционал можно получить через счетчик Яндекс.Метрики используя ClientID: 

Как начать пользоваться?

1. Скачать и установить компонент на сайт (обращайтесь: info@rams.pro)
2. Создать входящий webhook в Битрикс24 ([b24portal-addr]/marketplace/hook/) и указать ему галочкой доступ к «CRM».
3. Выставить системные настройки в modx
   1. Указать ссылку на созданный хук. Формат указания системной настройки-ссылки на хук: https://[b24portal-addr]/rest/1/up9o-token-hxi5/.
   2. Указать ID пользователя, которому назначаются лиды
   3. Указать ID источника лида (обычно WEB). 
4. Создать задачу в Планировщике задач в панели управления сервером (зависит от хостинга), в которой вызывать скрипт: assets/components/scheduler/run.php каждую минуту.
   Например, на хостинге МедиаСпектр задача выглядит следующим образом: 
   /usr/bin/php /home/dev/data/www/domain.ru/assets/components/scheduler/run.php
5. В вызове сниппета FrontForms указать в стандартных хуках добавить crmleadsFormIt и crmleadsVenyoo (по необходимости) либо добавлять каждый раз при вызове formbuilder в шаблонах, чанках (footer)
6. В настройках venyoo отключить прямую интеграцию с Bitrix24 и включить интеграцию по Webhook, указав url, например https://[site-addr].com/servicesection/venyoowebhook​ (страница должны быть опубликована и доступна без авторизации)
   
7. Обязательно провести тесты. После этого все заявки через venyoo будут пропущены через магию компонента!

Доступные настройки

Настройки задаются в разделе «Системные настройки»,  в namespace b24leads

1. Функциональные
   1. ++bitrix24_assigned_id — id пользователя Битрикс24, который будет назначен ответственным по заявке. Получить можно из ссылки на пользователя [b24portal-addr]/company/personal/user/13/ → 13)
   2. ++bitrix24_source_id — Идентификатор источника (канала связи, не сквозной аналитики!) из справочника Битрикс24 (например, «WEB», стандартный источник Веб-сайт в Б24). Значение можно подсмотреть прямо в select-е в сделке:  или получить справочник по ссылке [b24portal-addr]/rest/1/ВашВебХук/crm.status.list/ либо генератором [b24portal-addr]/devops/edit/in-hook/5/  (получишь юникод, можно сконвертировать здесь и там всё равно надо поиском по сроке "ENTITY_ID":"SOURCE","STATUS_ID":" находить такие куски:  )
   3. ++bitrix24_more_fields (v2.2.6+) — перечисление через запятую ID полей из Б24, которые в сниппете B24LeadsCustomFields нужно сформировать из полей формы
   4. ++bitrix24_entity_type — какую сущность создавать при отправке заявки (по умолчанию задано lead) - возможные значения lead и deal (лид или сделка)
   5. ++bitrix24_analytics_fields (v2.3.0+) — JSON-массив - имена полей формы и идентификатор поля в Битрикс24 (для работы с  wamseo.analytics)
   6. ++bitrix24_check_deal_category (v2.5.0+) — какие категорию (воронку) сделок проверять на существование незакрытых сделок, и в какую стадию переводить найденные. См. формат записи ниже!
2. Служебные
   1. ++bitrix24_hook_url — адрес webhook-а Битрикс24, который создается пользователем, у которого есть права. Все объекты создаваемые через этот веб-хук будут созданы этим пользователем.
   2. ++bitrix24_analytics_fields — JSON-массив с именами полей формы и идентификатор поля в Битрикс24. Важно: нужно указывать ID полей от сущности, которая указана в настройке ++bitrix24_entity_type

Если хотя бы одна настройка не задана, лиды не будут отправляться в Битрикс24.

Формат записи для ++bitrix24_check_deal_category:
[{ "CATEGORY_ID":"0", "CATEGORY_NAME":"Продажа", "STAGE_ID":"7", "STAGE_NAME":"Готово к обработке" },{ "CATEGORY_ID":"14", "CATEGORY_NAME":"Без ответа 14 дней", "STAGE_ID":"С14:11", "STAGE_NAME":"Готово к обработке" }]

Настройка отправки client id для сквозной аналитики

Необходим wamseo версии 1.13.2 и выше (и formit-хук WamseoCollectSessionFormit)

Нужно создать пользовательские поля и в лидах и в сделках c одинаковым названием (чтобы при конвертации значения передавались из лида в сделку):

1. Google Client ID
2. Matomo Client ID
3. Mailru Client ID
4. Yandex Client ID
5. Facebook Client ID

Доступ к настройкам:

• [b24portal-addr]/crm/configs/fields/CRM_DEAL/
• [b24portal-addr]/crm/configs/fields/CRM_LEAD/

Скопировать ID поля можно из адресной строки:

Доступные сниппеты

1. B24LeadsSendFormit (до версии 2.0 crmleadsFormIt) — хук для FormIt, его необходимо указать в вызове FormIt, AjaxFrom или FrontForms (бывший FormBuilder), для того чтобы отправлять заявки в Битрикс24. Если вам нужны разные сообщения или заголовки лидов в зависимости от формы, то необходимо делать изменения в данном сниппете.
2. B24LeadsCustomFields — хук для FormIt, его необходимо указать в вызове FormIt, AjaxFrom или FrontForms перед B24LeadsSendFormit, для того чтобы изменять заголовок и комментарий заявки в Битрикс24 в зависимости от того, какая форма отправляется. Сниппет можно изменять, он не перезаписывается при обновлении пакета.
3. !crmleadsVenyoo — сниппет вызывается на странице venyoowebhook, если нужно поменять какие-то параметры — изменяйте сниппет. Страница вебхука по умолчанию: site.name/servicesection/venyoowebhook (начиная с версии 1.0.3) создается автоматически дочерним ресурсом от /servicesection/ при установке пакета. Важно: Если вы поменяете alias страницы, то при обновлении пакета страница со стандартным alias-ом создастся еще раз.

План развития

TBD (всё закрыли вроде, что собирались)

Аналоги и полезные ссылки

• Не-аналог: modB24CRM

  • На момент 2022.07.19 — отсутствует в modstore и не поддерживается

  • UPD 2023.04.25 — есть в modstore, по функционалу контроль дубликатов и сквозную аналитику не предлагает, больше сфоркусирован на работe с заказами интернет-магазина на базе miniShop2

• Не-аналог: msBitrixCatalog

  • совсем для других задач (для сайтов магазинов, а не услуг)