Albato — сервис-коннектор, который связывает BotMan с более чем 1000 сервисов без программирования: CRM, учётными системами (1С, МойСклад), Google Таблицами, мессенджерами, платёжными и рекламными системами.

Интеграция работает в обе стороны:

• из BotMan в другие сервисы — события бота (новый подписчик, входящее сообщение, добавленный тег, оплата) запускают связку в Albato;
• из других сервисов в BotMan — по событию во внешнем сервисе можно отправить подписчику сообщение, поставить тег, записать поле, запустить или остановить сценарий.

Что можно сделать:

• передавать новых подписчиков, заявки и оплаты в CRM, 1С или Google Таблицы — вместе с тегами и пользовательскими полями;
• по оплате или смене статуса во внешней системе отправлять сообщение или запускать сценарий в боте;
• синхронизировать теги, поля и статусы подписчиков;
• собирать уведомления и аналитику в одном месте.

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

Что понадобится

Как зарегистрироваться в Albato

1. Перейдите на страницу регистрации Albato.
2. Выберите страну в окне «Выберите страну» и нажмите «Подтвердить». От страны зависит, в каком регионе Albato будет хранить ваши данные.

3. Проверьте страну в строке над кнопками регистрации. Если она определилась неверно, нажмите «изменить» рядом с ней. Язык интерфейса можно переключить в правом верхнем углу.
4. Зарегистрируйтесь через мессенджеры или по email и паролю. 
5. Отметьте согласие с условиями сервиса и политикой конфиденциальности и нажмите кнопку регистрации.

Как подключить BotMan к Albato

Подключение строится на API-ключе BotMan: вы создаёте ключ в личном кабинете и вставляете его в Albato. Это делается один раз.

Шаг 1️⃣. Получите API-ключ в BotMan

1. Войдите в личный кабинет BotMan.
2. Откройте раздел Интеграции — или сразу перейдите по прямой ссылке.
3. Нажмите «Подключить API» — будет создан персональный API-ключ.

4. Скопируйте ключ.

API-ключ даёт доступ к данным вашего аккаунта — не передавайте его третьим лицам. Если ключ перевыпустить, старый перестанет работать: обновите его в подключении BotMan в Albato, иначе все связки остановятся.

Шаг 2️⃣. Создайте подключение в Albato

1. В Albato создайте новую связку или откройте существующую
2. В верхнем меню откройте Automations и нажмите Create new automation. Чтобы изменить существующую связку, выберите её в списке на этой же странице.

3. Откроется редактор связки. Нажмите Add trigger, если связку должно запускать событие в BotMan, или Add action, если BotMan должен выполнить действие.

4.  В списке приложений выберите BotMan.

5. В поле Choose an event выберите событие (для триггера) или действие BotMan (рассказываем ниже про это).

6. В блоке Connect your BotMan account to Albato откройте список Choose BotMan connection to Albato и нажмите Add a connection.

7. В окне Create a connection to BotMan заполните два поля:

• Name your connection — понятное название подключения (по умолчанию My Account BotMan). Если у вас несколько аккаунтов BotMan, дайте им разные названия;
• Open api token — вставьте API-ключ из шага 1.

8. Нажмите Continue.

Подключение можно создать и заранее, без связки, в разделе Apps верхнего меню. Кнопка Create from template на странице Automations создаёт связку из готового шаблона.

Названия разделов и кнопок Albato в статье даны по английскому интерфейсу. Если у вас интерфейс на русском, ориентируйтесь на расположение элементов на скриншотах.

Шаг 3️⃣. Проверьте подключение

1. Если ключ верный, появится сообщение Connection successfully created. Нажмите Continue.

2. Подключение появится в поле Connect your BotMan account to Albato с ID вашего аккаунта BotMan (например, My Account BotMan ID 40083). Нажмите Continue.

3. Для триггера Albato предложит проверку Test your trigger: Test получит пример данных из вашего аккаунта, Skip testing пропустит проверку. Пример данных нужен, чтобы подставлять поля в следующие шаги связки.

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

Триггеры: какие события BotMan запускают связку

Триггеры BotMan работают только на платных тарифах. Запуская связку, Albato подписывается на события вашего аккаунта, а подписка на события доступна на платном тарифе BotMan.

