Настройка интеграции через Albato с нуля
Для настройки интеграции через Albato с нуля нужно создать Связку — это автоматизация, которая соединяет Taptop и сторонний сервис и передает между ними данные.
Связка работает по принципу: если произошло событие — Триггер, то запускается Действие. Например, если отправлены данные из формы Taptop, то создается новая запись с этими данными в CRM.
Для обработки событий используется Вебхук — механизм для обмена данными между различными сервисами. При наступлении события один сервис отправляет данные по указанному URL-адресу (вебхуку) другому сервису и в нем запускается нужное действие.
Про все возможности сервиса Albato можно узнать на сайте.
Пошаговая инструкция по созданию интеграции
Шаг 1. Создайте новую связку
Перейдите на вкладку Мои связки и кликните на карточку Новая связка.
В модуле будет добавлена связка, и будет открыт Конструктор связки, в котором можно ее настроить. Вы можете изменить присвоенное связке название, кликнув на иконку карандаша.
Шаг 2. Добавьте и настройте триггер
Добавление триггера
В созданной связке добавьте триггер, который будет ее запускать, нажав на «+».
Настройка триггера
В открывшемся окне заполните данные формы:
- Выберите сервис, откуда получать данные, — Taptop.
- Выберите событие, которое запустит передачу данных — Получены данные из формы.
- Подключите свой аккаунт Taptop — это URL, на который Taptop будет отправлять данные.
Аккаунт Taptop можно подключить к проекту только один раз. После этого вы сможете использовать это подключение во всех связках и интеграциях внутри проекта. Вы также можете создать отдельные подключения аккаунта Taptop для каждой связки.
- Кликните на поле Выберите подключение аккаунта Taptop, а затем нажмите кнопку Добавить подключение.
- Измените название подключения (опционально) и нажмите кнопку Далее.
После этого вы увидите сообщение о том, что подключение создано. Нажмите кнопку Понятно.
4. Нажмите кнопку Продолжить в форме, чтобы завершить настройку триггера.
Шаг 3. Получите вебхук и активируйте «Ловца вебхуков»
Вебхук — это специальная ссылка, на которую Taptop отправит данные о полях из форм.
1. Скопируйте вебхук в буфер обмена.
2. Нажмите кнопку Ожидать вебхук, чтобы активировать так называемого «Ловца хуков» — инструмент, который будет ждать, когда наступит триггерное событие и «ловить» ответ от сервиса.
Готово! «Ловец хуков» активирован и находится в режиме ожидания вебхука.
Не нажимайте кнопку Отменить — так вы отключите режим ожидания вебхука, и Albato не сможет принять данные. Чтобы правильно настроить работу связки, «Ловец хуков» должен находиться в активном состоянии.
Шаг 4. Добавьте полученный вебхук в Taptop
Вы можете добавить в проект несколько вебхуков, максимальное количество — 10.
1. Нажмите кнопку Добавить вебхук Albato.
2. Заполните данные вебхука в форме:
- Введите название вебхука.
- Вставьте скопированную ранее ссылку на вебхук в поле Ссылка на вебхук Albato. URL начинается с «https://h.integrations-hub.ru/wh/».
- Выберите формы, с которых вы хотите передавать данные. Можно выбрать одну или несколько форм.
Если в проекте нет форм, то добавить вебхук Albato не получится. Нужно перейти в Редактор дизайна, добавить форму, а затем вернуться к настройкам интеграции.
Если вы хотите выбрать несколько форм, то действует следующее условие:Для одного вебхука вы можете выбрать только те формы, у которых полностью совпадают количество и названия полей, при этом типы полей могут отличаться. Остальные формы будут недоступны для выбора.
Нельзя добавить несколько вебхуков Albato, которые совпадают по URL и выбранным формам.
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. Добавьте подключение аккаунта выбранного сервиса.
Подключать аккаунт сервиса в проекте нужно только один раз. После этого вы сможете использовать это подключение во всех связках внутри проекта. Например, если вы подключили аккаунт Google Sheets для одной связки, его можно будет использовать и в других связках проекта.
- Нажмите кнопку Добавить подключение.
- Измените название подключения (опционально) и нажмите кнопку Далее.
- Предоставьте доступ к вашему аккаунту в выбранном сервисе.
- После предоставления доступа к аккаунту вы увидите сообщение «Подключение успешно создано».
5. Настройте дополнительные параметры подключения в выбранной системе. Например, для Google Sheets нужно выбрать файл и лист таблицы, в который будут передаваться данные. Затем нажмите кнопку Продолжить.
Для некоторых сервисов при передаче данных через Albato могут действовать особые правила. В этом случае вы увидите соответствующее уведомление. Например, при работе с Google Sheets отображается следующая информация — Правила работы с Google Sheets при передаче данных в таблицы и из таблиц.
6. Настройте поля в принимающем сервисе. Для каждого поля в сервисе выберите соответсвующее поле формы в Taptop. Например, для столбца Имя в таблице Google Sheets выберите поле формы, в которое пользователь будет вводить имя (в примере — name).
Выбрав все нужные поля, нажмите кнопку Сохранить.
Готово! Связка настроена и готова к запуску.
Если настройка не закончена, вы увидите предупреждение. В этом случае вам нужно заполнить все необходимые поля.
7. Активируйте связку, нажав кнопку Запустить.
Готово! Связка настроена и запущена. Нажмите кнопку Обновить журнал, чтобы завершить процесс. Теперь при заполнении формы на вашем сайте ее данные будут передаваться в выбранный сервис.
Чтобы связка работала правильно, убедитесь, что нужные поля отмечены как обязательные в форме Taptop. Для этого откройте форму в Редакторе дизайна, выберите нужное поле и на вкладке Настройки на правой панели установите галочку «Поле обязательно для заполнения».
Шаг 6. Протестируйте работу интеграции
Опубликуйте проект, откройте сайт и заполните нужную форму. Затем проверьте, передались ли данные в выбранный сервис.
Резюме: Как настроить интеграцию через Albato с нуля
Чтобы настроить интеграцию через Albato:
- Создайте форму.
- Создайте новую связку на вкладке Мои связки.
- Добавьте триггер — Получение данных из формы и подключите аккаунт Taptop.
- Активируйте «Ловца вебхуков».
- Добавьте вебхук Albato: вставьте URL вебхука и выберите нужную форму.
- Добавьте действие, которое будет происходить после старта связки, и подключите аккаунт принимающего сервиса.
- Запустите связку.
Как просмотреть и отредактировать созданные связки
Действия со связками
На вкладке Мои связки отображаются все созданные в проекте связки и их статусы. Доступны следующие действия:
- Если связка запущена, ее работу можно приостановить, нажав кнопку На паузу. Это может потребоваться, если вы хотите отредактировать связку, т.к. для активных связок редактирование запрещено.
- Если связка неактивна, ее можно активировать, нажав кнопку Запустить.
- Связку можно скопировать, переименовать или удалить с помощью контекстного меню.
Редактирование связки
Чтобы отредактировать связку, кликните на ее карточку или на иконку настроек — вы перейдете в Конструктор связки.
В Конструкторе связки вы можете изменить настройки триггера или действия, а также добавить в связку дополнительные шаги. Если в настройках есть ошибки, вы увидите иконку с желтым восклицательным знаком.
Если связка активна, при попытке редактирования появится сообщение о необходимости поставить ее на паузу.
Как проверить работу связки
На вкладке Журнал отображаются результаты работы всех связок в проекте. Здесь можно увидеть название связки, дату / время получения данных, используемые сервисы, результат работы связки и ее статус: Успех или Ошибка. Чтобы получить актуальную информацию, нажмите кнопку Обновить данные.
При клике на строку в таблице вы увидите более подробные данные о работе связки и сможете просмотреть детали.
Если вы хотите просмотреть данные только по одной связке, кликните на кнопку Журнал связки на ее карточке на вкладке Моя связки.
Откроется Журнал связки с информацией о полученных через нее данных. Здесь также можно посмотреть более детальную информацию и обновить данные.