waiter24.ai
Увійти Розпочати безкоштовно →

Документація

Технічна документація з підключення та налаштування AI Waiter.

Updated: 17.08.2026

Швидкий старт — будь-який сайт (ручний скрипт)

Підключення AI Waiter до будь-якого сайту займає два кроки:

  1. Скопіюйте свій ключ віджета та код вставки з розділу Інтеграція з сайтом у вашій панелі.
  2. Вставте код перед закривальним тегом </body> вашого сайту:
<script defer src="https://waiter24.ai/widget.js" data-key="ВАШ_КЛЮЧ"></script>

Це все — вигляд, тексти, мовну поведінку та функції віджета керуються з панелі, без змін коду. Він працює з будь-яким сайтом, зокрема SPA (React, Vue, Next.js) та конструкторами сайтів. Після зміни налаштувань оновіть сторінку сайту.

Рекомендований порядок налаштування

  1. Меню — завантажте свої страви. Якщо у вас інтернет-магазин, нативний плагін синхронізує їх автоматично; інакше імпортуйте з фото/PDF, завантажте JSON або додайте вручну. Див. Як завантажити меню в AI Waiter. AI рекомендує лише те, що є у вашому меню.
  2. Тест чату — поспілкуйтеся з асистентом у панелі перед запуском.
  3. Інтеграція з сайтом — вставте код (або підключіть плагін свого магазину) і зв’яжіть асистента з вашим сайтом.
  4. Налаштування віджету — виберіть режим віджета (асистент ресторану або служба підтримки), далі налаштуйте тексти, мову та функції.
  5. Про заклад — адреса, телефон, графік роботи по днях тижня і правила закладу (паркінг, Wi-Fi, оплата, бронювання, тварини). Асистент відповідає на питання про заклад лише з того, що ви тут вкажете.
  6. За потреби підключіть ботів Telegram і WhatsApp, налаштуйте зони доставки, програму лояльності, бронювання та інші функції з бічної панелі.

Асистент рекомендує лише страви, які є у вашому меню, тож завантажити його — найперша справа. Оберіть спосіб, який підходить до того, у якому вигляді ваше меню вже існує — способи можна поєднувати й переімпортовувати будь-коли.

  1. Нативний плагін магазину — найпростіший спосіб. Якщо у вас інтернет-магазин на WooCommerce, Shopify, Magento 2 чи Shopware, встановіть наш плагін/застосунок для нього. Він передає весь каталог товарів до AI Waiter і далі автоматично тримає його синхронізованим за розкладом — нові страви, зміни цін і розпродані позиції потрапляють без ручного переімпорту. Той самий плагін також вбудовує чат-віджет за вас. Див. Інтеграції e-commerce нижче.
  2. Фото або PDF меню. На сторінці Меню оберіть Імпорт із фото/PDF і завантажте знімок чи PDF паперового меню — AI прочитає його й створить категорії та страви за вас. Ідеально, коли онлайн-каталогу немає.
  3. Файл JSON. Оберіть JSON → Імпорт, щоб завантажити файл меню (спершу завантажте зразок, щоб побачити формат), або Експорт, щоб зробити резервну копію меню. Зручно для масового завантаження або перенесення меню між акаунтами.
  4. Вручну. Додавайте категорії, підкатегорії та страви прямо в редакторі Меню — з цінами, варіаціями, фото, вагою, тегами й інформацією про алергени/КБЖВ.
  5. Розміри, що імпортуються самими числами. Магазини часто називають розміри піци «24», «30», «40», а «см» лишають на фото. Задайте одиницю виміру розмірів один раз — на страві або одразу на всій категорії — і асистент скрізь казатиме «40 см» замість голого «40». Сам він одиницю ніколи не вгадує.

Кожен імпорт дозволяє обрати Замінити (вважати файл усім меню) або Оновити (оновити збіжні страви й додати нові). Страви, що зникли з імпорту, ховаються від асистента, а не видаляються — переімпортуйте, щоб повернути їх. Кожна спроба, ручна чи автоматична, відображається в історії імпорту на сторінці Меню.

Потрібно почати з чистого аркуша? Кнопка Очистити меню на панелі меню після підтвердження видаляє всі страви й категорії вибраного меню, але залишає саме меню — його назву, позначку головного та прив'язану QR-сторінку, — тож наступний імпорт потрапить туди ж.

Інтеграції e-commerce

Якщо у вас інтернет-магазин, встановіть нативний плагін/модуль для вашої платформи — це найпростіший спосіб завантажити меню й тримати його синхронізованим. Він автоматично передає каталог товарів до AI Waiter та вбудовує чат-віджет — ручний скрипт чи завантаження меню не потрібні.