Особенности триггера «Входящее сообщение» (Incoming message)

Данные приходят в одинаковом виде для всех платформ:

• тип сообщения показывает платформу: msg_in_telegram, msg_in_vk и т.д.;
• тип контента — текст, картинка, видео, файл или голосовое;
• текст сообщения — текст или подпись к медиа.

Учтите при настройке:

• отредактированное сообщение приходит в связку повторно;
• во ВКонтакте каждое вложение приходит отдельным событием с тем же текстом;
• стикеры в Telegram событие не создают.

Каждый триггер передаёт в связку данные события (подписчик, канал, тег, платёж), которые можно подставлять во все следующие шаги. Во всех триггерах есть поле «ID подписчика» — передавайте его в действия BotMan, чтобы они нашли нужного подписчика.

Пользовательские поля и теги. В триггерах «Новый подписчик» и «Изменение подписчика», а также в действиях «Поиск подписчика» и «Получение подписчика по ID» пользовательские поля приходят отдельными полями — с названиями из BotMan и подходящими типами: число, дата, дата и время, да/нет, список. Теги приходят списком названий. Если нужного поля нет в списке переменных, нажмите «Обновить» в блоке «Пользовательские поля» шага связки — Albato подтянет актуальные поля аккаунта.

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

Действия: что можно сделать в BotMan

Большинству действий нужен «ID подписчика» — это ID подписчика в BotMan, а не ID пользователя в соцсети. Возьмите его из любого триггера BotMan или из действия «Поиск подписчика» (подробнее — в следующем разделе).

Сценарии каналов-эмуляторов через API не запускаются, а тестовые подписчики эмулятора не находятся поиском.

Для «Кастомного API-запроса» используйте методы API BotMan: обзор и примеры — в статье Начало работы с API BotMan, полный список методов — в документации API (Swagger). Базовый URL — https://api.botman.pro, ключ передаётся в заголовке X-Api-Key.

Как найти подписчика, если связка начинается во внешнем сервисе

Если триггер — событие в CRM, 1С или таблице, «ID подписчика» в нём нет. Сначала найдите подписчика в BotMan, потом выполняйте действие.

1. Триггер во внешнем сервисе (например, «Сделка перешла в этап» или «Новый документ»).
2. Действие BotMan → Поиск подписчика: поле поиска — телефон или email, значение — из триггера.
3. Действие BotMan (сообщение, тег, сценарий): в «ID подписчика» подставьте результат шага 2.

Что важно учесть:

• Значение должно совпадать с тем, что хранится в BotMan, символ в символ. Чаще всего поиск не срабатывает из-за разного формата телефон в системном поле BotMan хранится в международном формате с плюсом, например +79991234567. Если во внешнем сервисе номер записан иначе (7…, 8…, с пробелами или скобками), поиск его не найдёт — приведите номер к формату +7… инструментами Albato для обработки данных.
• Если подписчик может не найтись, добавьте после поиска фильтр, чтобы связка не падала с ошибкой на следующем шаге.

Подробнее — в статье «Как найти подписчика из внешнего сервиса» (готовится).

Пример и готовые связки

Пример: подписчик с тегом «Оплатил» — в Google Таблицу

1. Триггер: BotMan → Добавление тега подписчику.
2. Фильтр: название тега равно «Оплатил».
3. Действие: Google Sheets → Добавить строку, в колонки подставьте имя, телефон, email и нужные поля из триггера.

Готовые связки

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

Все связки BotMan в каталоге Albato: albato.ru/app-botman.

Полезно знать

• Одно подключение (один API-ключ) обслуживает любое число связок.
• Триггеры срабатывают только у запущенной связки. В режиме теста Albato временно подписывается на события, чтобы получить пример данных.
• Данные триггера доступны для подстановки во все последующие шаги связки.
• Если поставить связку на паузу, Albato отпишется от событий BotMan; при повторном запуске подписка создастся заново. События, произошедшие во время паузы, в связку не попадут.
• Если связка не работает, сначала проверьте историю запусков в Albato: там видно, на каком шаге и с какой ошибкой она остановилась.

Частые проблемы

Не нашли ответ? Напишите в поддержку BotMan и приложите ссылку на связку или скриншот ошибки из истории запусков Albato. Вопросы по работе самого Albato — в поддержку Albato.