Битрикс24

Интеграция CRM "Мой Класс" c Битрикс24 двухсторонняя и позволяет:
- создавать в CRM "Мой Класс" клиентов при создании контактов в Битрикс24,
- создавать в CRM "Мой Класс" записи в группы при создании сделок в Битрикс24,
- создавать в Битрикс24 контакты при создании клиентов в CRM "Мой Класс" через виджеты, интеграции или сотрудником,
- создавать в Битрикс24 сделки при создании записей в группы в CRM "Мой Класс" через виджеты, интеграции, кабинет ученика или сотрудником,
- автоматически менять статус записей в группы в CRM "Мой Класс" при смене статусов сделок в Битрикс24 и наоборот.

Синхронизации задач, звонков, сотрудников и комментариев в интеграции не предусмотрено. Виджета в Битрикс24 от "Мой Класс" для осуществления "ручных" операций со сделками и контактами в настоящее время нет. Создание сделок, записей и контактов в обеих системах осуществляется только автоматически по указанным событиям.

Синхронизируются только контакты и сделки - лиды из Битрикс24 не сихронизируются. Для синхронизации лид в Битрикс24 необходимо конвертировать в контакт/сделку.

Интеграция состоит из двух шагов:
шаг 1. Создание интеграции в CRM “Мой Класс”,
шаг 2. Настройка интеграции в CRM “Мой Класс”:
- установка соответствия между признаками контактов,
- действия в Битрикс24 при событиях в "Мой Класс",
- действия в "Мой Класс" при событиях в Битрикс24,
- механизм синхронизации записей, сделок и контактов.
 

Шаг 1. Создание интеграции в CRM "Мой Класс"

Перейдите в раздел CRM "Мой Класс" "Настройки - Интеграции". Нажмите "+ Интеграция":

В селекторе "Выберите сервис" выберите "Битрикс24":

В поле "Полный адрес вебхука" необходимо указать ссылку входящего вебхука (см. ниже). 
Например, “https://b24-ncu3kx.bitrix24.ru/rest/9/g5h9qg8jr9z7q2kr/profile/”:

Для этого откройте Битрикс24 и перейдите в раздел “Приложения”, во вкладку “Вебхуки”:

Затем добавьте входящий вебхук:

В окне добавления вебхука достаточно отметить только доступ к “CRM”:

После нажатия на кнопку “Сохранить” появится ссылка вебхука, которую необходимо скопировать и вставить в окно создания интеграции с Битрикс24 в CRM “Мой Класс”:

Нажмите "Проверить". Если все сделано верно, рядом с кнопкой появится зеленая галочка:

Если что-то не так, то красный крестик:

В этом случае проверьте, что поле заполнено верно.

Нажмите кнопку "Добавить".

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

В окне редактирования интеграции скопируйте следующую ссылку:

Теперь в Битрикс24 следует добавить четыре исходящих вебхука. Для этого в той же вкладке “Вебхуки” нажмите “Добавить вебхук” – “Исходящий вебхук”:

В поле “Адрес обработчика” необходимо вставить скопированную ранее ссылку из окна настройки интеграции в CRM “Мой Класс”:

В блоке “CRM” выберите “Создание контакта (ONCRMCONTACTADD)” и нажмите “Сохранить”:

Далее добавьте второй исходящий вебхук. В поле “Адрес обработчика” вставьте ту же ссылку, скопированную ранее, а в блоке “CRM” выберите “Создание сделки (ONCRMDEALADD)” и нажмите “Сохранить”:

Затем добавьте третий исходящий вебхук. В поле “Адрес обработчика” вставьте ту же ссылку, скопированную ранее, а в блоке “CRM” выберите “Обновление контакта (ONCRMCONTACTUPDATE)” и нажмите “Сохранить”:

Наконец добавьте четвертый исходящий вебхук. В поле “Адрес обработчика” вставьте ту же ссылку, скопированную ранее, а в блоке “CRM” выберите “Обновление сделки (ONCRMDEALUPDATE)” и нажмите “Сохранить”:

В итоге у вас должно получиться 5 вебхуков – 4 исходящих и 1 входящий:

Шаг 2. Настройка интеграции в CRM "Мой Класс"

Для начала установите соответствие между признаками контакта в CRM “Мой Класс” и Битрикс24:

ВАЖНО! В списке выводятся все признаки клиента, которые включены в разделе CRM "Мой Класс" - "Настройки - Заявки/клиенты - Признаки клиента".

Далее вы можете выбрать, какая информация будет передаваться в примечание к записи в группу при создании сделки в Битрикс24.

Если это группа с формой оплаты “Единой суммой/в рассрочку”, вы можете выбрать какой параметр Битрикс24 будет соответствовать цене записи ученика в группу.

ВАЖНО! Этот пункт выполняется, если включено создание записи в группу при добавлении сделки.

Затем установите соответствие между источниками в CRM “Мой Класс” и Битрикс24:

Для записи учеников в разные группы при создании сделок вы можете использовать поля сделок с типом “Список” (не множественное):

