14.08.2020
3668

Настройка Приема данных в Битрикс 24

Настройка Приема данных в Битрикс 24

Давайте пройдем весь этап настройки Битрикс 24 вместе!

Навигация:
1. Что будет делать интеграция с Битрикс 24?
2. Как подключить аккаунт Битрикс 24 к ApiX-Drive?
3. Как настроить в выбранном действии передачу данных в Битрикс 24?
4. Пример данных, которые будут отправлены в ваш Битрикс 24.
5. Автообновление и интервал срабатывания связи.

Ответы на часто задаваемые вопросы:
1. Почему после подключения аккаунта Битрикс24, появляется данная ошибка - "REST is available only on commercial plans"?
2. Можно ли подключить аккаунт Битрикс 24 в вашей доменной зоне?
3. Появляется ошибка при передаче данных в поле "Сумма", как исправить?

Для этого кликаем "Начать настройку Приема данных".

Настройка Приема данных в Битрикс 24 | Переход к настройке системы приема данных

Выберите систему в качестве Приема данных. В данном случае, необходимо выбрать Битрикс 24.

Настройка Приема данных в Битрикс 24 | Выбор системы приема данных

Далее, необходимо указать действие, например, "Отправка лидов".

Настройка Приема данных в Битрикс 24 | Выбор действия в системе приема данных

- Отправка лидов - в Вашем аккаунте Битрикс 24 будет создан новый лид. Система, на основе данных из блока Источника данных, будет создавать новый лид в нужном статусе.  
- Отправка сделок - в Вашем аккаунте Битрикс 24 будет создана новая сделка. Система, на основе данных из блока Источника данных, будет создавать новую сделку в нужной вам воронке и статусе.
- Отправка компаний - в Вашем аккаунте Битрикс 24 будет создана новая компания. Система, на основе данных из блока Источника данных, будет создавать новую компанию.
- Отправка контактов - в Вашем аккаунте Битрикс 24 будет создан новый контакт. Система, на основе данных из блока Источника данных, будет создавать новый контакт.
- Обновить сделки - в Вашем аккаунте Битрикс 24 будет обновлена существующая сделка. Система будет находить существующую сделку по указанным параметрам (номер телефона, имя клиента, номер заказа и т.д.) и полям. Если будет найдено соответствие данных из блока Источника данных и в Вашей сделке Битрикс 24, тогда сделка будет обновлена. Например, Вам нужно обновлять сделку, а искать нужную сделку Вы хотите по номеру заказа. Тогда Вам нужно в "Поле для поиска", выбрать "Номер заказа", а в поле "Искомая строка", Вы указываете переменную из блока Источник данных, в которой будут находиться данные об этом номере.
- Обновить лиды - в Вашем аккаунте Битрикс 24 будет обновлен существующий лид. Система будет находить существующий лид по указанным параметрам (номер телефона, имя клиента, номер заказа и т.д.) и полям. Если будет найдено соответствие данных из блока Источника данных и в Вашем лиде Битрикс 24, тогда лид будет обновлен. Например, Вам нужно обновлять лид, а искать нужный лид Вы хотите по номеру телефона клиента. Тогда Вам нужно в "Поле для поиска", выбрать "Номер телефона", а в поле "Искомая строка" Вы указываете переменную из блока Источник данных, в которой будут находиться данные об этом номере.

Следующий шаг - выбор аккаунта Битрикс 24, в который будет происходить отправка данных.
Если нет подключенных логинов к системе ApiX-Drive кликните, "Подключить аккаунт".

Настройка Приема данных в Битрикс 24 | Подключение аккаунта системы приема данных

В появившемся окне укажите, какую версию Битрикс 24 Вы используете - облачную или коробочную. Также, выберите страну регистрации вашего аккаунта Битрикс 24.

Проверьте, пожалуйста, не блокирует ваша коробочная версия наши IP-адреса: 
Если у Вас URL адресной строки в личном кабинете ApiX-Drive:
s1.apix-drive.com - 157.230.117.136
s2.apix-drive.com - 164.90.220.66
s3.apix-drive.com - 142.93.106.250     

Далее, необходимо будет в поле "Домен портала" указать доменное имя Вашего аккаунта Битрикс 24.
Для этого переходим в Ваш Битрикс 24.

Обратите внимание!
На бесплатном тарифе Битрикс 24, доступа к API может не быть. Чтобы узнать, есть ли в Вашем аккаунте доступ к API, напишите в поддержку сервиса Битрикс 24.  

Настройка Приема данных в Битрикс 24 | Выбор версии Битрикс 24

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

Настройка Приема данных в Битрикс 24 | Переход с списку дополнительных разделов
Настройка Приема данных в Битрикс 24 | Переход в раздел Приложения

В результатах поиска должно отобразиться приложение ApiX-Drive.
Кликните "Посмотреть", чтобы перейти к установке.

Настройка Приема данных в Битрикс 24 | Поиск приложения ApiX-Drive

Кликните "Установить", чтобы установить приложение ApiX-Drive в Вашем аккаунте Битрикс 24. Подтвердите свое намерение установить приложение ApiX-Drive в свой аккаунт Битрикс 24. Также, нужно принять условия лицензионного соглашения и политики конфиденциальности.

Настройка Приема данных в Битрикс 24 | Установка приложения ApiX-Drive
Настройка Приема данных в Битрикс 24 | Подтверждение установки приложения ApiX-Drive

