Принцип работы интеграций

О модуле

Модуль предназначен для знакомства с процессом создания и запуска интеграций в личном кабинете Unisender.

Модуль включает в себя следующие разделы:

• Принцип работы связок в интеграциях. Рассмотрим, из каких шагов должна состоять связки и как она работает.
• Работа с триггерами. На примере интеграции Unisender с «Битрикс24» покажем, как добавить и настроить триггер.
• Работа с действиями (экшенами). На примере интеграции Unisender с «Битрикс24» покажем, как добавить и настроить действие.
• Настройка полей. Объясним, для чего нужны поля в интеграциях и как их настроить.
• Многошаговые связки. Расскажем, какая связка считается многошаговой и как ее создать.
• Инструменты интеграций. Разберем, какие инструменты можно использовать в интеграциях и для чего они нужны.
• Тестирование связок. Рассмотрим два способа тестирования готовых интеграций.

Продолжительность модуля: 50 минут.

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

Что такое связка

Связка — это автоматизированный рабочий процесс, который соединяет ваши приложения и онлайн-сервисы с Unisender.

В интеграциях Unisender можно самостоятельно собрать связку с нуля в специальном конструкторе или воспользоваться готовым шаблонов в разделе «Шаблоны.

Каждая связка обязательно должна состоять из триггера и минимум одного действия. Данные между триггером и действиями передаются с помощью специальных полей.

Рассмотрим каждую составляющую и принцип работы связки более подробно.

Что такое триггер

Триггер — это событие, которое запускает связку сервисов. Например, вы хотите отправлять себе на почту письмо каждый раз, когда получаете новый заказ. Триггером в этом случае будет являться событие «новый заказ».

Что такое действие

Действие — это событие, которое интеграция выполняет после срабатывания триггера. Например, если вы хотите отправлять письмо каждый раз, когда приходит новый заказ, действием здесь будет событие «отправить письмо».

Что такое поле

Поле — это виртуальная ячейка, предназначенная для хранения и передачи информации в связках.

Представьте, что у вас есть органайзер для канцелярских принадлежностей. В этом органайзере есть отдельные ячейки для ручек, карандашей и ластиков – подобно полям для данных в компьютере. Если вы захотите сохранить информацию о новой заявке с формы подписки, у вас будут отдельные ячейки (поля) для имени, номера телефона и email. 

Таких полей может быть сколько угодно, все будет зависеть от типа и количества данных, которые необходимо сохранить и использовать в интеграции.

Как работает связка

Логика связки в интеграциях имеет два шага:

• Первый шаг — триггер. 
• Второй шаг — действие.

Связка будет выполнять шаги действия каждый раз, когда будет запускаться триггер.

Триггер является «спусковым крючком» — событием, которое запускает процесс передачи данных из одной системы в другую или внутри одной системы. Триггер сообщает об изменениях, которые возникают в системе. Например, изменился статус сделки, получатель открыл письмо или был добавлен новый контакт.

Триггер реагирует на изменения, поэтому недостаточно просто сделать связку из двух сервисов и ждать результатов. Это правило действует одинаково, как для работы связки в режиме миграции, так и для передачи данных в режиме реального времени.

 

Например, вы настроили связку между CRM-системой и Unisender, запустили ее и ждете когда начнут передаваться контакты. 

Если внутри CRM-системы все статично — отсутствуют события, которые должны запускать процесс передачи, тогда контакты не появятся в списке Unisender. Но если в CRM-системе возникнет событие, на которое вы настроили триггер, контакты будут добавлены в список.

Действие представляет собой событие или ряд событий, которые будут происходить в ответ на сработавший триггер. Например, если в CRM-системе появится новый контакт (триггер), действием в этом случае будет добавление данных этого контакта в список.

Кроме триггера и действий можно добавить в связку специальные инструменты. О них мы подробно поговорим в отдельном разделе модуля.

С помощью инструментов можно получить необходимые данные из массива, заменить текстовые значения на цифровые, прервать связку при выполнении определенных условий и т.д.

