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

Интеграция позволит вам создавать новые лиды, сделки, контакты или компании в Битрикс24 на основе данных из других систем. Например, вы можете передавать новые лиды с вашего сайта, лендинга или Google Sheets в Битрикс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, в который будет происходить отправка данных.
Если нет подключенных логинов к системе ApiX-Drive кликните, "Подключить аккаунт".

В появившемся окне укажите, какую версию Битрикс 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
s4.apix-drive.com - 206.81.27.39
s5.apix-drive.com - 68.183.219.78
a1.apix-drive.com - 164.92.182.124     

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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