Убедитесь, что приложение Apix-Drive успешно установлено.

Настройка Приема данных в Битрикс 24 | Завершение установки приложения ApiX-Drive

Теперь необходимо скопировать доменное имя Вашего аккаунта Битрикс 24.

Внимание!

В адресе ссылки не должны присутствовать https://, / или другие символы. Скопировать нужно только сам адрес, который выделен красным цветом на картинке в адресной строке браузера.

Настройка Приема данных в Битрикс 24 | Пример доменного имени Битрикс 24

Перейдите в ApiX-Drive и вставьте в поле "Домен портала" скопированный ранее домен из Вашего аккаунта Битрикс 24.

На данный момент интеграция работает с такими доменными зонами как UA, RU, KZ, BY.
Кликните "Сохранить" и выберите подключенный аккаунт в выпадающем списке.

Настройка Приема данных в Битрикс 24 | Заполнение доменного имени
Настройка Приема данных в Битрикс 24 | Выбор подключенного аккаунта Битрикс 24

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

Настройка Приема данных в Битрикс 24 | Выбор статуса в Битрикс 24 для передачи лидов

Обратите внимание!
При отправке данных существует функция Исключения дублирования товаров, контактов и компаний.
- При Отправке лидов можно исключить дублирование Товаров, сопоставляя поле ID товара или Названия товара. Если сразу отметить несколько полей, то сопоставление будет идти сразу по всем и совпадение должно быть точным, в противном случае произойдёт создание нового Товара.
- При Отправке сделок можно исключить дублирование Товаров и Контактов. Принцип аналогичный по исключению дублей по Товарам, только появляются поля для поиска и сопоставления по Имени, Фамилии, E-mail и Телефону. Если сразу отметить несколько полей, то сопоставление будет идти сразу по всем и совпадение должно быть точным, в противном случае произойдёт создание нового Товара или Контакта.
- При Отправке Контактов можно исключить дублирование Контактов, сопоставляя поле Имя, Фамилия, E-mail или Телефон. Если сразу отметить несколько полей, то сопоставление будет идти сразу по всем и совпадение должно быть точным, в противном случае произойдёт создание нового Контакта.
- При Отправке Компаний можно исключить дублирование Компаний, сопоставляя поле Название, E-mail или Телефон. Если сразу отметить несколько полей, то сопоставление будет идти сразу по всем и совпадение должно быть точным, в противном случае произойдёт создание нового Компаний.

Когда закончите настройку полей, кликните "Продолжить".  

Настройка Приема данных в Битрикс 24 | Выбор полей Facebook для передачи в Битрикс 24
Настройка Приема данных в Битрикс 24 | Назначение полей в Битрикс 24

Теперь Вы можете увидеть тестовые данные Вашего лида.
Чтобы проверить корректность настройки, кликните "Отправить тестовые данные в Битрикс 24" и перейдите в Ваш Битрикс 24, чтобы проверить результат.
Если вас все устраивает, кликните "Далее".

Настройка Приема данных в Битрикс 24 | Тестовые данные

Обратите внимание!
В полях "Сумма" и "Цена", которые приходят из таких систем как Prom, Rozetka, значения указываются с валютой "грн.", а трехзначные (и более) цифры с пробелом (1 000) и при передаче этих значений в поля "Сумма" и "Цена" в Битрикс 24, возникает ошибка, потому что Битрикс 24 не принимает значения с пробелами или с указанием валюты.
Чтобы этого избежать, добавьте блок Форматирования после блока Источника данных. Как это сделать указано в справке по Форматированию https://apix-drive.com/ru/blog/formatirovanie
В настройках необходимо выбрать поле "Сумма" или "Цена"( http://prntscr.com/ns0tqg ), функцию необходимо выбрать "Преобразовать в число". В результате у Вас значение должно отображаться без пробела и "грн."
Если Вы хотите передавать значения и суммы и цены, то нужно создать два блока форматирования для каждого поля отдельно.
После настройки форматирования, в списке доступных полей появится переменная форматирования, которую нужно выбрать и назначить в поле "Сумма" или "Цена" в Битрикс 24.

На этом настройка Приема данных завершена!
Теперь можете приступить к выбору интервала обновления и включению автообновления.
Для этого кликните "Включить автообновление".

Настройка Приема данных в Битрикс 24 | Переход к включению автообновления

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

Внимание! Чтобы Запуск по расписанию сработал в указанное время необходимо, чтобы интервал между текущим временем и указанным временем был более 5 минут. Например, Вы выбираете время 12:10 и текущее время 12:08 - в этом случае автообновление связи произойдет в 12:10 на следующий день. Если Вы выбираете время 12:20 и текущее время 12:13 - автообновление связи сработает сегодня и далее каждый день в 12:20.

Для того, чтобы текущая связь срабатывала после другой связи, поставьте галочку "Обновлять только после связи" и укажите связь, после которой будет срабатывать текущая.

Настройка Приема данных в Битрикс 24 | Выбор интервала обновления
Настройка Приема данных в Битрикс 24 | Приоритет обновления

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

Настройка Приема данных в Битрикс 24 | Включение автообновления

На этом настройка Битрикс 24 в качестве Приема данных завершена! Видите как все просто!?

Теперь можете не беспокоиться, дальше ApiX-Drive сделает всё самостоятельно!