Например, создадим в Битрикс24 поле для сделок с типом “Список” (не множественное):

Теперь мы можем установить соответствие между группами в CRM “Мой Класс” и вариантами выбора из созданного поля:

Таким образом при создании сделки в Битрикс24, вы сможете выбрать группу, в которую будет создана запись уже в нашей CRM “Мой Класс”.

ВАЖНО! Этот пункт выполняется, если включено создание записи в группу при добавлении сделки.

Дальше выберите воронку продаж Битрикс24 и установите соответствие между статусами записей в CRM “Мой Класс” и статусами сделок в Битрикс24:

Действия в Битрикс24 при событиях в "Мой Класс"

Теперь укажите, какие действия в Битрикс24 будут выполняться при событиях в CRM “Мой Класс”:
- создавать контакт при создании контакта сотрудником,
- создавать сделку при создании записи в группу сотрудником,
- создавать контакт при получении заявки из виджетов,
- создавать сделку при получении заявки из виджетов (в настройках виджетов необходимо дополнительно указать данную интеграцию),
- создавать контакт при получении заявки из Личного кабинета ученика,
- создавать сделку при получении заявки из Личного кабинета ученика,
- создавать контакт при получении заявки из интеграций (если создан контакт в "Мой Класс"),
- создавать сделку при получении заявки из интеграций (если создана запись в группу в "Мой Класс").
- менять статус сделки, если у записи ученика в группу сменился статус.

ОЧЕНЬ ВАЖНО! В интеграции учитываются только сделки и контакты в Битрикс24. Лиды оттуда не синхронизируются, т.к. лид в Битрикс24 является отдельной сущностью, которой нет соответствия в нашей CRM (лидами в нашей системе являются "контакты" в определенных статусах). Для синхронизации лид в Битрикс24 необходимо конвертировать в контакт/сделку.

О механизме синхронизации записей, сделок и контактов читайте ниже.

Интеграция Битрикс24 для виджетов

Для виджетов интеграцию с Битрикс24 необходимо добавить в разделе "Для сайта", выбрав нужный виджет и нажав на его редактирование.

ВАЖНО! Не указывайте в одном виджете несколько разных интеграций с Битрикс24 - указывайте только одну. Это поможет избежать ситуаций с невозможностью создать контакт по второй интеграции, когда контакт уже будет создан по первой.

Действия в "Мой Класс" при событиях в Битрикс24

И наконец, в блоке окна интеграции “Действия в "Мой Класс" при событиях в Битрикс” вы можете выбрать, что будет происходить в нашей системе при событиях в Битрикс24:
- создавать контакт при создании контакта,
- создавать запись в группу при добавлении сделки,
- создавать контакт, если сделка стала успешно реализованной,
- создавать запись в группу, если сделка стала успешно реализованной,
- менять статус записи в группу у ученика, если у сделки сменился статус.

ВАЖНО! В интеграции учитываются только сделки и контакты в Битрикс24. Лиды оттуда не синхронизируются.

О механизме синхронизации записей, сделок и контактов читайте ниже.

ВАЖНО! Если вам необходимо, чтобы при создании сделок в Битрикс24 создавались записи только в одну определенную группу в нашей системе, то отключите параметр “Разносить сделки по разным группам в "Мой Класс" (если включено их создание)”. После отключения этого параметра появится поле для выбора группы.
 

Механизм синхронизации записей и сделок

Когда запись в "Мой Класс" создается при действиях в Битрикс24, ей внутри в системе "Мой Класс" присваивается "маркер" - внутренний номер из Битрикс24. Когда происходят изменения сделки в битрикс, битрикс отправляет запрос в "Мой Класс", мы находим запись с таким же маркером (номером из битрикс) и осуществляем ее изменение. 

ВАЖНО! Это означает, что если вы удалили такую запись ученика в группу в "Мой Класс", затем там же ее создали - точно такую же, с тем же учеником, - то синхронизация нарушится, т.к. это будет уже новая запись, в параметрах которой номера сделки из Битрикс24 не будет. 

Номер присваивается автоматически, указать его вручную нельзя.

Аналогично номер присваивается, когда в Битрикс24 создается сделка по событию в "Мой Класс" - наша CRM с такого момента "знает", какой записи соответствует сделка в битрикс. Если вы удалите сделку в битрикс и создадите там такую же, но новую, синхронизация нарушится.

То же самое происходит и с контактами - им тоже ставятся в соответствие друг другу номера, но только после события создания, т.е. когда контакт в "Мой Класс" создан по событию в Битрикс24 или когда контакт в Битрикс24 создан по событию в "Мой Класс". При этом необязательно, чтобы, например, создание контакта в Битрикс24 было по событию создания контакта в "Мой Класс" - контакт и сделка в битрикс могут быть созданы по событию создания записи в группу в CRM "Мой Класс". И наоборот, например, когда создали сделку в Битрикс24 и в ней указали новый контакт - в "Мой Класс" создался контакт и запись в группу, синхронизированные со сделкой и контактом в Битрикс24.

ВАЖНО! Просто так базы данных друг с другом не синхронизируются.