Работа с готовыми интеграциями Albato

Решения — это набор готовых, уже настроенных шаблонов связок для различных бизнес-процессов. В Решении уже настроены сервисы, триггеры и действия, вам нужно лишь подключить сервисы, предоставив Albato доступ. При этом внутри каждого Решения вы сможете настраивать различные сценарии.

Как использовать Решения

Доступные Решения можно увидеть на вкладке Решения → Маркетплейс. Когда вы добавите какое-либо Решение из маркетплейса к себе в аккаунт, оно появится в разделе Мои установки и станет вашей личной копией. Это значит, что любые изменения, которые вы внесете в Решение из раздела Мои установки, никак не повлияют на исходное Решение в Маркетплейсе. Аналогично, если исходное Решение в Маркетплейсе обновится — это никак не повлияет на то, что уже находится в разделе Мои установки.

Список Решений в Маркетплейсе

Что нужно сделать перед добавлением Решения

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

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

Стандартная форма

Если вы измените стандартные названия полей формы (Name и Email address), то после добавлении Решения нужно будет сделать дополнительные настройки. Подробнее — Если вы изменили названия полей в настройках формы.

Название поля формы в настройках

Как добавить Решение себе

Шаг 1. Выберите нужное Решение

Найдите необходимое Решение и нажмите кнопку Установить.

Шаг 2. Выберите сценарий

Подтвердите выбор, нажав кнопку Далее.

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

Аккаунт Taptop — это URL, на который Taptop будет отправлять данные. Для передачи данных необходимо предоставить сервису Albato доступ к вашему аккаунту.

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

1. Нажмите кнопку Предоставить доступ.

2. Подтвердите подключение к аккаунту Taptop, нажав кнопку Далее.

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

Шаг 4. Добавьте вебхук

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

1. Пролистайте страницу вниз и найдите раздел Добавленные вебхуки Albato. Нажмите кнопку Добавить вебхук.

2. Заполните поля:

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

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

Нельзя добавить несколько вебхуков Albato, которые совпадают по URL и выбранным формам.

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

Добавленный вебхук будет отображен в списке.

Шаг 5. Подключите аккаунт принимающего сервиса

1. Нажмите кнопку Предоставить доступ под названием сервиса.

2. Нажмите кнопку Далее, войдите в свой аккаунт и предоставьте к нему доступ.

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

Готово! Система проверит все параметры и при успешном результате появится сообщение о том, что интеграция настроена. Нажмите кнопку Ок.

Шаг 6. Добавьте собственный сценарий (опционально)

После настройки интеграции вы по желанию можете добавить в Решение свой сценарий.

1. Нажмите Добавить собственный сценарий.

2. Введите название сценария и нажмите кнопку Сохранить.

3. Добавленный сценарий появится в списке Мои сценарии. Чтобы перейти к его настройке, нажмите на иконку шестеренки.

4. Настройте связку — это автоматизация, которая соединяет Taptop и сторонний сервис и передает между ними данные:

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

Подробнее о том, как настроить связку — Настройка интеграции через Albato.

Шаг 7. Запустите решение

Нажмите кнопку Запустить.

Готово! Решение настроено и запущено.

Добавленное Решение будет отображаться на вкладке Решения → Мои установки. На карточке Решения вы можете выбрать следующие действия:

Приостановить работу Решения, нажав кнопку На паузу.
Перейти к журналу, чтобы посмотреть результаты работы интеграции.
Перейти к настройкам Решения, нажав на иконку шестеренки. Вы можете отредактировать текущий сценарий или добавить дополнительный.
Удалить установленное Решение — для этого оно должно быть поставлено на паузу.

Шаг 8. Протестируйте работу Решения

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

Резюме: Как работать с Решениями

Чтобы сделать интеграцию с помощью готового Решения Albato:

Создайте форму.
Выберите нужное Решение и сценарий.
Подключите аккаунт Taptop.
Добавьте вебхук Albato: вставьте URL подключения к Taptop и выберите нужную форму.
Подключите аккаунт принимающего сервиса.
Запустите Решениe.

Если вы изменили названия полей в настройках формы

Если вы изменили названия полей формы по умолчанию — Name и Email address, вам нужно сделать дополнительные настройки в Решении, чтобы данные передавались корректно.

После добавления Решения сделайте следующие действия:

Шаг 1. Остановите работу Решения

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

Шаг 2. Откройте настройки сценария

1. Перейдите в настройки Решения, нажав на иконку шестеренки на карточке.

2. Перейдите в настройки сценария, нажав на иконку шестеренки справа от его названия.

Шаг 3. Активируйте «Ловца хуков»

Инструмент «Ловец хуков» помогает передавать в сервис информацию о полях формы.

1. Нажмите на иконку «Ловца хуков» на плашке подключения Taptop.

2. Скопируйте URL вебхука и нажмите кнопку Ожидать вебхук.

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

3. «Ловец хуков» активирован и ожидает передачи данных.

Шаг 3. Отредактируйте вебхук, который вы создали при настройке Решения

1. Нажмите на три точки справа и выберите Редактировать.

2. Вставьте скопированный ранее URL вебхука в поле Ссылка на вебхук Albato. Затем нажмите кнопку Сохранить вебхук Albato.

3. Подождите, пока «Ловец хуков» получит данные о новых полях формы, и в окне будет отображен их список. Нажмите кнопку Закрыть.

Шаг 4. Измените поля в настройках подключения сервиса

1. Нажмите на иконку шестеренки на плашке подключении к сервису.

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

Шаг 5. Запустите Решение и протестируйте его работу

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

Если вы настроили Решение, но хотите изменить форму, из которой будут приходить данные

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

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

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

2. Выберите нужную форму, затем нажмите кнопку Сохранить вебхук Albato.

3. Протестируйте работу Решения — заполните нужную форму и проверьте, передались ли данные в выбранный сервис.