Настройка интеграции через Albato с нуля

Для настройки интеграции через Albato с нуля нужно создать Связку — это автоматизация, которая соединяет Taptop и сторонний сервис и передает между ними данные.

Связка работает по принципу: если произошло событие — Триггер , то запускается Действие . Например, если отправлены данные из формы Taptop, то создается новая запись с этими данными в CRM.

Для обработки событий используется Вебхук — механизм для обмена данными между различными сервисами. При наступлении события один сервис отправляет данные по указанному URL-адресу (вебхуку) другому сервису и в нем запускается нужное действие.

Про все возможности сервиса Albato можно узнать насайте.

Пошаговая инструкция по созданию интеграции

Шаг 1. Создайте новую связку

Перейдите на вкладку Мои связки и кликните на карточку Новая связка.

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

Шаг 2. Добавьте и настройте триггер

Добавление триггера

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

Настройка триггера

В открывшемся окне заполните данные формы:

Выберите сервис, откуда получать данные, — Taptop.

Выберите событие, которое запустит передачу данных — Получены данные из формы.

Подключите свой аккаунт Taptop — это URL, на который Taptop будет отправлять данные.

Кликните на поле Выберите подключение аккаунта Taptop , а затем нажмите кнопку Добавить подключение.

Измените название подключения (опционально) и нажмите кнопку Далее.

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

4. Нажмите кнопку Продолжить в форме, чтобы завершить настройку триггера.

Шаг 3. Получите вебхук и активируйте «Ловца вебхуков»

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

1. Скопируйте вебхук в буфер обмена.

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

Шаг 4. Добавьте полученный вебхук в Taptop

1. Нажмите кнопку Добавить вебхук Albato.

2. Заполните данные вебхука в форме:

Введите название вебхука.

Вставьте скопированную ранее ссылку на вебхук в поле Ссылка на вебхук Albato. URL начинается с «https://h.integrations-hub.ru/wh/».

Выберите формы, с которых вы хотите передавать данные. Можно выбрать одну или несколько форм.

3. Нажмите кнопку Добавить вебхук Albato .

После того как вы нажали кнопку Добавить вебхук Albato, произойдет следующее:

Taptop отправит на URL вебхука тестовые данные формы.

Albato получит эти данные и отправит в Taptop список полей форм, значения которых будут передаваться через вебхук.

Дождитесь подтверждения передачи данных (может занять несколько секунд). При успешной передаче вы увидите в окне статус Вебхук получен, а также сообщение «Доступны новые поля» и полученный список полей. Эти поля будут использоваться для настройки заполнения полей в системе, с которой вы интегрируетесь.

Также по умолчанию передаются следующие данные: Название формы, ID сайта, ID формы, Тип события, Дата и время отправки события.

После добавления вебхука Albato получит тестовые данные, только если «Ловец хуков» находится в статусе Ожидание вебхука на URL — он был установлен на шаге 3. Если «Ловец хуков» находится в ином статусе, то Albato не примет данные. Статус Ожидание вебхука на URL также нужен при редактировании вебхука — если вы полностью меняете список привязанных к нему форм.

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

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

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

Шаг 5. Добавьте действие, которое будет происходить после старта связки

1. Кликните на «+» на плашке добавления действия.

2. Выберите сервис, в который будут передаваться данные. Например, Google Sheets или AmoCRM.

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

3. Выберите действие, которое нужно выполнить. Например, «Создать/обновить одну строку» в Google Sheets или «Новая сделка» в AmoCRM.

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

Нажмите кнопку Добавить подключение.

Измените название подключения (опционально) и нажмите кнопку Далее.

Предоставьте доступ к вашему аккаунту в выбранном сервисе.

После предоставления доступа к аккаунту вы увидите сообщение «Подключение успешно создано».

5. Настройте дополнительные параметры подключения в выбранной системе. Например, для Google Sheets нужно выбрать файл и лист таблицы, в который будут передаваться данные. Затем нажмите кнопку Продолжить.

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

6. Настройте поля в принимающем сервисе. Для каждого поля в сервисе выберите соответсвующее поле формы в Taptop. Например, для столбца Имя в таблице Google Sheets выберите поле формы, в которое пользователь будет вводить имя (в примере — name).

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

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

7. Активируйте связку, нажав кнопку Запустить.

Чтобы связка работала правильно, убедитесь, что нужные поля отмечены как обязательные в форме Taptop. Для этого откройте форму в Редакторе дизайна, выберите нужное поле и на вкладке Настройки на правой панели установите галочку «Поле обязательно для заполнения».

Шаг 6. Протестируйте работу интеграции

Опубликуйте проект, откройте сайт и заполните нужную форму. Затем проверьте, передались ли данные в выбранный сервис.

Как просмотреть и отредактировать созданные связки

Действия со связками

На вкладке Мои связки отображаются все созданные в проекте связки и их статусы. Доступны следующие действия:

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

Если связка неактивна , ее можно активировать, нажав кнопку Запустить .

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

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

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

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

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

Как проверить работу связки

На вкладке Журнал отображаются результаты работы всех связок в проекте. Здесь можно увидеть название связки, дату / время получения данных, используемые сервисы, результат работы связки и ее статус: Успех или Ошибка. Чтобы получить актуальную информацию, нажмите кнопку Обновить данные .

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

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

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