Інтеграції

Налаштування → Інтеграції — готові з'єднання магазину з програмами, якими ви вже користуєтесь: BAS/1С, Google Таблиці, Telegram, Make, n8n і Zapier. Кожне з'єднання (крім Telegram) — це звичайні вебхуки з потрібними подіями, форматом і захистом: шаблон лише створює їх за вас. Після підключення вони з'являються в Налаштування → Вебхуки з позначкою шаблону, і там їх можна змінити, як будь-який вебхук (див. «Вебхуки»).

Інтеграції — з тарифу «Бізнес», бо працюють на вебхуках: кожна частина шаблону займає одну адресу з ліміту тарифу (на «Бізнес» — 5, на «Про» — 20), а вхідні запити рахуються в події доби разом із вихідними. На тарифі без вебхуків розділ показує картки із замком і тариф, з якого вони доступні.

Картка Свій вебхук веде у «Вебхуки» — для будь-якої іншої системи, що вміє надсилати чи приймати HTTP-запити.

Три кроки підключення

Що обмінювати. Позначте частини: що магазин надсилає (замовлення, події) і що приймає (залишки, статуси, дії). На Далі магазин створює вебхуки цих частин — поки що вимкненими.
Підключення. Вкажіть адреси іншої системи, куди надсилати, і скопіюйте наші адреси, на які вона надсилатиме. Секрет підпису вихідних частин показуємо один раз, на цьому кроці, — збережіть його в BAS чи в сценарії. Загубили — Новий секрет у вебхуку частини.
Перевірка. Магазин надсилає тестову подію кожній вихідній частині й показує відповідь, а для вхідних — останній запит, який уже прийшов. Увімкнути обмін вмикає всі частини разом.

Поки шаблон не ввімкнено, можна повернутися на перший крок і змінити вибір — частини буде створено заново, з новими адресами. Шаблон, що вже працює, спершу треба відключити.

BAS/1С

Чотири частини, будь-які разом:

Замовлення → BAS — вихідний вебхук на адресу HTTP-сервісу BAS: нове, оплачене, скасоване замовлення чи зміна статусу (позначте потрібні). Програміст BAS створює з нього документ «Замовлення покупця».
Залишки й ціни ← BAS — вхідна адреса для регламентного завдання BAS: щойно змінилися, і раз на годину — усі. Формат «Як у шаблоні BAS»: масив Товари з полями Артикул, Залишок, Ціна (ціни як пише BAS, «2 490,00»; порожній залишок — 0). Інші назви полів — «Свій — зіставити поля» на вкладці «Поля» цього вебхука.
Товари ← BAS — нові товари за артикулом з'являються в каталозі чернетками, наявні оновлюються: Артикул, Найменування, Ціна, Залишок, Опис.
Статуси й ТТН ← BAS — відвантажили в BAS: замовлення стає «Відправлене», покупець отримує ТТН. BAS надсилає обидві дії одним запитом (batch, як описано у «Вебхуки → Наш формат вхідних»).

Для вашого програміста BAS на кроці «Підключення» — приклади того, що надсилає магазин і що чекаємо від BAS, а Надіслати програмісту відкриває лист у вашій пошті з адресами частин; надсилаєте його ви. Поля й відповіді для програміста:

магазин надсилає POST із JSON v1 (type, version, created_at, data.order з номером, покупцем, товарами, доставкою й сумами в копійках) і заголовком підпису X-AIB-Signature — перевірку для BAS/1С показано на вкладці «Захист і повтори» вебхука; відповідь 2xx протягом 10 секунд — успіх, інакше магазин повторить;
BAS надсилає на вхідну адресу JSON і отримує { "ok": true, "updated": …, "not_found": …, "failed": …, "errors": [ … ] } — рядки, які не знайдено, видно у відповіді й у журналі вхідного вебхука.

Google Таблиці

Кожне нове замовлення — рядком у вашій таблиці, аркуш на місяць («Жовтень 2026»). Стовпці — дата, номер, покупець, телефон, товари, сума, оплата, статус, доставка, коментар — вмикаєте й переставляєте на кроці «Підключення» кнопками ↑ ↓ біля кожного (з клавіатури: Tab до кнопки, Enter); праворуч видно, як виглядатиме таблиця з вашими останніми замовленнями. Оновлювати статус у тому ж рядку — оплату, відправлення й скасування видно в рядку замовлення.