Инструменты можно добавить между триггером и действием или между несколькими действиями, если вы создаете сложную многошаговую интеграцию.

Режим работы связки

У связок, которые вы создаете в интеграциях Unisender, есть два режима работы. Это режим миграции данных и режим работы в реальном времени. У каждого из них есть свое назначение и особенности.

Режим «В реальном времени» следует выбирать, когда у вас идет постоянный поток операций. Например, когда лиды поступают в CRM-систему и требуется отправлять их в список для рассылки, или если вы регулярно отправляете рассылку и хотите получать информацию о прочтении письма и переходе по ссылкам.

Режим «Миграция данных» следует использовать для переноса информации за определенный период или единовременной отправки большого массива данных. Например, чтобы перенести сегмент из «Битрикс24» в определенный список контактов для последующей рассылки. Режим миграции остановится автоматически после завершения переноса всех необходимых данных.

Работа с триггерами

В Unisender процесс добавления триггера или действия в связку состоит из трех основных шагов.

Рассмотрим, как добавить новый триггер на примере интеграции Unisender с сервисом «Битрикс24».

Шаг 1. Выберите сервис и событие

Настройка триггера всегда начинается с выбора сервиса, от которого будем получать данные. 

Найдите в выпадающем списке нужный сервис и кликните на него. Для нашего примера выбираем «Битрикс24».

Затем найдите в списке событие, которое должно запускать связку, и кликните на него. Выберем для «Битрикс24» событие «Новый лид».

Шаг 2. Подключите «Битрикс24» к Unisender

Теперь нужно предоставить Unisender доступ к аккаунту, чтобы он мог действовать в приложении от вашего имени и отслеживать новые события. Например, чтобы не пропустить создание нового лида в CRM-системе.

Подключение можно добавить на странице «Подключения» или прямо в настройках триггера, кликнув «Добавить подключение».

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

Затем нажмите кнопку «Продолжить», чтобы перейти к донастройке триггера.

Шаг 3. Настройте триггер

На этом шаге система предложит выбрать режим работы связки — «В реальном времени» или «Миграция данных».

О режимах работы мы подробно говорили в предыдущем разделе, когда рассматривали принцип работы связки.

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

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

После завершения настроек и сохранения изменений триггер будет добавлен в связку.

При необходимости на этом шаге можно настроить инструменты триггера — «График запуска» и «Фильтр входящих данных». Эти инструменты встроены в первый шаг связки, чтобы перейти к их настройке, кликните на соответствующую иконку.

Про «Фильтр входящих данных» мы еще поговорим в разделе с инструментами. А сейчас давайте более подробно рассмотрим, как работать с инструментом «График запуска». 

С помощью «График запуска» можно задавать промежутки и интервалы работы связки. Например, чтобы запускать связку только в выходные дни или определенное время.

Важно. Инструмент недоступен для хуковых триггеров.

Инструмент будет полезен для бизнес-процессов с постоянным потоком лидов, когда менеджеры не успевают обрабатывать все заявки или входящие лиды. Также с его помощью можно установить правило для выгрузки всех лидов за выходные в нужный список.

Работа с действиями (экшенами)

В предыдущем разделе мы подробно рассмотрели основные шаги по добавлению триггера в связку на примере интеграции Unisender с «Битрикс24». Мы настроили триггер, который будет запускать связку при создании нового лида в «Битрикс24».

Теперь необходимо добавить действие (экшен), которое должно выполняться после срабатывания триггера.

Рассмотрим три основных шага.

Шаг 1. Выберите сервис и событие

В настройках действия выберите сервис, куда должны поступать данные от триггера.

Найдите в выпадающем списке нужный сервис и кликните на него. Для нашего примера выберем Unisender.

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

Мы хотим передавать новые лиды из «Битрикс24» в Unisender, поэтому в качестве события выберем — «Добавить новый контакт».

Когда в «Битрикс24» наступит событие «Новый лид», контакты автоматически добавятся в базу Unidender.

Шаг 2. Подключите аккаунт к Unisender

