Что такое связка? Принцип работы связки

Общая информация

Связка состоит из “шагов связки” (триггер и действия), а так же инструментов



Сначала в связку добавляются все необходимые шаги, затем настраивается сопоставление полей и после этого связка запускается, таким образом начав передавать данные. Пока связка запущенна, редактировать её настройки запрещено.

Настройка связки

В первую очередь нам необходимо выбрать триггер, для этого жмём у первого наша на +



Затем выбираем необходимый нам сервис, откуда будем забирать данные



Выбираем необходимое нам событие, такое как например

Создание новой сделки

Изменение сделки

Новый лид в форме


Именно когда в выбранной системе произойдёт выбранное событие, связка запустится, получит информацию (поля) о выбранной сущности (лид, сделка) и передаст эту информацию дальше



Далее создаётся либо новое подключение к системе, либо выбирается из уже существующих подключений к этой системе

Затем добавляются шаги “Действия”, тут аналогично выбирается система, куда передавать данные, выбирается сам тип действия (прим. “Создать новую сделку”, “Отправить сообщение”, “Изменить статус сделки”) и так же создание или выбор подключения.

После добавления действия, перед вами будут доступны редактируемые поля этого действия:

Настройка полей

У каждого шага есть свои редактируемые поля (в том числе и у триггеров), поля могут быть как обычным инпутом, так и списочным полем. Так же есть поддержка пользовательских полей системы, в случае, если в этой системе есть поддержка работы с ними и она может их отдать в API заранее. В триггерах, это дополнительные настройки запроса, например для указание по какому конкретно под-аккаунту получать данные. В случае действий, указывается в какие поля, какие данные от предыдущих шагов нужно передать. Нажав на определённое поле, может быть предложено выбрать элемент из списка, если это списочное поле (прим. “Статус сделки”, “Тип лида”). Во всех остальных случаях, появится меню из полей предыдущих шагов:



Например если в поле Столбец А положить поле от триггера ID сделки то с каждым фактом передачи данных, в этот столбец будет попадать ID той сделки, которая передаётся на данный момент

ВАЖНО! Учтите, что поля предыдущего шага не всегда могут прийти (прим. у сделки в момент создания может быть не заполненно поле), в таком случае будет передана пустая строка. Это обязательно стоит учитывать при работе с обязательными полями.

В полях так же можно от руки прописать и статичные данные, так и совмещать их с полями предыдущих шагов.

Принцип работы связки

Когда триггер получает данные, связка начинает работу и все полученные поля передаёт в следующие шаги, пока не дойдёт до последнего. В случае если триггер получил несколько сущностей за раз, обрабатываться будет каждая сущность отдельно (прим. триггер сделал исходящий запрос и получил в ответ 5 сделок, связка запустится 5 раз), кроме отдельных триггеров, которые изначально рассчитаны на работу с массивом данных и запустится только один раз. Каждый такой запуск можно назвать Цикл связки. Цикл так же может прерваться, в случае если какой то шаг получил ошибку, но при этом прервется только один цикл, то есть в случае получения 5 сделок, если мы в любом случае попытаемся передать все 5. Так же связка запоминает в себе полученные сущности и при повторном получении того же самого ID связка не будет запущена, в случае если триггер следит за изменением сущности, тогда сверяется два параметра, ID сущности + дата изменения.

Обновлено на: 18/11/2022