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-ключ нікуди вводити не треба — ключ у публічному віджеті побачив би будь-хто. Актуальні ціни — у магазині модулів і гаманці, не тут.

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

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