1. Запросы заказчиков
Один из самых популярных сценариев для настройки интеграций среди наших заказчиков - это выгрузка данных с портала А на портал Б.
Это может быть, например, передача данных из Битрикс24 в Битрикс24 или же другой внешний сервис.
Как может показаться на первый взгляд, реализовать такой сценарий самостоятельно довольно сложно.
Однако разобраться в функционале Пинкит без помощи технических специалистов по силам каждому.
Всего-то и понадобится: первое - наша инструкция, второе - документация REST API.
Что касается первого, сегодня разберем сценарий по выгрузке сделок, обновлений по ним и привязанных к сделкам контактов. О настройке такой связки читайте далее.
Однако реализовать можно и любой другой бизнес-сценарий, просто составьте его заранее и свяжитесь с нами.
Подробную инструкцию по настройке интеграции с выгрузкой и обновлением сделок с описанием инструментов на шаге 2 читайте здесь.
Инструкция по настройке интеграции для выгрузки сделок с контактами из портала А в портал Б
Начинаем с авторизации в личном кабинете Пинкит (если еще не зарегистрированы, то можно это сделать по ссылке: https://lk.pinkit.io/register).
Шаг первый: Откуда
Начинаем с выбора портала А и добавления к нему доступа. Затем добавляем триггер "Создание сделки", воронку сделок и стадию сделок. Также ставим пользовательский фильтр для дополнительной настройки:
Фильтр основан на документации REST API Битрикс24. Предположим, нам требуется выгрузить только одну сделку с заданным идентификатором.
Переходим в раздел "Сделки" в документации и ищем описание всех полей сделки:
Идентификатор сделки - это поле ID.
Настраиваем фильтр следующим образом:
Тип фильтра - "Запрос", "Название параметра" - filter.ID, "Значение параметра" - числовой идентификатор сделки. Так из массива сделок фильтр выберет только сделку с ID = 345.
Существуют три типа фильтра: запрос, тело и ответ. Данные на первом шаге всегда идут через POST или GET-запросы, а также вебхуки.
Для GET-запросов можно установить дополнительную фильтрацию.
"Тело" - используется в теле запроса. "Ответ" - с помощью этого фильтра данные проверяются на сервере и сразу отсеиваются, не попадая в интеграцию.
Успешность запроса можем проверить помощью кнопки "Протестировать":
С помощью инструмента "Тестовые данные" получим первую случайную сделку из Битрикс24 с описанием ее полей, без учета фильтрации.
Здесь можно получить путь к любому полю сделки, которое доступно через API. Например, идентификатор стадии сделки (на скриншоте сделка на стадии "Новая"):
Шаг второй: Инструменты
На этом шаге у нас есть множество инструментов, с помощью которых можно добавить дополнительные настройки в интеграции.
Например, с помощью API-запроса можно получить контакт, связанный с сделкой, прямо в этой интеграции, не создавая отдельной.
Также можно получить ФИО сотрудника, связанного со сделкой - это часто требуется для создания отчетов. Разберем настройку такого запроса.
Нам нужно поле ASSIGNED_BY_ID (берем из документации) - это пользователь, связанный со сделкой.
Копируем путь к нему с помощью инструмента "Тестовые данные" из первого шага : source.ASSIGNED_BY_ID.
Идем обратно на шаг второй, добавляем шаг интеграции и настраиваем его следующим образом:
Называем шаг "Получить ФИО сотрудника", тип шага - API-запрос методом GET, указываем "Условие выполнения" - source.ASSIGNED_BY_ID (путь к полю, который получили ранее), вводим URL: /user.get?ID={{source.ASSIGNED_BY_ID}}.
Это стандартный запрос, который получает данные о пользователе по идентификатору, значение идентификатора указываем из условия выполнения, добавляя фигурные скобки.
Следом добавляем доступ к порталу А.
Проверяем запрос с помощью инструмента "Протестировать". Раскрываем значение result и видим, что инструмент работает, ФИО сотрудника получено:
Таким образом, мы получаем ФИО сотрудника, связанного со сделкой, которую получили на первом шаге.
Теперь настраиваем проверку так, чтобы интеграция продолжала работать, а не прерывалась, если ФИО соответствует полученному значению.
Копируем значение параметра с помощью инструмента "Протестировать":
Для этого используем инструмент "Проверка", в "Название поля" укажем скопированное значение: step1.result.0.LAST_NAME.
Ставим условие "Текст-содержит", укажем сравниваемое значение (фамилию сотрудника) и действие "Продолжить", если проверка пройдена.
Шаг третий: Куда
Добавляем портал Б и доступы к нему, выбираем действие "Создание сделки", выбираем воронку и подключаем доступ.
Шаг четвертый: Сопоставление данных
Сопоставляем поля сделок на порталах А и Б. Также есть вариант создания пользовательских полей.
Чтобы передать, например, в поле сделки "Комментарий" фамилию ответственного сотрудника, копируем значение поля с помощью тестовых данных и добавляем в сопоставление.
Таким образом, в поле "Комментарий" запишется значение параметра {{step1.result.0.LAST_NAME}}.
Чтобы добавить пользовательское сопоставление, например, указываем "Название сопоставления", "Название параметра" fields.UF_CRM_1637160063 и указываем значение параметра {{step1.result.0.NAME}}.
Название параметра пишется через команду fields. плюс код поля из Битрикс24, который можно посмотреть в настройках портала: настройки CRM - пользовательские поля - список полей - открываем нужное поле и копируем код вида UF_CRM_******** из адресной строки.
Значение параметра можно выбрать через оператор @ для стандартных полей, либо получить с помощью инструмента “Тестовые данные”, скопировав путь к нему.
Шаг пятый: Запуск
Даем интеграции наименование, указываем периодичность запросов данных и запускаем.
![]()
Регистрируйтесь по ссылке: https://lk.pinkit.io/register в личном кабинете Пинкит и попробуйте самостоятельно настроить интеграцию по инструкции из этой статьи.
Алексей Окара,
основатель Пинол и продакт-менеджер Пинкит
![Узнавайте больше полезных кейсов](/upload/medialibrary/de5/2nofn6mqw59ts62grlrk5acx480q0q88.gif)
Время работы специалистов Пн.–Пт.: с 9:30 до 18:30; Сб.-Вс.: выходные.
![]()
Павел Филатов
|
Сервис
Самые востребованные интеграции по API: Google Sheets, Unisender, СберБанк, HH.ru, Контур.Фокус, GetCourse, Банки, iiko. |
![]()
Павел Филатов
|
А вы уже смотрели наш раздел "
|
![]()
Павел Филатов
|
Для тех, кто идет в ногу со временем, мы проводим регулярные
Если у Вас есть вопросы по настройке, по функционалу или вы просто хотите быть в курсе новых трендов, тогда регистрируйтесь и подключайтесь к нашим вебинарам. Для вас всегда интересные спикеры, разбор задач на примере реальных кейсов, а также подарки самым активным. |