Настройка интеграций в Пинкит между необходимыми веб-сервисами с нуля и без разработки

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 в личном кабинете Пинкит и попробуйте самостоятельно настроить интеграцию по инструкции из этой статьи.

Алексей Окара,
основатель Пинол и продакт-менеджер Пинкит