WordPress / WooCommerce

Встановіть плагін, вставте свій токен імпорту з розділу Конфігурація сайту й натисніть Export Now — це перше натискання завантажує весь ваш каталог. Щоб він оновлювався без вашої участі, оберіть у полі Automatic Sync щоденно, щотижня чи щомісяця; на новому встановленні воно вимкнене, тож нічого не надсилається, доки ви самі цього не попросите.

Репозиторій та інструкція зі встановлення: github.com/waiter24ai/waiter24-woocommerce

Shopify

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

Репозиторій та інструкція зі встановлення: github.com/waiter24ai/waiter24-shopify

Magento 2

Встановіть модуль через Composer, введіть токен імпорту в адмін-конфігурації та натисніть Export Now. Коли захочете, щоб каталог оновлював щоденний cron, поставте Automatic Sync = Yes — на новому встановленні воно вимкнене, тож нічого не надсилається, доки ви самі цього не попросите.

Репозиторій та інструкція зі встановлення: github.com/waiter24ai/waiter24-magento2

Shopware 6

Встановіть плагін, налаштуйте токен імпорту в параметрах плагіна й запустіть експорт один раз. Увімкніть Automatic Sync, щоб щоденне заплановане завдання тримало каталог актуальним — на новому встановленні воно вимкнене, тож нічого не надсилається, доки ви самі цього не попросите.

Репозиторій та інструкція зі встановлення: github.com/waiter24ai/waiter24-shopware

Канали месенджерів

Telegram

Створіть бота через @BotFather, скопіюйте його токен і вставте в налаштуваннях Telegram у вашій панелі. Те саме меню, промпти та функції живлять бота — включно зі збором замовлень.

Особисті сповіщення: вгорі сторінки налаштувань Telegram можна також підписати ваш власний Telegram на сповіщення про замовлення/бронювання/callback через власного бота-сповіщувача waiter24.ai — без клієнтського бота і без пошуку chat ID. Одне натискання на посилання, і воно має пріоритет над полем «Telegram chat ID» нижче.

WhatsApp

Підключіться за допомогою облікових даних WhatsApp Business Cloud API (ID номера телефону та токен) у налаштуваннях WhatsApp. Налаштуйте webhook, як описано на тій сторінці, щоб почати отримувати повідомлення.

Оплата та підписка

Кожен новий акаунт починається з 14-денного безкоштовного періоду — повний доступ, картка не потрібна. Коли він завершується, оберіть тариф на сторінці Оплата, щоб асистент продовжив працювати.

Тарифи оплачуються щомісяця або щороку й списуються автоматично нашим платіжним провайдером — Paddle (міжнародні картки) або LiqPay (грн, для українського бізнесу). На кожне списання ви отримуєте email-квитанцію й можете скасувати будь-коли, зберігаючи доступ до кінця оплаченого періоду.

Якщо пробний період завершився без підписки або платіж за продовження не пройшов, чат-віджет і боти призупиняються до відновлення оплати — меню, налаштування та історія зберігаються. Усі деталі: посібник «Оплата та підписка».

Цифрове QR-меню

Перетворіть меню на публічну сторінку, яку гості відкривають, скануючи QR-код — без застосунку та реєстрації. Увімкніть її в розділі QR-меню у панелі, задайте логотип, короткий опис і мову відображення, потім завантажте зображення QR (PNG або SVG) і роздрукуйте.

Сторінка показує меню як зручний для мобільних акордеон (категорії → підкатегорії → страви) з фото, цінами, вагою, КБЖВ та алергенами. Страви з розмірами чи варіаціями мають список для вибору. Гість вмикає перемикач біля страви й збирає її в список обраного — вікно знизу екрана показує кожен вибір, обрану варіацію та загальну суму, і цей вибір переживає перезавантаження сторінки. Якщо ви вкажете кількість столів, ми згенеруємо по одному QR на стіл (table_1, table_2, …) плюс загальний — тоді скан вже знає стіл, і гість може одним дотиком викликати офіціанта чи замовити через асистента. Публічне посилання — це приватний відкликуваний токен: якщо роздрукований QR «втік», перегенеруйте його, і старі коди перестають працювати.

Ваше меню кількома мовами