Теперь нужно предоставить Unisender доступ к вашему аккаунту, чтобы он мог автоматически совершать выбранное действие. Например, добавлять новые контакты.

Можно подключить новый аккаунт на странице «Подключения» или прямо в настройках действия, кликнув «Добавить подключение».

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

Далее нажмите кнопку «Продолжить», чтобы перейти к дальнейшей настройке.

Шаг 3. Настройте действие

На этом шаге необходимо настроить поля для вашего действия.

В соответствии с нашим примером рассмотрим, какие поля нужно обязательно настроить для действия «Добавить новый контакт».

Правила перезаписи. В этом поле необходимо указать, как обрабатывать данные контактов, которые уже есть в сервисе:

• «Добавить в поля новые значения» — будут добавлены только новые данные, уже существующие данные сохранятся.
• «Переданные поля перепишут имеющиеся» — все старые данные будут заменены новыми. Контакт будет удален со всех списков, кроме указанного в поле «Список контактов».
• «Только переданные параметры будут перезаписаны» — будут заменены значения только переданных полей, если у существующего контакта есть и другие поля, то они сохранят свое значение.

Email. Поле, из которого система будет брать email нового лида. Здесь нужно выбрать значение «Email» из первого шага связки.

Список контактов. Выберите список, куда будет добавляться новый контакт.

Двухэтапная подписка. В этом поле можно настроить отправку письма для подтверждения подписки:

• «Всегда присылать письмо-приглашение» — будет считаться, что контакт только высказал желание подписаться, но ещё не подтвердил подписку. В этом случае ему будет отправлено письмо-приглашение.
• «Письмо-приглашение не требуется» — будет считаться, что согласие контакта у вас уже есть, поэтому письмо отправляться не будет.
• «Письмо-приглашение только для новых контактов» – система выполнит проверку на наличие контакта в ваших списках. Если контакт уже есть в ваших списках со статусом «новый» или «активен», то адрес просто будет добавлен в указанный вами список. Если нет, то ему будет отправлено письмо.

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

Для этого необходимо сопоставить нужное поле со значением из предыдущего шага связки. Например, если вы хотите заполнить в Unisender дополнительное поле «Город», выберите значение «Город» из параметров триггера.

 

Если при настройке действия вы не видите данные, которые недавно добавили в сервис, например, не нашли нужный список на этапе выбора контактов, перейдите в настройки подключения и нажмите кнопку «Обновить». Новые данные подтянутся в связку.

Более подробно про настройку полей поговорим в следующем разделе модуля.

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

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

В интеграциях Unisender поле является информационной ячейкой, которая связывает между собой два сервиса. С помощью полей вы выбираете, какую информацию из приложения хотите использовать и куда хотите ее отправить. Этот процесс называется сопоставлением полей (маппингом).

За счет сопоставления полей можно передавать информацию между шагами связки: от триггера к действию, от действия к действию, от инструмента к действию и так далее.

При сопоставлении полей можно использовать статический текст или динамические значения.

Статический текст

Текст, который вы вручную вводите в нужное поле. Связка будет передавать этот текст от одного шага к другому. Так, например, можно указать в настройках фильтра ID воронки или добавить в соответствующее поле заранее подготовленный HTML-код письма.

Динамические значения

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

Через динамические значения можно передавать email контактов из CRM-системы и добавлять их в базу контактов Unisender.

 

Рекомендуем при настройке связки использовать динамические поля, которые появляются при клике на поле, и выбирать необходимые вам поля через поиск. В 99% случаев там находятся все необходимые значения.

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

Многошаговые связки

Одношаговая связка имеет один триггер и одно действие. Если в связку добавить больше одного действия, настроить инструменты, фильтры или условия, такая связка будет считаться многошаговой.

Многошаговые связки позволяют соединять между собой несколько действий, запускающихся по одному триггеру. Так вы сможете автоматизировать целые рабочие процессы и выполнять одновременно несколько задач. Например, у вас на сайте есть контактная форма, которую вы с помощью интеграции подключили к Unisender. Когда клиент заполнит форму на сайте, Unisender получит эти данные и сможет выполнить следующие действия:

