Додайте Quickchat AI на сайт як плаваючий Widget, вбудований Вбудувати або окрему Сторінка чату. Інструкції з установлення, доступу, оформлення, текстів і власних параметрів.
Є три способи розмістити AI-агента Quickchat у вебі. Оберіть формат, що відповідає вашому завданню:
- Widget: плаваюча кнопка чату в кутку сайту. Найкраще підходить для загальної підтримки.
- Вбудувати: вбудоване вікно чату саме в потрібному місці сторінки. Зручно для окремого екрана застосунку, сторінки довідкового центру або товару.
- Сторінка чату: повноекранний чат, розміщений на Quickchat, без установлення й коду. Підходить, коли потрібно поділитися посиланням, наприклад у листі підтримки, внутрішньому Slack або з бета-тестувальниками, нічого не змінюючи в їхньому браузері.
Установіть обраний формат у Канали → Ваш сайт → Встановлення. Сторінка має три вкладки: Встановлення для вибору способу додавання агента, Вигляд для оформлення та Текстовий вміст для текстів і підписів, які бачать відвідувачі. На вкладці Встановлення спочатку пропонується вибір способу, доступність і доступ винесено в окремий розділ, а Scenario ID, потрібний плагінам і API, можна скопіювати.
Додаткові інструменти налаштування
Section titled “Додаткові інструменти налаштування”-
Порівняйте способи розгортання. Зіставте вказані канали, доступ до сайту й потрібні функції з варіантами налаштування Quickchat AI. Інструмент не перевіряє ваш сайт чи обліковий запис.
-
Порівняйте HTML і Markdown зразкової сторінки. Отримайте початковий HTML, Markdown-вміст і посилання на інструменти з фіксованого прикладу Quickchat AI. Інструмент не виконує JavaScript і не перевіряє довільні сайти.
Widget
Section titled “Widget”Widget дає змогу додати AI-агента Quickchat безпосередньо на сайт, щоб відвідувачам було зручно спілкуватися з AI. Зазвичай це кнопка чату в правому нижньому кутку. Після натискання вона відкриває вікно, де можна ставити запитання, отримувати допомогу та шукати інформацію.
Як додати Widget на сайт
Section titled “Як додати Widget на сайт”Відкрийте Канали → Ваш сайт → Встановлення. Вкладка починається із запитання «Як ви хочете додати AI-агента?» і переліку способів установлення, починаючи з найпростіших. Оберіть відповідний для вашого сайту:
- WordPress: установіть безкоштовний плагін Quickchat AI Agent і вставте Scenario ID. Widget з’явиться автоматично, без редагування коду теми.
- Shopify: додайте Widget через Theme Editor магазину. Дивіться інструкцію для Shopify.
- Webflow, Wix та інші: скопіюйте один фрагмент і вставте його в налаштування власного коду для всього сайту, застосувавши до всіх сторінок. Не використовуйте елемент Вбудувати або HTML на окремій сторінці. Дивіться Конструктори сайтів.
- Поділитися посиланням натомість: нічого не встановлюйте, а поділіться посиланням на Сторінка чату.
- Установити вручну з кодом: скопіюйте код Widget або Вбудувати і самостійно вставте його в HTML.
Кожен спосіб відкриває окрему покрокову панель лише з потрібним кодом або ідентифікатором.
Ваш Scenario ID розташований угорі вкладки Встановлення у полі для копіювання. Це ідентифікатор для плагінів і API. Копіюйте його звідси, коли він потрібен на кроці налаштування.
Установлення вручну за допомогою коду
Section titled “Установлення вручну за допомогою коду”Якщо ви самі керуєте HTML, розгорніть Установити вручну з кодом на вкладці Встановлення і виконайте такі дії:
- Скопіюйте фрагмент Widget.
- Відкрийте HTML-файл сторінки. У конструкторі використовуйте налаштування коду для всього сайту, як описано в розділі Конструктори сайтів.
- Вставте фрагмент безпосередньо перед закривальним тегом
</body>на кожній сторінці, де потрібен Widget.
Перевірте фрагмент Widget на відповідність указаному Scenario ID. Перевірка читає вставлений код, але не завантажує ваш сайт.
Конструктори сайтів
Section titled “Конструктори сайтів”У Webflow, Wix, Squarespace, Hostinger та подібних конструкторах додайте Widget один раз через налаштування коду для всього сайту:
- Відкрийте налаштування, яке додає код на кожну сторінку. Воно може називатися Custom code, Code injection, Footer code або Body end.
- Вставте фрагмент Widget і застосуйте його до всіх сторінок. Якщо можна обрати розташування, вкажіть нижній колонтитул або кінець body. Фрагмент не працює в head.
- Опублікуйте сайт. Кнопка чату з’явиться на кожній сторінці.
Не додавайте Widget через елемент Embed або HTML на окремій сторінці. Багато конструкторів показують такі елементи в невеликому окремому фреймі, де Widget не може відкритися. Навіть якщо він завантажиться, його буде видно лише на цій сторінці.
Де знайти налаштування для всього сайту:
| Конструктор | Налаштування коду для всього сайту |
|---|---|
| Webflow | Site settings → Custom code → Footer code |
| Wix | Settings → Custom Code, потім All pages і Body - end. Потрібен підключений домен. |
| Squarespace | Custom Code → Code Injection → Footer. Плани Core, Plus, Advanced і деякі попередні плани. |
| Hostinger Website Builder | More (⋯) → Integrations → Custom code. Скрипти автоматично завантажуються в кінці сторінки. |
Меню можуть змінюватися й бути перекладені мовою конструктора. Якщо ваш конструктор або план не має налаштування коду для всього сайту, поділіться посиланням на Сторінка чату.
Потрібна допомога?
Section titled “Потрібна допомога?”Ви не розробник? На вкладці Встановлення у розділі Потрібна допомога? є два варіанти:
- Попросити AI про допомогу: відкриває помічника в застосунку з уже підготовленим запитанням про додавання агента на сайт.
- Надіслати інструкції розробнику: надсилає колезі все потрібне, зокрема код Widget, Scenario ID та посилання на цю інструкцію, щоб він міг виконати встановлення.
По додаткову допомогу звертайтеся на contact@quickchat.ai.
Сторінка чату
Section titled “Сторінка чату”Сторінка чату є повноекранною версією AI-агента за URL Quickchat. Нічого встановлювати не потрібно: поділіться посиланням, і відвідувачі зможуть спілкуватися з агентом у браузері. Використовуйте цей формат, якщо:
- Вам потрібен чат, але немає сайту або ви не хочете змінювати його код.
- Ви ділитеся AI з невеликою групою, наприклад бета-тестувальниками, командою підтримки чи потенційними клієнтами, і потрібне посилання з контролем доступу замість публічного віджета.
- Ви хочете надіслати AI як додатковий канал спілкування електронною поштою, у Slack або CRM.
Налаштуйте, хто може відкривати Сторінка чату, у Встановлення → Доступ до сторінки чату. Дивіться Контроль доступу нижче.
Початок нової розмови
Section titled “Початок нової розмови”Щоб почати чат із чистого аркуша:
- Widget або Вбудувати: Відкрийте чат і натисніть кнопку з олівцем у квадраті у правому верхньому кутку вікна.
- Сторінка чату: Оберіть New chat на бічній панелі або скористайтеся кнопкою з олівцем у квадраті в заголовку.
Це починає нову розмову з AI-агентом. Попередня залишається в Вхідні. Закриття й повторне відкриття Widget або оновлення сторінки може продовжити поточну розмову. Прохання до AI «скинути» чи «очистити чат» не створює нової розмови. Очищати cookies браузера не потрібно.
Контроль доступу
Section titled “Контроль доступу”На вкладці Встановлення налаштування доступу містяться в розгортному розділі Доступність і доступ. У ньому є два елементи керування розгортанням:
Widget & Вбудувати access
Section titled “Widget & Вбудувати access”Перемикач угорі Доступність і доступ. Коли він увімкнений, скрипти Widget і Вбудувати працюють у браузерах відвідувачів. Коли вимкнений, Widget і Вбудувати недоступні на сайті, навіть якщо код залишається вставленим. Це дає змогу тимчасово вимкнути AI без видалення коду або обмежити публічний доступ, залишивши Сторінка чату для запрошених користувачів.
Доступ до сторінки чату
Section titled “Доступ до сторінки чату”Незалежно від перемикача Widget і Вбудувати ви можете обмежити доступ до Сторінка чату:
- Будь-хто: URL Сторінка чату публічний. Ним може користуватися кожен, хто має посилання.
- Лише запрошені користувачі: Для доступу до Сторінки чату потрібно ввійти в обліковий запис і мати роль у цього AI-агента. Для людей, яким потрібне лише спілкування, виберіть роль Користувач чату.
- Ніхто: Сторінка чату повністю вимкнена.
Посилання Запросити користувачів чату відкриває Налаштування → Організація → Учасники команди. Виберіть Користувач чату у формі запрошення, щоб надати доступ до Сторінки чату без доступу до панелі керування. Для запрошень потрібні вільні місця, а старий тариф Basic не дозволяє вибирати роль. Ліміти тарифів наведено на сторінці Учасники команди та ролі.
Налаштування вигляду
Section titled “Налаштування вигляду”Вкладки Вигляд і Текстовий вміст дають змогу змінювати вигляд Widget, Вбудувати і Сторінка чату та тексти для відвідувачів. Усі три формати використовують спільні налаштування: достатньо змінити їх один раз, і вони застосуються всюди, де розгорнуто агента.
Права панель вкладок Встановлення, Вигляд і Текстовий вміст має власне керування попереднім переглядом. Перемикайтеся між Widget, Вбудувати і Сторінка чату, а також між Комп’ютер і Мобільний, щоб побачити зміни перед публікацією.
Вигляд
Section titled “Вигляд”Візуальні налаштування згруповані в Брендинг, Size & Position, Тема та Інші налаштування.
Брендинг
Section titled “Брендинг”- Аватар AI-агента: зображення профілю або логотип агента. Одне зображення розміром до 5 MB використовується в заголовку чату й на кнопці запуску. Це одне налаштування, а не два: завантажте зображення один раз, і воно з’явиться в обох місцях замість колишніх окремих логотипа заголовка й іконки запуску. Кожен агент має вбудований стандартний аватар. Скинути до стандартного відновлює його, а видалення прибирає аватар зовсім. Доступно на всіх планах, включно з Free.
Аватар AI-агента застосовується до Widget, Вбудувати і Сторінка чату, але не до Discord: там аватар бота береться з його Discord-застосунку. Дивіться Discord.
Size & Position
Section titled “Size & Position”- Розмір кнопки чату: Класичний, Лише поле введення або Малий. Визначає вигляд елемента запуску до відкриття чату.
- Закриття елемента запуску: варіант Класичний має маленьку кнопку закриття справа вгорі. На комп’ютері вона з’являється при наведенні, на сенсорному пристрої видима завжди. Вона приховує віджет лише для поточного перегляду сторінки; після наступного завантаження він повертається. Інші розміри не мають кнопки закриття.
- Напис кнопки чату: показується лише для Малий. Це власний текст на маленькій кнопці, до 25 символів, наприклад «Запитати AI» або «Чат». Залиште порожнім, щоб показувати лише іконку.
- Положення віджета: знизу ліворуч, посередині або праворуч.
- Chat window dimensions: ширина 300–700px і висота 400–1200px.
- Кнопка чату з перетягуванням: дозволяє відвідувачам перетягувати кнопку запуску. Корисно, коли вона перекриває важливий вміст.
Оберіть кольори чату:
- Світла і Темна є фіксованими стилями, однаковими для всіх облікових записів.
- Власний варіант відкриває власну палітру. Доступні кольори фону, заголовка й тексту заголовка, акценту для кнопок початку чату, підказок і оцінювання, бульбашок повідомлень та їхнього тексту, тексту AI, link color, поля введення, рамок тощо. Кожна пара кольорів перевіряється на контраст WCAG AA, а складні для читання поєднання супроводжуються попередженням.
Фірмові кольори заголовка й акцентів належать до Власний варіант. Світла і Темна залишаються нейтральними стилями, тож перемикання між ними не переносить власні кольори.
У розділі Прозорість параметр Тло визначає прозорість вікна. Він працює в усіх темах, а відтінок задається темою:
- Суцільний: суцільний непрозорий фон. Це стандартний варіант.
- Скло: вікно стає напівпрозорим, а сайт за ним розмивається, як за матовим склом. Відтінок білий у Світла, темний у Темна і відповідає вашому фону в Власний варіант. У Власний варіант заголовок, колір якого відрізняється від фону, зберігає цей колір, щоб брендинг залишався помітним. Непрозорість скла задає силу перекриття сторінки: від мінімуму, що зберігає читабельність тексту на будь-якому сайті, тобто 50% у Світла, 65% у Темна і залежно від кольорів у Власний варіант, до 95%. Якщо жодне значення не забезпечує читабельність із вашими кольорами Власний варіант, віджет використовує суцільний фон, а налаштування пояснюють причину. Скло залишається обраним і знову застосовується після зміни кольорів тексту або фону для достатнього контрасту.
Прозорість працює для Widget, зокрема на телефонах, і для Вбудувати. Повноекранна Сторінка чату завжди має суцільний фон. Відвідувачі, які ввімкнули на пристрої зменшення прозорості, бачать Суцільний у Chrome та Edge, які передають це налаштування сайтам. У браузері без підтримки розмиття Скло залишається майже непрозорим для читабельності.
У режимі Власний варіант Сторінка чату також має власні кольори бічної панелі: Тло бічної панелі, Текст бічної панелі, Наведення в бічній панелі і Текст бічної панелі при наведенні. Вони застосовуються лише до повноекранної Сторінка чату, а не до Widget чи Вбудувати. Якщо не задавати кольори тексту, Сторінка чату автоматично підбере читабельний варіант для обраного фону.
Також можна змінити corner radius, тобто округлення повідомлень, полів і кнопок, та text size. Обидва параметри працюють у кожній темі.
Інші налаштування
Section titled “Інші налаштування”- Голосове введення: дає змогу записати голосове повідомлення через мікрофон у чаті. Запис перетворюється на текст у полі введення, який можна відредагувати перед надсиланням. Запис автоматично завершується через дві хвилини. Доступно на платних планах.
- Вкладення файлів: дозволяє додавати до повідомлення зображення або документ. Увімкнено за замовчуванням; вимкнення прибирає кнопку вкладення.
- Автовідкриття віджета: автоматично відкриває Widget після завантаження сторінки.
- Приховати брендинг Quickchat AI: приховує підпис «Powered by Quickchat AI» для повністю власного брендингу. Доступно в планах із white-labeling.
Щоб відвідувачі могли оцінювати розмови, відкрийте Розмови → Аналітика → Оцінка розмови. На цій вкладці є і налаштування, і результати. Дивіться Conversation Rating.
Текстовий вміст
Section titled “Текстовий вміст”Відкрийте Канали → Ваш сайт → Текстовий вміст, щоб змінити привітання та інші тексти для відвідувачів:
- Текст заголовка: текст угорі вікна чату.
- Привітальне повідомлення: перше повідомлення AI-агента на початку кожної розмови, наприклад «Вітаю! Вам потрібна допомога?».
- Показувати спливним: показує привітання як плаваючу бульбашку поруч із кнопкою запуску, щоб привернути увагу до натискання. Іноді це називають тизером або повідомленням запуску. Бульбашка показує сам текст Привітальне повідомлення, тож змінюйте це поле для редагування повідомлення.
- Початкові фрази: до 3 прикладів повідомлень, які видно до початку введення. Натискання надсилає обраний приклад як перше повідомлення. Це допомагає спрямувати відвідувачів до сильних сторін AI, наприклад «Як установити віджет?» або «Які інтеграції ви підтримуєте?».
- Підказка поля введення: підказка в порожньому полі введення.
- Текст застереження: текст на тлі розмови, зазвичай із поясненням, що користувач спілкується з AI. Радимо зробити його зрозумілим і помітним.
Розділ Екран перед чатом розташований під цими полями на тій самій вкладці Текстовий вміст. Увімкніть його там і відредагуйте заголовок, кнопку та текст повідомлення.
Стандартний віджет сайту показує на цьому екрані заголовок, повідомлення та кнопку початку розмови. Полів електронної пошти чи телефону тут немає, тож зробити ці дані обов’язковими перед початком чату не можна. Розумний збір даних може запитати їх під час розмови. Для обов’язкового збору контактів перед наданням доступу до чату потрібна окрема форма на сайті або власна інтеграція.
Мови й переклади
Section titled “Мови й переклади”За замовчуванням усі відвідувачі бачать Текстовий вміст саме так, як ви його ввели. На платних планах можна додати переклади для окремих мов, щоб віджет показувався мовою відвідувача.
- Відкрийте Текстовий вміст і натисніть Перекласти у розділі Інші мови. Відкриється панель Перекласти текст віджета, де початковий текст показано поруч із кожним перекладом як За замовчуванням (джерело).
- Натисніть Додати мову й оберіть мову. Quickchat AI створить переклад поточних текстів. Перегляньте й відредагуйте заголовок, привітання, початкові повідомлення, підказку введення, екран перед чатом і дисклеймер. Зміни зберігаються автоматично.
- Порожні поля використовують стандартний текст, тож перекладайте лише те, що хочете змінити. Якщо автоматичний переклад не вдасться, текст можна ввести самостійно.
Кількість доступних мов залежить від плану.
Як обирається мова відвідувача
Section titled “Як обирається мова відвідувача”Для Widget і Вбудувати Quickchat визначає мову в такому порядку:
- Явне перевизначення в завантажувачі:
_quickchat("language", "de"), викликане перед_quickchat("init", ...). - Атрибут
<html lang>сторінки: наприклад,<html lang="de">вмикає німецький переклад. Це рекомендований підхід: правильно задайтеlangна кожній локалізованій сторінці, і віджет автоматично його використає. - Мова браузера відвідувача, а потім текст Типовий, якщо збігів немає.
Якщо для мови відвідувача немає перекладу, він завжди бачить текст Типовий. Нічого не залишається порожнім.
Розширені можливості: власні параметри
Section titled “Розширені можливості: власні параметри”Widget і Вбудувати Quickchat AI дозволяють передавати власні параметри під час ініціалізації. Їх можна використовувати, щоб:
- розширювати аналітику; параметри доступні в CSV-експорті платформи Quickchat;
- передавати значення в API Actions і, де дозволено, персоналізувати відповіді. AI отримує відфільтровану частину, а не всі параметри. Дивіться Контекст моделі та авторизація.
Приклади корисних параметрів:
visitor_name:Mikecustomer_tier:VIPorder_id:ord_123
visitor_name є розпізнаваним ключем контакту. Власні ключі, наприклад customer_tier, можна зберігати та використовувати в Actions, але сама їх передача не гарантує використання AI у відповіді. Значення з браузера є неперевіреним вводом, а не дозволом на доступ до облікового запису клієнта.
Щоб додати такі параметри, вставте наведений виклик у скрипт із Ваш сайт > Встановлення.
Widget і Вбудувати використовують однаковий формат виклику:
_quickchat("custom_params", { "visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123",});Ці атрибути додаються до кожної нової розмови. Радимо обмежитися кількома ключами.
Власні параметри з назвами у snake_case, наприклад order_id і customer_tier, можна безпосередньо підставляти в API Actions як {{metadata_order_id}}, {{metadata_customer_tier}} тощо. Докладніше в AI Action Variables.
Приклад скрипту:
widget
<script> (function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat"); _quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"}); _quickchat("init", "abcdefghij");</script>Вбудувати
<div id="quickchat-embedded" style="height:600px;overflow:hidden;"></div><script> (function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat"); _quickchat("containerId", "quickchat-embedded"); _quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"}); _quickchat("init", "abcdefghij");</script>Вбудувати
Section titled “Вбудувати”Вбудувати розміщує AI-агента Quickchat безпосередньо в сторінці як вбудоване вікно замість плаваючої кнопки. Використовуйте його, якщо чат має займати конкретне місце: колонку довідкового центру, контактну сторінку, бічну панель застосунку тощо.
Як додати Вбудувати
Section titled “Як додати Вбудувати”-
Отримайте код Вбудувати
- Увійдіть у Quickchat AI App.
- Перейдіть у Канали → Ваш сайт на лівій бічній панелі.
- Відкрийте Встановлення, а потім розгорніть Установити вручну з кодом.
- Скопіюйте Вбудувати snippet, що містить контейнер
<div id="quickchat-embedded">і скрипт завантаження.
-
Відкрийте HTML-файл сайту або сторінку в конструкторі.
-
Вставте код
- Додайте фрагмент Вбудувати у
<body>сторінки. - Розмістіть його саме там, де потрібне вікно чату. Розмір задає
<div>: змінітьstyle="height:600px"відповідно до місця у вашому макеті. - У конструкторі додайте елемент коду або HTML у потрібному місці й вставте фрагмент у нього.
- Додайте фрагмент Вбудувати у
Вбудувати працює лише тоді, коли конструктор вставляє код безпосередньо в сторінку. Деякі конструктори, зокрема Wix, показують HTML-елементи в окремому фреймі, де Вбудувати не завантажується. Якщо чат не з’являється на опублікованій сторінці, додайте Widget через налаштування коду для всього сайту або поділіться посиланням на Сторінка чату.