Відкрийте таблицю → Розширення → Apps Script.
Скопіювати скрипт і замініть ним увесь код; збережіть.
Розгорнути → Нове розгортання → Веб-застосунок: виконувати від вашого імені, доступ — «Усі».
Вставте адресу веб-застосунку (https://script.google.com/macros/s/…/exec) у поле «Адреса веб-застосунку скрипту».

Вхід через Google не потрібен: скрипт живе у вашій таблиці й пише лише в неї. Сторонні його не викличуть — у скрипті є ключ, який магазин додає до кожного запиту. Змінили стовпці — скопіюйте скрипт ще раз і замініть ним старий (Розгорнути → Керувати розгортаннями → нова версія). Тестова подія на кроці «Перевірка» додає рядок з позначкою «ТЕСТ» — його можна видалити.

Кнопки в Telegram

Під кожним новим замовленням у чатах, куди бот магазину надсилає замовлення, з'являються кнопки Підтвердити, Скасувати (з перепитуванням) і Відкрити в CRM. Хто натиснув і коли — видно в повідомленні та в історії замовлення.

Потрібен бот магазину й чати в Налаштування → Сповіщення: крок «Підключення» показує, чи бот підключено і скільки чатів отримують замовлення, а «Перевірка» — бот і чати ще раз. Увімкнути обмін вмикає кнопки, Відключити — прибирає їх із нових повідомлень. Кнопки не займають адресу вебхука з ліміту тарифу.

Make, n8n і Zapier

Позначте події, які отримує сценарій (замовлення, оплати, ТТН, товари й залишки, клієнти, заявки, відгуки, записи), і за потреби одну дію, яку сценарій може робити в магазині: оновити залишки чи ціни, змінити статус, додати ТТН, створити товар, клієнта чи замовлення.

Make — адреса модуля «Webhooks → Custom webhook» для подій; дія — модулем «HTTP → Make a request» на нашу адресу.
n8n — Production URL вузла «Webhook» (метод POST, процес активний); дія — вузлом «HTTP Request».
Zapier — тригер «Webhooks by Zapier → Catch Hook»; дія — «Webhooks by Zapier → POST».

Подія приходить у форматі v1 (див. «Вебхуки → Формат даних»), дія — у нашому форматі вхідних; приклад запиту показано на кроці «Підключення».

Перевірка до ввімкнення

На кроці «Перевірка» вихідна частина отримує тестову подію — з вашим останнім замовленням, а коли замовлень ще немає, з вигаданим прикладом; поруч — код відповіді, час і перші слова відповіді. У самій події стоїть "test": true, тож інша система може її пропустити.

Вхідна адреса шаблону ще до ввімкнення приймає запити, але лише перевіряє їх: показуємо, скільки рядків прийшло, скільки готові до оновлення й які ключі не знайдено, — і нічого не змінюємо. Відповідь такого запиту має "dry_run": true, у журналі він позначений «перевірено». Перевірка не зупиняє: «Увімкнути обмін» можна натиснути й тоді, коли відповіді ще немає, — події, що не дійшли, повторюються, а про паузу ви отримаєте лист.

Зміни, пауза й відключення

Сторінка шаблону, що працює, показує його вебхуки, адреси й кнопку Перевірити. Адресу вихідної частини можна змінити там же — Зберегти адреси. Решту (події, умови, поля, IP, секрет) змінюєте на сторінці вебхука у «Вебхуках». Якщо адреса не відповідала добу, вебхук стає на паузу, як будь-який інший, — шаблон показує «на паузі», а «Відновити й надіслати» у вебхуку надсилає все, що чекало.

Відключити видаляє вебхуки шаблону разом із журналом; те, що вони вже змінили в магазині (залишки, статуси, товари), лишається. Шаблон можна підключити знову — з новими адресами.

Ключі застосунку

Налаштування → Ключі застосунку — ключі, з якими сайт магазину звертається до платформи: Публічний (aib_pk_…) працює в браузері покупця, Серверний (aib_sk_…) — лише на сервері сайту.

Новий ключ: виберіть вид, за потреби підпис (де ключ використовується) і Створити ключ. Ключ показуємо один раз — скопіюйте його одразу; далі в списку лишається тільки його початок, дата створення й останнього використання.
Заміна без перерви: створіть новий ключ, вставте його в налаштування сайту, перевірте, що сайт працює, і тоді Відкличте старий. Відкликаний ключ перестає працювати одразу.
Останній діючий ключ свого виду відкликати не можна — спершу створіть новий. Нових ключів — до 10 за хвилину.

Ключами керують власник і адміністратори магазину.