QR-меню можна опублікувати більш ніж однією мовою, щоб іноземний гість читав ваші страви своєю. У блоці Мови в налаштуваннях QR-меню вкажіть, якою мовою меню вже написане, і додайте інші, якими хочете його показувати — доступно близько п'ятдесяти, включно з мовами справа наліво, як-от іврит та арабська. Збережіть — з'явиться панель Машинний переклад з рядком на кожну додану мову: натисніть Перекласти, і назви страв, описи, категорії, теги, вагу та підписи розмірів буде перекладено у фоні. На великому меню це кілька хвилин, і сторінку можна залишити — прогрес показується там само.

Ціни, числа й фото не змінюються ніколи. Угорі публічної сторінки з'явиться перемикач мов, а роздрукований QR-код і далі відкриває вашу оригінальну мову — тож додавання мови ніколи не означає передрук кодів. Переклади зберігаються по кожній страві й переживають повторний імпорт меню чи синхронізацію з вашим сайтом, а повторне натискання Перекласти доповнює лише нове, тож за вже перекладені страви ви не платите. Якщо ви переписали перекладену назву вручну, наступні запуски збережуть саме ваше формулювання. Ставтеся до машинного перекладу як до доброго чорновика, а не вичитаного меню: прочитайте публічну сторінку, перш ніж друкувати.

Кілька меню

Залежно від тарифу ви можете створити кілька меню — наприклад, основне, барну карту та сезонний бранч. Одне меню є головним: воно живить чат-віджет на вашому сайті та ботів Telegram/WhatsApp. Інші — додаткові меню, на які можна спрямувати QR-сторінку, і AI-консультант на тій QR-сторінці відповідає за меню, яке ця сторінка показує, тож барний QR ніколи не радитиме страви з кухонної карти. Створюйте, дублюйте, перейменовуйте чи змінюйте головне меню на сторінці Меню; лічильник там показує, скільки меню дозволяє ваш тариф.

Поширені запитання

Чи потрібно щось встановлювати на моєму сервері?

Ні. Достатньо одного рядка коду на вашому сайті — або нативного плагіна, якщо ви використовуєте WooCommerce, Shopify, Magento чи Shopware.

Як завантажити меню?

Чотири способи: наш нативний плагін магазину авто-синхронізує його з інтернет-магазину (найпростіше), AI-імпорт із фото/PDF читає паперове меню, імпорт файлу JSON — для масового завантаження, або вручну в редакторі. Див. Як завантажити меню в AI Waiter.

Як оновити меню?

Редагуйте його в розділі Меню вашої панелі — зміни доходять до асистента миттєво, без змін коду на сайті. Якщо меню надходить з інтернет-магазину через наш плагін, просто оновіть товари там — і наступна синхронізація автоматично перенесе зміни.

Чи можу я використовувати власний ключ AI-провайдера?

Так — увімкніть «Використовувати власний API-ключ» у Налаштуваннях AI та виберіть провайдера (OpenAI, Gemini, Mistral та інші, або власний endpoint).

Що станеться, коли досягнуто денного ліміту?

Чат ввічливо повідомляє гостю, що тимчасово недоступний, а ви отримуєте сповіщення. Ліміти скидаються щодня в часовому поясі вашого ресторану.

Як гості бачать меню без чату?

Увімкніть QR-меню, роздрукуйте згенерований QR-код — і гості, скануючи його, відкривають охайне мобільне цифрове меню: категорії, фото, ціни, КБЖВ та список обраного, мовою, яку ви оберете. Без застосунку та реєстрації.

Чи можу я мати кілька меню?

Так, якщо дозволяє тариф. Головне меню керує асистентом на сайті та ботами; додаткові меню можна створити або продублювати на сторінці Меню і прив'язати до QR-сторінки — її власний AI-консультант тоді відповідає саме за цим меню. Будь-яке меню можна будь-коли зробити головним.

Як розповісти гостям про акції, що діють зараз?

Є три місця — залежно від того, хто застосовує знижку. Знижена ціна на одну страву вписується в поле Акційна ціна цієї страви в редакторі меню: асистент називає нову ціну, і сума замовлення рахується по ній. Код, який гість вводить сам, створюється в розділі Промокоди: сервер перевіряє його і застосовує знижку. Усе інше — «друга піца за півціни», святкове меню, щаслива година — описується на сторінці Акції та розписання разом із датами, днями тижня або годинами дії; асистент згадує акцію лише в цей період. Такі акції асистент озвучує, а не обчислює, тому вкажіть, хто застосує знижку: ваше оформлення замовлення чи персонал.

Потрібне щось індивідуальне?

Якщо вашої платформи немає в списку або вам потрібна індивідуальна інтеграція, зверніться до нашої служби підтримки, і ми допоможемо.