AI-чат на сайті

Модуль AI-чат додає на кожну сторінку магазину віджет консультанта. Він відповідає покупцям за даними самого магазину — каталог, наявність, умови доставки й оплати, сторінки сайту, статус замовлення — і передає розмову менеджеру, щойно потрібна людина. Менеджер відповідає з адмінки, і відповідь зʼявляється в тому самому вікні чату, яке покупець уже відкрив.

Що бачить покупець

• Кнопку чату в нижньому куті (ліворуч або праворуч, у вибраному кольорі) і ваше привітання. Привітання показується до першого запитання і нічого не коштує.
• Відповіді мовою запитання; у відповідях про товари — справжні посилання на картку товару чи результати пошуку, тож «так, беру» закінчується кошиком, а не допитом.
• Якщо увімкнена форма замовлення, бот може запропонувати коротку форму імʼя + телефон на обговорюваний товар — працює як «купити в 1 клік», замовлення потрапляє в загальний список зі статусом «Нове».
• Статус замовлення за номером і телефоном; залогінений покупець бачить свої замовлення без повторного введення телефону.
• Варіант «Зателефонуйте мені» / «Потрібен дзвінок менеджера» і після передачі — повідомлення «Ваше звернення передано менеджеру. Відповідь зʼявиться тут, у цьому вікні». Коли менеджер на звʼязку, шапка каже «З вами менеджер» і пропонує «повернутись до бота».
• Якщо кредити скінчились або шлюз недоступний, покупець бачить ваше повідомлення про недоступність, а не помилку.

Історія розмови й id покупця зберігаються лише на сервері; браузер надсилає тільки запитання. Нова вкладка продовжує ту саму розмову.

Де налаштовується

Налаштування → AI chat (consultant) (/admin/ai-chat). Сторінка починається з картки Готовність — чотири перевірки, які мають бути зеленими, щоб віджет заговорив:

Перевірка	Що означає
Модуль увімкнено	сам модуль ai_chat активний
Модуль headless_api активний	бот отримує дані магазину тільки через комерційний адаптер цього модуля
Комерційний адаптер доступний	адаптер відповідає
Гаманець	баланс кредитів магазину; Поповнити веде до гаманця

Нижче картка Статистика: діалогів усього і сьогодні, передано менеджеру, витрачено кредитів.

Віджет

Налаштування	Значення
Показувати на сайті	головний вимикач; після встановлення вимкнений, щоб свіжа інсталяція не витрачала гаманець сама
Заголовок	шапка панелі чату
Привітання	перше повідомлення, показується до запитання (безкоштовно)
Підказка в полі вводу	текст-підказка в полі повідомлення
Розташування	праворуч або ліворуч
Колір	акцентний колір кнопки й панелі

Поведінка

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

Ліміти

Налаштування	Типово	Значення
Пам'ять діалогу	12	скільки попередніх реплік бот тримає в контексті; більше — розумніше й дорожче, бо історія відправляється щоразу
Кроків на відповідь	6	скільки разів бот може звернутись до даних магазину заради однієї відповіді — стеля, щоб зациклений пошук не витрачав кредити мовчки
Повідомлень з однієї сесії за годину	40	захист гаманця від автоматичного спаму

Кнопка Діалоги (/admin/ai-chat/dialogs) показує всі розмови: остання активність, кількість реплік, витрачені кредити, покупець (id або гість) і чи передано менеджеру; рядок відкриває транскрипт.

Передача менеджеру в обидва боки

1. Покупець просить людину (або бот розуміє, що не допоможе, або покупець просить оформити замовлення за нього). З увімкненим Передавати менеджеру модуль відкриває тред у Меседжер (діалоги) (/admin/messenger) з позначкою Чат на сайті і транскриптом та створює задачу в CRM.
2. Відтоді повідомлення покупця йдуть просто в тред і не викликають модель — кредити не списуються. Тред показує лічильник непрочитаних.
3. Менеджер відкриває тред і пише відповідь. Нікуди нічого не «надсилається»: відповідь зберігається, а віджет сам забирає її кожні кілька секунд, поки панель відкрита. Покупець бачить її від «Менеджер» — логін оператора не показується ніколи.
4. Покупець будь-коли повертається до бота посиланням «повернутись до бота» в шапці панелі.

Сповіщення поки немає

Передача менеджеру дає непрочитаний тред у Меседжері й задачу в CRM — без листа, SMS чи Telegram менеджеру. Хтось має стежити за діалогами.

Що для цього потрібно

• Чотири пакети, а не один: модуль ai_chat, headless_api (адаптер, через який бот читає дані), messenger (відповіді менеджера) і ai_content (AI-шлюз). Без будь-якого з них віджет мовчить або віддає помилку замість відповіді. Усі ставляться з магазину модулів; ai_chat — платний ліцензований пакет.
• Кредити в гаманці магазину (Налаштування → Гаманець). Кожна відповідь бота списується з гаманця через AI-шлюз artexgroup.org. Свій AI-ключ нікуди вводити не треба — ключ у публічному віджеті побачив би будь-хто. Актуальні ціни — у магазині модулів і гаманці, не тут.

До чого бот має доступ

Перелік у «Що бот уміє» — повний список того, що модуль може зробити з магазином. Читає він лише через комерційний адаптер; єдина дія, що пише, — форма замовлення в чаті, і вона створює звичайне замовлення, видиме у списку замовлень як будь-яке інше.