• добавить информацию в базу данных;
• создать контакт в CRM-системе;
• добавить контакт в список рассылок;
• оповестить команду продаж о новом клиенте по электронной почте.

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

Как добавить шаги в связку

Количество шагов в связке можно увеличить в любое время. Новый шаг можно добавить в середину или конец существующей связки.

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

Разберем подробнее, как добавить больше действий в связку.

На странице «Мои связки» найдите связку, которую хотите дополнить, и нажмите на значок шестеренки.

Важно: Если вы хотите отредактировать связку, ее нужно остановить.

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

В настройках действия выберите:

1. Сервис, который вы хотите добавить в вашу связку. 
2. Событие, которое вы хотите реализовать.
3. Аккаунт, который нужно подключить к Unisender.

Настройте поля добавляемого действия. Укажите, какие именно данные и в каких полях должны передаваться на данном шаге связки.

Вы можете использовать информацию из любого предыдущего шага. 

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

Сохраните настройки действия и протестируйте связку. Подробно про способы тестирования связок расскажем в последнем разделе модуля. 

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

Инструменты интеграций

Инструменты — это микросервисы, которые встроены в интеграции Unisender. С их помощью можно расширить основной функционал связок, чтобы создавать более индивидуальные и эффективные решения для автоматизации рабочих процессов.

Инструменты позволяют обрабатывать и структурировать данные перед их передачей между сервисами​​.

 

Все инструменты, кроме фильтра входящих данных, можно добавить в любую часть связки в качестве отдельного шага. Для этого нажмите на значок плюса там, где хотите добавить инструмент, и выберите пункт «Инструмент».

Откроется список всех доступных инструментов.

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

Фильтр входящих данных

Шаг фильтра позволяет связке продолжить работу только в случае выполнения определенных критериев. Например, если нужно передавать контакты только из воронки 123, настройте нужное условие. Тогда в связку будут приходить контакты только из указанной воронки, а из других будут блокироваться.

Фильтр входящих данных доступен на первом шаге любой связки. Чтобы настроить условия фильтрации, кликните на значок фильтра.

Задержка связки (дата и время)

Инструмент используется для временной отсрочки действий в автоматизированных процессах. С его помощью можно настроить задержку выполнения задачи до определенной даты и времени.

Инструмент позволяет контролировать время активации задач в зависимости от бизнес-требований. Можно использовать задержку связки для планирования отправки уведомлений или выполнения операций в нужный момент времени.

Парсер значений (Регулярные выражения)

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

Инструмент поддерживает разнообразные паттерны поиска и замены, предлагая гибкие настройки для различных сценариев. Например, для преобразования формата дат или удаления HTML-тегов из текста.

Получить один элемент строковой секции

Инструмент позволяет извлекать отдельные элементы из текстовых строк или секций. Вы можете указать ключевые слова или шаблоны, по которым будет произведен поиск и извлечение нужной информации. 

Инструмент пригодится для работы с данными, когда необходимо получить конкретное значение из большой строки. Так вы сможете эффективно обрабатывать текстовые данные и использовать их в дальнейших операциях.

Декодировать JSON

Инструмент применяется для обработки данных, полученных в формате JSON. Он позволяет извлекать отдельные переменные из JSON-ответов, что особенно полезно при работе с вебхуками или HTTP-запросами. 

Инструмент облегчает получение и использование конкретных данных из JSON-структур, упрощая их дальнейшую обработку и интеграцию в различные процессы.

Агрегатор

Инструмент предназначен для объединения отдельных элементов в массив и может пригодиться при передаче данных в сервисы, требующие секции с информацией. Например, с его помощью можно передавать товары в заказе или расходы по рекламным кампаниям. 

Агрегатор может работать в сочетании с другими инструментами, например с «Итератором», который разбивает массив на отдельные данные, или «Прервать связку при условии», предназначенным для фильтрации данных по заданным критериям.

Удаление тегов

