↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Сайт і віджети
    4. Онлайн-чат і AI-консультант
    5. Чат на сайті
    6. Як налаштувати віджет чату на сайті

    Як налаштувати посилання з чату на товари і статті

    6 хв читанняОновлено

    Чат Elbuz сам складає посилання на товар і статтю з адреси сайту, мовного префікса й SEO-адреси, тож покупець, який відкрив чат на російській версії сайту, потрапляє на товар на /ru/-версії, а не на основній.

    Коли це знадобиться:

    • Основна мова сайту без префікса, друга — з /ru/ — шаблон {site_url}/{language_code}/{url} дає обидві адреси правильно.
    • Товари з чату відкриваються не на тій сторінці — шаблон замінює адресу з каталогу на ту, що прийнята на вашому сайті.
    • Товари завантажено з іншого сайту чи маркетплейсу — посилання береться зі зв'язку з цим джерелом.

    З чого почати: вкладка «Посилання» → «Шаблон посилання на товар» → вставте шаблон.

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

    Шаблони діють одразу: чат складає посилання щоразу, коли показує товар чи статтю, тож нова адреса з'явиться вже в наступній відповіді. Оновлювати індекс чи код на сайті не потрібно.

    Адреса сайту

    Поле «Адреса сайту» стоїть на вкладці «Налаштування», у картці «Сайт». З нього береться {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Шаблон фото
    1. Під полем — розшифровка макросів.
    2. Посилання, яке AI дає у відповіді.
    3. Код і ID шаблону джерела — для посилання на товар у джерелі.
    4. Шлях до фото з каталогу підставляється в шаблон.

    Як працюють мовні префікси

    {language_code} — це SEO-префікс мови, той самий, що в «Довідники → Мова» у полі префікса. Чат бере префікс мови сторінки, на якій відкрито чат; якщо в «Мова відповідей AI» вибрано конкретну мову — префікс цієї мови. Варіант «Автоматично: мовою повідомлення клієнта» префікс не змінює: покупець на українській сторінці, який пише російською, отримає посилання без /ru/. SEO-адреса товару {url} у всіх мовах одна, відрізняється тільки префікс.

    Що дає шаблон {site_url}/{language_code}/{url}
    Мова розмовиПрефікс у «Мовах»Посилання
    українська (основна)порожнійhttps://myshop.ua/smartfon
    російськаruhttps://myshop.ua/ru/smartfon

    Префікси оновлюються у віджеті самі: щоразу, коли ви зберігаєте мову в «Довідники → Мова», і під час кожного збереження форми віджета. Змінили префікс чи додали мову — нічого більше робити не треба.

    Посилання на статті

    Коли AI знаходить відповідь у статті, він додає до відповіді посилання на неї. Адресу складає «Шаблон посилання на статтю»:

    • {site_url}, {language_code} — так само, як у товару;
    • {url} — SEO-адреса статті; якщо стаття завантажена за повним посиланням, воно й лишається;
    • {article_id} — номер статті, для сайтів, де адреса будується за номером.

    Порожній шаблон дорівнює {site_url}/{url} — теж без мовного префікса. Як дати AI статті, розказано в статті про базу знань чату.

    Посилання з іншого сайту чи маркетплейсу

    Якщо товари імпортовані з іншого сайту, у кожного є зв'язок із джерелом — код джерела, номер шаблону і посилання на товар там. Щоб чат вів на це посилання:

    1. Заповніть «Код джерела (source_code)» і «ID шаблону джерела (source_id)». Потрібні обидва поля: з одним зв'язок не шукається.
    2. У «Шаблон посилання на товар» поставте {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 знаків. Він збережеться, коли ви закриєте вікно або зміните інше поле, і відразу після цього старий ключ у модулі перестане підходити.
    Картка «API магазину»: адреса модуля магазину, ключ і кнопка Generate
    1Shop API URL
    2Shop API Secret
    3Generate
    1. Адреса модуля Elbuz Smart Assistant на боці магазину.
    2. Ключ, однаковий тут і в модулі. На знімку прихований.
    3. Новий ключ із 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-префікса кожної мови
    Підготувати
    адресу сайту, префікси мов, адресу кошика

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно