Самостоятельная интеграция с Битрикс24
Самостоятельная интеграция с Битрикс24
Для настройки интеграции потребуется выполнить ряд настроек в Битрикс24.
Задайте в настройках CARDPR стартовый номер электронных карт.
Данный номер должен быть больше номеров созданных ранее карт в CRM-системе.
1. Создайте в Битрикс24 входящий вебхук, с правами доступа к CRM.
2. Создайте два исходящих вебхука на адрес: https://core.codepr.ru/api/v2/b24
- Создание клиента;
- Обновление клиента.
3. Зайдите в карточку контакта и добавьте поля:
- Ссылка на карту;
- Номер карты;
- Push-сообщение;
- Любые другие поля, информацию из которых хотели бы транслировать на картах, например, скидка, бонус, дата доставки или др.;
4. Создайте поле Выпустить карту с форматом да/нет, готовое поле выглядит как чекбокс. Если поле будет отсутствовать, то при синхронизации будут выпущены карты всем клиентам, которые есть в Битрикс24.
5. Выпишите id всех полей, информацию из которых вы будете транслировать на электронные карты, а также id поля Выпустить карту. Если возникли сложности при получении id полей, обратитесь в поддержку Битрикс24.
Пример списка, который у вас должен получиться:
- Номер телефона UF_CRM_1519682222471;
- Выпустить карту UF_CRM_1757547669887;
- Ссылка на карту UF_CRM_1819752278412;
- Номер карты UF_CRM_1918683322491;
- Push-сообщение UF_CRM_1116389822413;
- Скидка UF_CRM_1671573523996;
- Дата доставки UF_CRM_1519382494762.
6. Перейдите в личный кабинет CARDPR в раздел Интеграция. Если у вас активирован демо-период, то завершите его.
7. Кликните поле CRM-система, в выпадающем списке выберите Битрикс24.
8. В поле Сервер укажите ссылку для входящего вебхука из п.1 в формате:
https://account-name.bitrix24.ru/rest/1/gd762g7gd72g3dd3/profile/
9. Поля Логин, Пароль, ID программы, ID организации оставьте пустыми.
10. Заполните поле Дополнительные параметры.
{
"variables": {
"id_поля_скидка_из_Битрикс24": "discount",
"id_поля_выпустить_карту_из_Битрикс24": "sync",
"id_поля_дата_доставки_из_Битрикс24": "deliverydate"
},
"card": {
"number": "id_поля_номер_карты_из_Битрикс24",
"link": "id_поля_ссылка_на_карту_из_Битрикс24"
},
"formUrl": "ссылка_на_форму_регистрации_новых_карт_из_CARDPR/"
}
При добавлении своих полей, таких как дата доставки, необходимо в CARDPR в разделе Настройки-Переменные создать для этих полей свои переменные, например, deliverydate.
Ссылку на регистрацию карт вы можете скопировать в CARDPR в разделе Выдача карт -> Редактирование формы -> Установка -> Ссылка на форму.
11. Перейдите на вкладку Хуки и внесите в поля ключи для хуков.
12. Нажмите кнопку Сохранить, далее включите интеграцию.
13. Если у вас есть выпущенные карты в личном кабинете CARDPR, перейдите в раздел Клиенты и нажмите кнопку в правом нижнем углу Записать в CRM.
Особенности интеграции:
Задайте в настройках CARDPR стартовый номер электронных карт.
Данный номер должен быть больше номеров созданных ранее карт в CRM-системе.
1. Создайте в Битрикс24 входящий вебхук, с правами доступа к CRM.
2. Создайте два исходящих вебхука на адрес: https://core.codepr.ru/api/v2/b24
- Создание клиента;
- Обновление клиента.
3. Зайдите в карточку контакта и добавьте поля:
- Ссылка на карту;
- Номер карты;
- Push-сообщение;
- Любые другие поля, информацию из которых хотели бы транслировать на картах, например, скидка, бонус, дата доставки или др.;
4. Создайте поле Выпустить карту с форматом да/нет, готовое поле выглядит как чекбокс. Если поле будет отсутствовать, то при синхронизации будут выпущены карты всем клиентам, которые есть в Битрикс24.
5. Выпишите id всех полей, информацию из которых вы будете транслировать на электронные карты, а также id поля Выпустить карту. Если возникли сложности при получении id полей, обратитесь в поддержку Битрикс24.
Пример списка, который у вас должен получиться:
- Номер телефона UF_CRM_1519682222471;
- Выпустить карту UF_CRM_1757547669887;
- Ссылка на карту UF_CRM_1819752278412;
- Номер карты UF_CRM_1918683322491;
- Push-сообщение UF_CRM_1116389822413;
- Скидка UF_CRM_1671573523996;
- Дата доставки UF_CRM_1519382494762.
6. Перейдите в личный кабинет CARDPR в раздел Интеграция. Если у вас активирован демо-период, то завершите его.
7. Кликните поле CRM-система, в выпадающем списке выберите Битрикс24.
8. В поле Сервер укажите ссылку для входящего вебхука из п.1 в формате:
https://account-name.bitrix24.ru/rest/1/gd762g7gd72g3dd3/profile/
9. Поля Логин, Пароль, ID программы, ID организации оставьте пустыми.
10. Заполните поле Дополнительные параметры.
{
"variables": {
"id_поля_скидка_из_Битрикс24": "discount",
"id_поля_выпустить_карту_из_Битрикс24": "sync",
"id_поля_дата_доставки_из_Битрикс24": "deliverydate"
},
"card": {
"number": "id_поля_номер_карты_из_Битрикс24",
"link": "id_поля_ссылка_на_карту_из_Битрикс24"
},
"formUrl": "ссылка_на_форму_регистрации_новых_карт_из_CARDPR/"
}
При добавлении своих полей, таких как дата доставки, необходимо в CARDPR в разделе Настройки-Переменные создать для этих полей свои переменные, например, deliverydate.
Ссылку на регистрацию карт вы можете скопировать в CARDPR в разделе Выдача карт -> Редактирование формы -> Установка -> Ссылка на форму.
11. Перейдите на вкладку Хуки и внесите в поля ключи для хуков.
12. Нажмите кнопку Сохранить, далее включите интеграцию.
13. Если у вас есть выпущенные карты в личном кабинете CARDPR, перейдите в раздел Клиенты и нажмите кнопку в правом нижнем углу Записать в CRM.
Особенности интеграции:
- Начисление/списание бонусов, предоставление скидок настраивается и происходит на стороне вашей системы Битрикс24.
- Электронная карта синхронизируется с карточкой контакта в Битрикс24.
- Интеграция и автоматическое обновление данных доступны при работе на любом платном тарифе в Битрикс24.
- Если для клиента, который уже есть в Битрикс24, выпускается электронная карта через интерфейс CARDPR, то карточки контактов не объединяются, а создается новая карточка контакта, то есть дубль – связано с техническими особенностями Битрикс24.
- В случае, если в Битрикс24 у вас уже есть база клиентов, рекомендуем выпускать карты из Битрикс24.
- При выпуске карт из Битрикс24 для автоматической отправки клиентам ссылки на установку карт потребуется подключение sms-сервиса.
- При получении карты информация о клиенте и его карте обычно появляется в системе Битрикс24 от нескольких минут до нескольких часов. Максимальное время появления — 24 часа. Время появления зависит от загрузки систем и очереди на обновление.
- При изменении информации о клиенте в Битрикс24 информация в CARDPR и на карте клиента обновляется от нескольких минут до нескольких часов. Время появления зависит от загрузки систем и очереди на обновление.