Question 1

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

Accepted Answer

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

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

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

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

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

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

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

Создание новой сделки
Изменение сделки
Новый лид в форме

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

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

Затем добавляются шаги “Действия”, тут аналогично выбирается система, куда передавать данные, выбирается

Question 2

Триггеры

Accepted Answer

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

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

Триггеры могут быть двух типов:

Webhook
API

Webhook триггер

После запуска связки, Albato ожидает на определённый урл (находится в подключении) HTTP запрос с определёнными данными. Так же у каждого триггера есть свой внутренний (скрытый и не настраиваемый пользователем) фильтр, именно по нему мы понимаем, какой запрос, какой триггер должен запустить. Например если у нас триггер “Новая сделка”, то эту связку запустит только тот запрос на урл вебхука, в котором в теле указано, что это событие именно “Новая сделка”. Триггер так же может после получения вебхука, делать дополнительные запросы в API для получения более подробных данных (в этом случае так же может возникнуть ошибка у триггера).

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

API триггер

Данный триггер, по расписанию самостоятельно ходит в API системы и опрашивает её, получая список новых или изменённых сущностей. Как правило, поиск идёт по таким параметрам как “Дата создания” и “Дата изменения”, чаще всего мы запрашиваем данные за последний час, но в редких случаях, этот интервал увеличивается.

Стандартный график триггера, это запрос раз в пять минут, но может

Question 3

Штрафные баллы

Accepted Answer

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

Ошибка таймаута
Ошибка соединения

Каждый раз, как в связке происходит ошибка из указанных типов, ей начисляется ровно 1 балл. При этом работа связки будет замедляться или она остановится окончательно. Существует несколько порогов достижения штрафных баллов. В случае если это API триггер, то при достижении:

3 Балла - Пауза между запуском триггера увеличивается на 10 минут
10 Баллов - Пауза между запуском триггера увеличивается на 30 минут
15 Баллов - Пауза между запуском триггера увеличивается на 60 минут
20 Баллов - Связка окончательно останавливается

Если в связке выполняется успешно запрос (не важно, получил он данные или нет. Это может быть пустой запрос “Нет новых данных” или если триггер не прошёл фильтр), то порог сбрасывается ровно на 1 назад. То есть, если было набрано 10 баллов, то следующий запуск триггера будет выполнен через 30 минут, но если запрос будет выполнен успешно, то количество баллов сбросится до 3 и пауза будет уже 10 минут, если через 10 минут снова будет удачный запрос, баллы обнулятся.

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

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

Question 4

Конструктор интеграций - Вступление

Accepted Answer

Вступление

Конструктор интеграций позволяет самостоятельно добавить приложение (сервис) в Albato, при условии, что у приложения есть открытое API.

Сам конструктор, состоит из множества сущностей, которые тем или иным образом, связываются между собой и могут быть использованы в разных местах, таких как например “Авторизация”, “Триггер” и “Действие”. Почти каждая сущность, состоит из набора своих полей и набора настраиваемых API запросов, которые она будет запускать и получать нужный ответ от приложения.

Механика добавления, состоит из принципа “копировать-вставить”, вам нужно лишь открыть вашу API документацию, скопировать с неё URL запроса, переменные и вставить в конструктор

Workflow

Создаётся приложение, дается ему наименование, затем при необходимости, создаётся авторизация, в которой настраивается метод получения авторизационных данных и обновления, если требуется (Access token) и “шаблон” заполнения API запроса с авторизационными данными. Далее можно использовать созданную авторизацию в остальных сущностях, таким образом не нужно будет каждый раз в запросах добавлять переменные, в которые кладутся авторизационные данные.

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

Question 5

Обработка ошибок

Accepted Answer

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

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

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

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

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

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

Каждую ошибку при этом, можно запустить повторно.

Типы ошибок

Ошибки делятся на несколько основных типов:

Ошибка партнёра (сервиса) - Это ошибка возникает в случае, если после выполнения Albato исходящего HTTP запроса в сервис, этот сервис вернул в ответ указание на то, что запрос является ошибочным, а так же вернул текст этой ошибки.
Ошибка таймаута - Ошибка возникает в том случае, если Albato не получил ответ на свой запрос. Стандартно, Albato ждёт ответа

Question 6

Albato Guide

Accepted Answer

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

Привет!

Мы рады, что ты решил использовать Albato для автоматизации задач. Оцени выгоды сервиса и узнай как экономить по 2-3 часа каждый день, потратив 5 минут на настройку интеграции с нужными тебе сервисами.

Как начать?

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

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

Пример автоматизации Trello и Google Sheets:

Задача:

"При закрытии карточки в Trello отправлять данные на строку в Google Sheets."

Давай настроим вместе и увидим магию!

Для этого, тебе потребуется

Бесплатный аккаунт Trello (cоздай Demo доску)
Бесплатный аккаунт [Google Drive](http://click.mailganer.com/app/trigger/click/6805/75734363/?gotourl=https%3A%2F%2Faccounts.google.com%2FServiceLogin%3Futmcampaign%3Demailnewchain%26amp%3Butmmedium%3Demail%26amp%

Популярные статьи

Все категории