Интеграция с Альбато

Данные ходят в две стороны, и эти направления настраиваются отдельно.

• Из магазина в Альбато — вебхуки. Когда в магазине оформляют заказ или меняется остаток, магазин отправляет запрос с данными на адрес, который выдал Альбато. Связка в Альбато получает данные и запускает следующие шаги: создаёт сделку в CRM, добавляет строку в таблицу, пишет сообщение в рабочий чат.
• Из Альбато в магазин — API. Шаг связки отправляет запрос к API магазина и передаёт в заголовке API-токен. Так сценарий получает заказ целиком, меняет его статус, обновляет цену товара или отмечает запись на услугу завершённой.

Связке часто хватает одного направления. Выгрузке заказов в Google Таблицы нужны только вебхуки, синхронизации цен из учётной системы — только API.

Интеграция с Альбато — платная функция.

Аккаунт и тариф в самом Альбато оформляются отдельно, на сайте сервиса. Связки тоже создаются там: панель магазина отвечает только за свою сторону подключения.

⚠️ Важно: если услугу отключить, выданные токены перестанут работать, и API будет отвечать на их запросы кодом 403. Новые события в очередь не попадут. 

Под статусом услуги расположены три переключателя:

• «Вебхуки» — адрес для событий, секрет подписи, выбор событий, пауза отправки и проверка подключения;
• «API-токены» — выпуск токенов, список выданных и отзыв. Число рядом с названием показывает, сколько токенов выпущено и не отозвано;
• «Журнал доставок» — последние 20 событий магазина со статусом отправки и текстом ошибки.

Техническая документация API доступна по ссылке: https://botfarm.online/docs/api/albato/

1. Проверьте, что вверху вкладки стоит статус «Услуга подключена».
2. В Альбато создайте подключение «Вебхук» и скопируйте адрес, который он выдаст.
3. На вкладке «Вебхуки» вставьте адрес в поле «URL вебхука», нажмите «Создать секрет», отметьте нужные события и включите «Отправлять события в Albato». Нажмите «Сохранить настройки».
4. Нажмите «Отправить тестовое событие». Если адрес верный, появится сообщение «Тестовое событие принято».
5. Если связке нужно обращаться к данным магазина, на вкладке «API-токены» выпустите токен с минимально нужными правами.

Магазин отправляет 23 вида событий. Они разбиты на те же группы, что и в форме настройки:

• заказы — новый заказ, смена статуса, оплата, отмена;
• клиенты и сообщения — новый клиент, изменение клиента, входящее сообщение в Telegram или MAX;
• товары и остатки — создание, изменение и удаление товара, изменение остатка, малый остаток;
• исполнители — добавление, изменение и удаление исполнителя, его отсутствия;
• записи на услуги — новая запись, подтверждение, завершение, отмена, неявка, перенос.

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

• Адрес вебхука у магазина один. Все выбранные события приходят на него, а разные связки в Альбато отбирают свои события условием по полю event.
• События возникают при действиях в панели, на витрине, в ботах и через API. Импорт каталога из файла и прямые изменения в базе данных событий не создают.
• Событие — снимок данных на момент действия. Если заказ потом изменят, уже отправленное событие не обновится: актуальное состояние сценарий получает через API.
• Одно и то же событие иногда приходит дважды, например если Альбато принял запрос, но ответил ошибкой. Повторы отсеивают по полю deliveryId.
• В событии не указано, кто выполнил действие. Если связка меняет данные через API, магазин пришлёт об этом событие, и связка, которая реагирует на него тем же действием, зациклится.

Нужен ли программист, чтобы подключить Альбато?

Для типовых связок — нет. События принимает стандартный инструмент «Вебхук» в Альбато, поля выбираются из пришедшего примера. Для запросов к API понадобится шаг «HTTP Запрос»: адрес, заголовок с токеном и тело запроса заполняются по примерам из справочника методов.

Сколько проходит времени между действием в магазине и запуском связки?

Обычно до 10–15 секунд: очередь событий проверяется раз в 10 секунд. Если Альбато не ответил или вернул ошибку, магазин повторит отправку через 5, а затем через 30 секунд. После массовых изменений, например корректировки остатков сотен товаров, доставка может растянуться на несколько минут.

Что станет с настройками, если отключить услугу?

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