Инструмент предназначен для очистки текста от HTML-тегов, таких как <div>, <p>, <span>, <br> и других. Это полезно, когда требуется преобразовать отформатированный текст в простой текст. Например, при подготовке содержания электронного письма или обработке текстов из чатов. 

Инструмент позволяет добавить шаг для удаления тегов из параметра, содержащего HTML-форматированный текст, облегчая интеграцию и передачу данных.

Разделить строку на элементы строковой секции (массив)

Инструмент разбивает текстовые строки на отдельные элементы с помощью заданного разделителя. 

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

Получить элемент из массива

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

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

Обрезка данных

Инструмент удаляет ненужные части из текстовых значений по заданным параметрам. С его помощью можно извлечь из строки нужную информацию. Например, числовое значение из URL.

В настройках инструмента можно указать точное место начала и конца обрезки, чтобы обеспечить более точное и целенаправленное извлечение данных.

Итератор

Инструмент преобразует массив данных в отдельные элементы, позволяя обрабатывать каждый из них по отдельности. Это особенно полезно при работе с массивами объектов, например товаров в заказе, где каждый элемент массива содержит информацию о конкретном товаре. 

Инструмент обеспечивает гибкость в обработке данных, позволяя применять различные операции к каждому элементу массива.

Циклический выбор значения

Инструмент обеспечивает равномерное распределение задач или объектов между разными элементами списка. Например, его удобно применять для эффективного распределения лидов между сотрудниками в CRM-системе. 

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

Прервать связку при условии

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

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

Найти и заменить

Инструмент позволяет изменять, удалять или дополнять данные в процессах автоматизации, аналогично функции в Excel. Он идеально подходит для корректировки форматов данных, таких как изменение префиксов телефонных номеров или преобразование баркодов.

В настройках инструмента можно задать параметры для поиска и замены, а также выбрать режим замены (только первое, последнее или все вхождения).

Роутер

Инструмент позволяет настроить условия, при которых внутри одной связки будут срабатывать разные сценарии. Его работу можно описать алгоритмом «ЕСЛИ условие => ТО ЗАПУСТИТЬ ШАГ а => ИНАЧЕ ЗАПУСТИТЬ ШАГ б». 

Роутер позволяет автоматизировать процессы, которые требуют различного подхода при определенных параметрах данных. Например, с его помощью можно назначать разных менеджеров в зависимости от суммы заказа.

Табличная замена

Инструмент используется для преобразования данных из одного формата в другой. Он полезен для ситуаций, когда требуется преобразовать значения из одной системы для совместимости с другой. Например, чтобы изменить статусы заказов для CRM-системы.

Можно самостоятельно настроить соответствие значений между системами, чтобы автоматизировать процесс перевода и обеспечить точность передачи данных.

Объединение строковых секций

Инструмент помогает объединить несколько строк текста в одну. Функционал будет полезен при создании шаблонов сообщений или объединении данных из разных источников в одну строку.

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

Тестирование связок

Если вы уже добавили в связку все нужные шаги, настроили поля и инструменты, не спешите запускать интеграцию в полноценном режиме. Сначала протестируйте ее.

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

Протестировать связку можно несколькими способами.

Способ 1. Использовать функцию тестирования

Функция тестирования связок значительно упрощает настройку автоматизированных процессов. Она позволяет тестировать передачу данных между сервисами до полной интеграции, гарантируя корректность формата и исключая ошибки в связках.

 

Эта функция доступна только для связок с API-триггерами. Такие связки работают по определенным временным интервалам и поэтому для них можно выполнить проверку в реальном времени.

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

Для проверки необходимо сделать связку, закончить настройку полей и нажать на кнопку «Протестировать» прямо в конструкторе связке.

Если в результате тестирования возникнут ошибки, вы получите уведомление с описанием проблемы.

Способ 2. Отправить тестовые данные

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

Например, вы настроили связку, где данные о клиенте должны передаваться из формы Tilda в Unisender. Чтобы протестировать эту связку, заполните и отправьте форму на сайте, а затем перейдите в Unisender и проверьте, что новый контакт появился в нужном списке.