Чат Elbuz сам складає посилання на товар і статтю з адреси сайту, мовного префікса й SEO-адреси, тож покупець, який відкрив чат на російській версії сайту, потрапляє на товар на /ru/-версії, а не на основній.
Коли це знадобиться:
- Основна мова сайту без префікса, друга — з
/ru/— шаблон{site_url}/{language_code}/{url}дає обидві адреси правильно. - Товари з чату відкриваються не на тій сторінці — шаблон замінює адресу з каталогу на ту, що прийнята на вашому сайті.
- Товари завантажено з іншого сайту чи маркетплейсу — посилання береться зі зв'язку з цим джерелом.
З чого почати: вкладка «Посилання» → «Шаблон посилання на товар» → вставте шаблон.
Що налаштовується
- Адреса сайту — основа всіх посилань чату.
- Адреса товару — з яких частин складається посилання в картці товару в чаті.
- Мова в адресі — префікс
/ru/,/en/для кожної мови сайту. - Адреса статті — посилання, яке AI дає у відповіді «детальніше тут».
- Адреса з іншого сайту — для товарів, завантажених зі стороннього джерела.
- Фото і кошик — картинки товарів і перехід до кошика сайту.
- API магазину — зв'язок із модулем магазину для статусів замовлень.
Шаблони діють одразу: чат складає посилання щоразу, коли показує товар чи статтю, тож нова адреса з'явиться вже в наступній відповіді. Оновлювати індекс чи код на сайті не потрібно.
Адреса сайту
Поле «Адреса сайту» стоїть на вкладці «Налаштування», у картці «Сайт». З нього береться {site_url} у шаблонах, а якщо шаблону товару немає — початок посилання на товар. Пишіть адресу повністю, з https://: кінцева похила риска не заважає, чат її прибирає.
Порожня адреса дає відносні посилання на кшталт /smartfon-galaxy. На сайті, де стоїть чат, вони працюють, а в месенджерах і в листах — ні. Без цієї адреси не працює й SDK відеоконсультанта: на вкладці «Аватар» з'явиться попередження.
Як скласти посилання на товар
Посилання на товар чат складає за полем «Шаблон посилання на товар». Шаблон — адреса, у якій частини, що відрізняються в кожного товару, записано макросами у фігурних дужках.
| Макрос | Що підставляється | Приклад |
|---|---|---|
{site_url} | «Адреса сайту» з вкладки «Налаштування» | https://myshop.ua |
{language_code} | SEO-префікс мови сторінки, на якій відкрито чат, — з «Довідники → Мова». Це не код мови: в основної мови префікс зазвичай порожній | ru або нічого |
{url} | SEO-адреса товару з каталогу | smartfon-galaxy-a57 |
{external_url} | посилання на товар із зовнішнього джерела (нижче) | https://rozetka.com.ua/… |
{product_ext_url} | поле «Посилання» картки товару як є, без змін | повна адреса з картки |
Типовий шаблон — {site_url}/{language_code}/{url}. Подвійні похилі риски, які виходять, коли префікс порожній, чат прибирає сам: https://myshop.ua//smartfon стає https://myshop.ua/smartfon.
Порожній шаблон не вимикає посилань: чат бере адресу сайту й SEO-адресу товару — https://myshop.ua/smartfon. Мовного префікса в такому посиланні немає ніколи, тому на сайті з кількома мовами шаблон потрібен.
Посилання за шаблоном отримують назва й фото товару в картках чату, картка товару внизу розмови й відповіді AI в Telegram і Viber.
1
Шаблон товару2
Шаблон статті3
Зовнішнє джерело4
Шаблон фото- Під полем — розшифровка макросів.
- Посилання, яке AI дає у відповіді.
- Код і ID шаблону джерела — для посилання на товар у джерелі.
- Шлях до фото з каталогу підставляється в шаблон.
Як працюють мовні префікси
{language_code} — це SEO-префікс мови, той самий, що в «Довідники → Мова» у полі префікса. Чат бере префікс мови сторінки, на якій відкрито чат; якщо в «Мова відповідей AI» вибрано конкретну мову — префікс цієї мови. Варіант «Автоматично: мовою повідомлення клієнта» префікс не змінює: покупець на українській сторінці, який пише російською, отримає посилання без /ru/. SEO-адреса товару {url} у всіх мовах одна, відрізняється тільки префікс.
| Мова розмови | Префікс у «Мовах» | Посилання |
|---|---|---|
| українська (основна) | порожній | https://myshop.ua/smartfon |
| російська | ru | https://myshop.ua/ru/smartfon |
Префікси оновлюються у віджеті самі: щоразу, коли ви зберігаєте мову в «Довідники → Мова», і під час кожного збереження форми віджета. Змінили префікс чи додали мову — нічого більше робити не треба.
Посилання на статті
Коли AI знаходить відповідь у статті, він додає до відповіді посилання на неї. Адресу складає «Шаблон посилання на статтю»:
{site_url},{language_code}— так само, як у товару;{url}— SEO-адреса статті; якщо стаття завантажена за повним посиланням, воно й лишається;{article_id}— номер статті, для сайтів, де адреса будується за номером.
Порожній шаблон дорівнює {site_url}/{url} — теж без мовного префікса. Як дати AI статті, розказано в статті про базу знань чату.
Посилання з іншого сайту чи маркетплейсу
Якщо товари імпортовані з іншого сайту, у кожного є зв'язок із джерелом — код джерела, номер шаблону і посилання на товар там. Щоб чат вів на це посилання:
- Заповніть «Код джерела (source_code)» і «ID шаблону джерела (source_id)». Потрібні обидва поля: з одним зв'язок не шукається.
- У «Шаблон посилання на товар» поставте
{external_url}.
Товар без зв'язку з цим джерелом отримає звичайне посилання на ваш сайт — з адреси сайту і SEO-адреси товару, як за порожнього шаблону.
Разом із посиланням чат бере із зв'язку й ідентифікатор товару в джерелі: саме його отримує код кнопки «Купити» (дані товару в коді подій).
Посилання на фото товару
«Шаблон посилання на фото товару» має один макрос — {image}, шлях до картинки з каталогу. Приклад для OpenCart: https://myshop.ua/image/{image}. Шаблон діє і на головне фото в картці товару, і на галерею.
Порожній шаблон — чат бере фото з хмарного сховища Elbuz, а якщо його там немає — початкове посилання на фото, коли воно починається з https://. Інакше фото може не відкритися: тоді заповніть шаблон. Товар без фото показується із заглушкою.
Посилання на кошик
У картці «Сторінки магазину» одне поле — «Посилання на кошик». Коли покупець додав товар у кошик, під списком товарів з'являється посилання «Перейти до кошика» на цю адресу. Адреса має починатися з https://, http:// або /, інакше посилання не буде.
Вибір «CMS ID» за заповненої «Адреси сайту» підставляє в порожнє поле стандартну адресу кошика цієї CMS; заповнене поле програма замінить лише з вашої згоди (вибір CMS).
API магазину
Картка «API магазину» зв'язує чат із модулем Elbuz Smart Assistant на боці вашого магазину. Через нього чат упізнає покупця, який увійшов у кабінет на сайті, і бере статуси його замовлень у момент питання.
- «Shop API URL» — адреса модуля, для OpenCart вона закінчується на
route=extension/module/elbuz_smart_assistant; - «Shop API Secret» — ключ підпису, однаковий тут і в модулі;
- «Generate» — новий випадковий ключ із 64 знаків. Він збережеться, коли ви закриєте вікно або зміните інше поле, і відразу після цього старий ключ у модулі перестане підходити.
1
Shop API URL2
Shop API Secret3
Generate- Адреса модуля Elbuz Smart Assistant на боці магазину.
- Ключ, однаковий тут і в модулі. На знімку прихований.
- Новий ключ із 64 знаків; старий у модулі перестане підходити.
Поки адреса чи ключ порожні, питати про замовлення в текстовому чаті AI не може. У магазині на Elbuz CMS обидва поля заповнюються самі, а ключ доїжджає в магазин під час кожного збереження форми. Що саме покупець бачить про замовлення — у статті про розумного помічника.
Ключ — це доступ до даних ваших покупців. Не пересилайте його в листах і не показуйте на знімках екрана.
Сценарії
Основна мова без префікса, друга — з /ru/
Що налаштувати. У «Довідники → Мова» в української префікс порожній, у російської — ru. У «Шаблон посилання на товар» і «Шаблон посилання на статтю» — {site_url}/{language_code}/{url}.
Що вийде. Покупець, який відкрив чат на українській сторінці, отримує myshop.ua/smartfon, а на російській — myshop.ua/ru/smartfon.
Каталог завантажено з маркетплейсу, сторінки товарів там
Що налаштувати. Код і ID шаблону джерела, у шаблоні товару — {external_url}.
Що вийде. Назва і фото товару в чаті ведуть на сторінку товару в джерелі; товар без зв'язку з джерелом — на свою сторінку на вашому сайті.
Магазин на Elbuz CMS
Що налаштувати. Нічого: адреса сайту, мовні префікси, сторінки магазину й API магазину заповнюються під час підключення віджета.
Що робити, коли посилання веде не туди
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець із російської сторінки потрапляє на українську сторінку товару | Шаблон порожній або без {language_code}, або в «Мова відповідей AI» вибрано українську | Задати {site_url}/{language_code}/{url} (префікси) |
| Посилання веде на головну сайту | У товару немає SEO-адреси в каталозі | Заповнити SEO-адресу товару або взяти {product_ext_url} |
| Фото товарів не відкриваються | Фото немає в хмарному сховищі, а шаблон фото порожній | Заповнити «Шаблон посилання на фото товару» (фото) |
| Немає рядка «Перейти до кошика» | «Посилання на кошик» порожнє або без https:// чи / на початку | Вписати повну адресу кошика |
| AI не відповідає про замовлення | Порожні «Shop API URL» чи «Shop API Secret» або ключі тут і в модулі різні | Звірити обидва поля з модулем магазину (API) |
Часті запитання
Чому мовний префікс у посиланні не ua і не ru?
Це не код мови, а SEO-префікс із «Довідники → Мова». Порожній префікс основної мови — нормально: посилання вийде без нього (префікси).
Чи можна дати товару різні SEO-адреси для різних мов?
Ні. Адреса товару в каталозі одна, мовні версії відрізняються лише префіксом. Якщо на сайті адреси мов різні, у шаблоні беріть {product_ext_url} або {external_url}.
Покупець пише російською, а посилання веде на українську сторінку. Чому?
Префікс у посиланні береться за мовою сторінки, на якій відкрито чат. «Мова відповідей AI» — «Автоматично» змінює лише мову відповіді, а не посилання (префікси).
Де це і хто має доступ
- Меню
- Довідники → Категорії → «Інструменти каталогу» → «Налаштування віджету - Розумний помічник» → вкладка «Посилання»
- Адреса сайту
- та сама форма, вкладка «Налаштування» → картка «Сайт»
- Мовні префікси
- Довідники → Мова, поле SEO-префікса кожної мови
- Підготувати
- адресу сайту, префікси мов, адресу кошика
Суміжні теми
- Якщо потрібна загальна картина налаштувань чату — як налаштувати віджет чату на сайті.
- Якщо кнопка «Купити» в чаті нічого не кладе в кошик сайту — код подій і кошик сайту.
- Якщо ті самі посилання треба налаштувати у вікні пошуку — посилання в розумному пошуку.
- Якщо AI дає посилання на статтю, якої не має бути, — статті для консультанта.
