Интеграция CRM "Мой Класс" c Битрикс24 двухсторонняя и позволяет:
- создавать в CRM "Мой Класс" клиентов при создании контактов в Битрикс24,
- создавать в CRM "Мой Класс" записи в группы при создании сделок в Битрикс24,
- создавать в Битрикс24 контакты при создании клиентов в CRM "Мой Класс" через виджеты, интеграции или сотрудником,
- создавать в Битрикс24 сделки при создании записей в группы в CRM "Мой Класс" через виджеты, интеграции, кабинет ученика или сотрудником,
- автоматически менять статус записей в группы в CRM "Мой Класс" при смене статусов сделок в Битрикс24 и наоборот.
Синхронизации задач, звонков, сотрудников и комментариев в интеграции не предусмотрено. Виджета в Битрикс24 от "Мой Класс" для осуществления "ручных" операций со сделками и контактами в настоящее время нет. Создание сделок, записей и контактов в обеих системах осуществляется только автоматически по указанным событиям.
Синхронизируются только контакты и сделки - лиды из Битрикс24 не сихронизируются. Для синхронизации лид в Битрикс24 необходимо конвертировать в контакт/сделку.
Интеграция состоит из двух шагов:
шаг 1. Создание интеграции в CRM “Мой Класс”,
шаг 2. Настройка интеграции в CRM “Мой Класс”:
- установка соответствия между признаками контактов,
- действия в Битрикс24 при событиях в "Мой Класс",
- действия в "Мой Класс" при событиях в Битрикс24,
- механизм синхронизации записей, сделок и контактов.
ВАЖНО! Подключить интеграцию можно только с аккаунтом Битрикс24 на платном тарифе.
Шаг 1. Создание интеграции в CRM "Мой Класс"
Перейдите в раздел CRM "Мой Класс" "Настройки - Интеграции". Нажмите "+ Интеграция":
В селекторе "Выберите сервис" выберите "Битрикс24":
В поле "Полный адрес вебхука" необходимо указать ссылку входящего вебхука (см. ниже).
Например, “https://b24-ncu3kx.bitrix24.ru/rest/9/g5h9qg8jr9z7q2kr/profile/”:
Для этого откройте Битрикс24 и перейдите в раздел “Приложения”, во вкладку “Разработчикам”:
Откройте подраздел “Другое”:
Затем добавьте входящий вебхук:
В окне добавления вебхука скопируйте ссылку вебхука. Она понадобится дальше.
В поле “Настройка прав” добавьте “CRM”. Нажмите на кнопку “Сохранить” и затем на “Закрыть”:
Вернитесь на страницу добавления интеграции в CRM “Мой Класс” и вставьте ранее скопированную ссылку в поле "Полный адрес вебхука".
Нажмите "Проверить". Если все сделано верно, рядом с кнопкой появится зеленая галочка:
Если что-то не так, то красный крестик:
В этом случае проверьте, что поле заполнено верно.
Нажмите кнопку "Добавить".
После того, как вы добавите интеграцию, у вас сразу же откроется окно редактирования этой интеграции. Это сделано потому, что для дальнейшей настройки и сопоставления полей системе нужно получить данные от Битрик24 - они могут быть получены только после ввода ссылки вебхука и фактически добавления интеграции.
В окне редактирования интеграции скопируйте следующую ссылку:
Теперь в Битрикс24 следует добавить четыре исходящих вебхука. Для этого в том же подразделе “Другое” нажмите “Исходящий вебхук”:
В поле “URL вашего обработчика” необходимо вставить скопированную ранее ссылку из окна настройки интеграции в CRM “Мой Класс”:
В поле "Токен приложения" никакие изменения вносить не надо.
В поле “События” выберите “Создание контакта (ONCRMCONTACTADD)”. Затем нажмите “Сохранить” и “Закрыть”:
Далее добавьте второй исходящий вебхук. В поле “URL вашего обработчика” вставьте ту же ссылку, скопированную ранее, а в поле “События” выберите “Создание сделки (ONCRMDEALADD)”, нажмите “Сохранить” и “Закрыть”:
Затем добавьте третий исходящий вебхук. В поле “URL вашего обработчика” вставьте ту же ссылку, скопированную ранее, а в блоке “События” выберите “Обновление контакта (ONCRMCONTACTUPDATE)”, нажмите “Сохранить” и “Закрыть”:
Наконец добавьте четвертый исходящий вебхук. В поле “URL вашего обработчика” вставьте ту же ссылку, скопированную ранее, а в блоке “События” выберите “Обновление сделки (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.
ВАЖНО! Просто так базы данных друг с другом не синхронизируются.