Дані покупця й AI-консультант

Помічник відповідає мовною моделлю, а модель — не в магазині. Нижче — що саме виходить за межі магазину, хто це зберігає і як довго. Цей розділ можна цитувати в політиці конфіденційності сайту як є.

Що йде в модель

• Текст повідомлень покупця в чаті й відповіді помічника.
• Назва магазину, мова відповіді, адреса сторінки, з якої написано, і назви товарів, які покупець щойно переглядав у цьому візиті.
• Результати запитів до даних магазину: товари, ціни, наявність, варіанти, категорії, умови доставки й оплати, тексти інформаційних сторінок.
• Номер замовлення й телефон — якщо покупець сам їх написав, питаючи про статус замовлення. Без них магазин не має права показати замовлення взагалі.
• Імʼя, телефон, e-mail — якщо покупець сам назвав їх у розмові, просячи звʼязку з менеджером.
• Для покупця, який увійшов у свій акаунт і питає про свої замовлення, — склад, статус і сума цих замовлень, а також адреса доставки й коментар, збережені в них.

Що НЕ йде в модель

• Те, що покупець вводить у форму замовлення в чаті: імʼя, телефон, адреса, коментар, кількість. Форму приймає магазин напряму, а в розмову лягає лише рядок «Замовлення №N прийнято».
• Підказка «доставити туди ж, куди минулого разу»: вона формується на сервері магазину і показується тільки покупцю в браузері.
• Паролі, платіжні дані, куки, IP-адреса.

Голосові повідомлення

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

Що зберігає магазин

У власній базі: саму розмову (повідомлення покупця й відповіді помічника), випадковий ключ сесії з cookie, ідентифікатор покупця, якщо він увійшов в акаунт, мову й адресу сторінки, з якої почалась розмова. За замовчуванням — без обмеження строку. Поле «Зберігати розмови, днів» у налаштуваннях помічника вмикає автоматичне прибирання: розмови, до яких ніхто не звертався довше за вказаний строк, щоночі видаляє задача планувальника ai-chat:prune. Значення 0 означає «не видаляти нічого» — саме воно стоїть після оновлення, щоб оновлення модуля не забрало те, що магазин уже накопичив.

Що зберігає AI-шлюз (artexgroup.org)

Лише технічний журнал звернень: домен магазину, назву моделі, лічильники токенів, списані кредити, причину завершення відповіді, перелік викликаних інструментів і псевдонімний ідентифікатор розмови (необоротний хеш). Тексту розмови в журналі немає — ані повідомлення покупця, ані відповіді помічника. Більше ніде шлюз розмову не зберігає.

Що зберігає провайдер моделі

Магазину відповідає одна з моделей: Qwen (Alibaba Cloud Model Studio, міжнародний регіон, Сінгапур) — основна, Google Gemini — резервна.

Голосове запитання розпізнає окрема модель, і це не та сама модель, що відповідає в чаті. Основний розпізнавач голосу — Google Gemini (gemini-asr), резервний — OpenAI Whisper (whisper-1): якщо основний не відповів, шлюз пробує резервний, тож запис може поїхати і туди. Порядок задано на шлюзі (asr_model / asr_model_fallback), у налаштуваннях модуля його немає.

Провайдер	Навчання на даних API	Скільки зберігає	Нульове зберігання
Google (Gemini API, платний доступ) — резервна модель чату і основний розпізнавач голосу	ні — умови прямо це виключають	«обмежений час», лише для виявлення порушень правил; конкретного числа днів в умовах не названо	окремого режиму в умовах не описано
OpenAI (Whisper) — резервний розпізнавач голосу	ні за замовчуванням	до 30 днів логів для контролю зловживань; для ендпоінтів розпізнавання мовлення логів зловживань не зберігається	Zero Data Retention доступне для цих ендпоінтів за окремим погодженням з OpenAI
Alibaba Cloud Model Studio (Qwen)	не підтверджено	не підтверджено	не підтверджено

Джерела, перевірені 23 серпня 2026 року: умови Gemini API, OpenAI API data controls. Офіційних умов Alibaba Cloud Model Studio знайти не вдалося — тому в цій таблиці стоїть «не підтверджено», а не припущення. Окремих умов саме для розпізнавання мовлення Gemini API не описує — діють ті самі умови API, що й для тексту, тож голос підпадає під той самий рядок таблиці.

Нульове зберігання поки не увімкнено

Режим zero-retention не увімкнено на шлюзі в жодного з провайдерів. Це домовленість із провайдером, а не перемикач у налаштуваннях модуля.

Як покупцю видалити свою розмову

Кнопка «Почати спочатку» у вікні чату відкриває нову розмову, але не видаляє попередню — вона лишається в магазині, бо саме її читає менеджер, коли покупець попросив людину. Щоб видалити саму розмову, покупець звертається до магазину, і власник видаляє її зі своєї бази. Копію розмови покупець може надіслати собі на e-mail прямо з вікна чату, якщо магазин лишив цей пункт увімкненим.

Куди звертатися

• Про дані в конкретній розмові — до магазину, за контактами з його сторінки контактів: розмова лежить у базі магазину, і видаляє її власник магазину.
• Про роботу самого AI-шлюзу — до artexgroup.org, за контактами зі сторінки підтримки.