↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak uruchomić czat na stronie: od czego zacząć
    3. Jak ustawić widżet czatu na stronie

    Jak ustawić linki z czatu do produktów i artykułów

    4 min czytaniaZaktualizowano

    Czat Elbuz sam składa link do produktu i artykułu z adresu strony, prefiksu języka i adresu SEO. Dzięki temu klient, który otworzył czat na angielskiej wersji strony, trafia do produktu w wersji /en/, a nie w głównej.

    Kiedy to się przyda:

    • Główny język strony jest bez prefiksu, drugi — z /en/ — szablon {site_url}/{language_code}/{url} poprawnie tworzy oba adresy.
    • Produkty z czatu otwierają się na złej stronie — szablon zastępuje adres z katalogu takim, jaki obowiązuje na Twojej stronie.
    • Produkty zaimportowano z innego serwisu lub marketplace’u — link jest brany z powiązania z tym źródłem.

    Od czego zacząć: karta „Linki” → „Szablon linku do produktu” → wstaw szablon.

    Co można ustawić

    • Adres strony — podstawa wszystkich linków czatu.
    • Adres produktu — z jakich części składa się link w karcie produktu w czacie.
    • Język w adresie — prefiks /en/, /de/ dla każdego języka strony.
    • Adres artykułu — link, który AI podaje w odpowiedzi jako „więcej tutaj”.
    • Adres z innego serwisu — dla produktów zaimportowanych z zewnętrznego źródła.
    • Zdjęcia i koszyk — obrazy produktów i przejście do koszyka strony.
    • API sklepu — połączenie z modułem sklepu dla statusów zamówień.

    Szablony działają od razu: czat składa link za każdym razem, gdy pokazuje produkt lub artykuł, więc nowy adres pojawi się już w następnej odpowiedzi. Nie trzeba aktualizować indeksu ani kodu na stronie.

    Adres strony

    Pole „Adres strony” jest na karcie „Ustawienia”, w sekcji „Strona”. Z niego pochodzi {site_url} w szablonach, a gdy szablonu produktu nie ma — początek linku do produktu. Wpisz pełny adres, z https://: końcowy ukośnik nie przeszkadza, czat go usuwa.

    Pusty adres daje linki względne, np. /smartfon-galaxy. Działają one na stronie z czatem, ale nie w komunikatorach i e-mailach. Bez tego adresu nie działa też SDK konsultanta wideo: na karcie „Awatar” pojawi się ostrzeżenie.

    Jak złożyć link do produktu

    Link do produktu czat składa według pola „Szablon linku do produktu”. Szablon to adres, w którym części różne dla każdego produktu zapisano makrami w nawiasach klamrowych.

    Makra szablonu linku do produktu
    MakroCo jest wstawianePrzykład
    {site_url}„Adres strony” z karty „Ustawienia”https://myshop.pl
    {language_code}prefiks SEO języka strony, na której otwarto czat, — ze „Słowniki” → „Języki”. To nie kod języka: główny język zwykle ma pusty prefiksen lub nic
    {url}adres SEO produktu z katalogusmartfon-galaxy-a57
    {external_url}link do produktu z zewnętrznego źródła (niżej)https://allegro.pl/…
    {product_ext_url}pole „Link” karty produktu bez zmianpełny adres z karty

    Typowy szablon to {site_url}/{language_code}/{url}. Podwójne ukośniki, które powstają przy pustym prefiksie, czat usuwa sam: https://myshop.pl//smartfon zmienia się w https://myshop.pl/smartfon.

    Pusty szablon nie wyłącza linków: czat bierze adres strony i adres SEO produktu — https://myshop.pl/smartfon. Taki link nigdy nie ma prefiksu języka, dlatego strona wielojęzyczna potrzebuje szablonu.

    Link według szablonu dostają nazwa i zdjęcie produktu w kartach czatu, karta produktu na dole rozmowy oraz odpowiedzi AI w Telegramie i Viberze.

    Sekcja „Szablony linków”: szablony produktu, artykułu i zdjęcia, zewnętrzne źródło
    1Szablon produktu
    2Szablon artykułu
    3Zewnętrzne źródło
    4Szablon zdjęcia
    1. Makra są objaśnione pod polem.
    2. Link, który AI podaje w odpowiedzi.
    3. Kod źródła i ID szablonu — dla linku do produktu w źródle.
    4. Ścieżka do zdjęcia z katalogu jest wstawiana do szablonu.

    Jak działają prefiksy języków

    {language_code} to prefiks SEO języka — ten sam, co w polu prefiksu w „Słowniki” → „Języki”. Czat bierze prefiks języka strony, na której otwarto czat; jeśli w „Język odpowiedzi AI” wybrano konkretny język — prefiks tego języka. Opcja „Automatycznie: w języku wiadomości klienta” prefiksu nie zmienia: klient na polskiej stronie, który pisze po angielsku, dostanie link bez /en/. Adres SEO produktu {url} jest jeden dla wszystkich języków, różni się tylko prefiks.

    Co daje szablon {site_url}/{language_code}/{url}
    Język rozmowyPrefiks w „Językach”Link
    polski (główny)pustyhttps://myshop.pl/smartfon
    angielskienhttps://myshop.pl/en/smartfon

    Prefiksy aktualizują się w widżecie same: za każdym razem, gdy zapisujesz język w „Słowniki” → „Języki”, i przy każdym zapisie formularza widżetu. Zmiana prefiksu lub nowy język nie wymagają nic więcej.

    Linki do artykułów

    Gdy AI znajdzie odpowiedź w artykule, dodaje do odpowiedzi link do niego. Adres składa „Szablon linku do artykułu”:

    • {site_url}, {language_code} — tak samo jak u produktu;
    • {url} — adres SEO artykułu; jeśli artykuł zaimportowano z pełnym linkiem, zostaje ten link;
    • {article_id} — numer artykułu, dla stron, gdzie adres buduje się z numeru.

    Pusty szablon jest równy {site_url}/{url} — również bez prefiksu języka. Jak przekazać artykuły AI, opisano w artykule o bazie wiedzy czatu.

    Linki z innego serwisu lub marketplace’u

    Jeśli produkty zaimportowano z innego serwisu, każdy ma powiązanie ze źródłem — kod źródła, numer szablonu i link do produktu w źródle. Aby czat prowadził do tego linku:

    1. Wypełnij „Kod źródła (source_code)” i „ID szablonu źródła (source_id)”. Potrzebne są oba pola: z jednym powiązanie nie jest wyszukiwane.
    2. W „Szablon linku do produktu” wpisz {external_url}.

    Produkt bez powiązania z tym źródłem dostanie zwykły link do Twojej strony — z adresu strony i adresu SEO produktu, jak przy pustym szablonie.

    Razem z linkiem czat bierze z powiązania także identyfikator produktu w źródle: właśnie on trafia do kodu przycisku „Kup” (dane produktu w kodzie zdarzeń).

    Link do zdjęcia produktu

    „Szablon linku do zdjęcia produktu” ma jedno makro — {image}, ścieżkę do obrazu z katalogu. Przykład dla OpenCart: https://myshop.pl/image/{image}. Szablon działa i na zdjęcie główne w karcie produktu, i na galerię.

    Przy pustym szablonie czat bierze zdjęcie z chmury Elbuz, a jeśli go tam nie ma — pierwotny link do zdjęcia, gdy zaczyna się od https://. W innym przypadku zdjęcie może się nie otworzyć: wtedy wypełnij szablon. Produkt bez zdjęcia jest pokazywany z obrazkiem zastępczym.

    Link do koszyka

    W sekcji „Strony sklepu” jest jedno pole — „Link do koszyka”. Gdy klient doda produkt do koszyka, pod listą produktów pojawia się link „Przejdź do koszyka” pod ten adres. Adres musi zaczynać się od https://, http:// lub /, inaczej linku nie będzie.

    Wybór „CMS ID” przy wypełnionym „Adresie strony” wstawia do pustego pola standardowy adres koszyka tego CMS; wypełnione pole program zastąpi tylko za Twoją zgodą (wybór CMS).

    API sklepu

    Sekcja „API sklepu” łączy czat z modułem Elbuz Smart Assistant po stronie Twojego sklepu. Dzięki niemu czat rozpoznaje klienta zalogowanego na koncie na stronie i pobiera statusy jego zamówień w chwili pytania.

    • „Shop API URL” — adres modułu; dla OpenCart kończy się na route=extension/module/elbuz_smart_assistant;
    • „Shop API Secret” — klucz podpisu, taki sam tutaj i w module;
    • „Generuj” — nowy losowy klucz z 64 znaków. Zapisze się, gdy zamkniesz okno lub zmienisz inne pole, i od razu potem stary klucz w module przestanie pasować.
    Sekcja „API sklepu”: adres modułu sklepu, klucz i przycisk „Generuj”
    1Shop API URL
    2Shop API Secret
    3Generuj
    1. Adres modułu Elbuz Smart Assistant po stronie sklepu.
    2. Klucz, taki sam tutaj i w module. Na zrzucie ukryty.
    3. Nowy klucz z 64 znaków; stary w module przestaje działać.

    Dopóki adres lub klucz są puste, AI w czacie tekstowym nie może sprawdzać zamówień. W sklepie na Elbuz CMS oba pola wypełniają się same, a klucz trafia do sklepu przy każdym zapisie formularza. Co dokładnie klient widzi o zamówieniu — w artykule o inteligentnym asystencie.

    Klucz to dostęp do danych Twoich klientów. Nie przesyłaj go e-mailem i nie pokazuj na zrzutach ekranu.

    Scenariusze

    Główny język bez prefiksu, drugi — z /en/

    Co ustawić. W „Słowniki” → „Języki” polski ma pusty prefiks, angielski — en. W „Szablon linku do produktu” i „Szablon linku do artykułu” — {site_url}/{language_code}/{url}.

    Efekt. Klient, który otworzył czat na polskiej stronie, dostaje myshop.pl/smartfon, a na angielskiej — myshop.pl/en/smartfon.

    Katalog zaimportowano z marketplace’u, strony produktów są tam

    Co ustawić. Kod i ID szablonu źródła, w szablonie produktu — {external_url}.

    Efekt. Nazwa i zdjęcie produktu w czacie prowadzą do strony produktu w źródle; produkt bez powiązania ze źródłem — do swojej strony w Twoim serwisie.

    Sklep na Elbuz CMS

    Co ustawić. Nic: adres strony, prefiksy języków, strony sklepu i API sklepu wypełniają się przy podłączaniu widżetu.

    Co zrobić, gdy link prowadzi nie tam

    Co widzisz i co z tym zrobić
    Co widziszDlaczego tak jestCo zrobić
    Klient z angielskiej strony trafia na polską stronę produktuSzablon jest pusty lub bez {language_code} albo w „Język odpowiedzi AI” wybrano polskiUstaw {site_url}/{language_code}/{url} (prefiksy)
    Link prowadzi na stronę głównąProdukt nie ma adresu SEO w kataloguWypełnij adres SEO produktu lub użyj {product_ext_url}
    Zdjęcia produktów się nie otwierająZdjęć nie ma w chmurze, a szablon zdjęcia jest pustyWypełnij „Szablon linku do zdjęcia produktu” (zdjęcia)
    Brak wiersza „Przejdź do koszyka”„Link do koszyka” jest pusty lub nie zaczyna się od https:// albo /Wpisz pełny adres koszyka
    AI nie odpowiada o zamówieniachPuste „Shop API URL” lub „Shop API Secret” albo klucze tutaj i w module się różniąPorównaj oba pola z modułem sklepu (API)

    Najczęstsze pytania

    Dlaczego prefiks języka w linku nie jest kodem języka?

    To nie kod języka, tylko prefiks SEO ze „Słowniki” → „Języki”. Pusty prefiks głównego języka jest w porządku: link powstanie bez niego (prefiksy).

    Czy produkt może mieć różne adresy SEO dla różnych języków?

    Nie. Adres produktu w katalogu jest jeden, wersje językowe różnią się tylko prefiksem. Jeśli na stronie adresy w językach są różne, w szablonie użyj {product_ext_url} lub {external_url}.

    Klient pisze po angielsku, a link prowadzi do polskiej strony. Dlaczego?

    Prefiks w linku zależy od języka strony, na której otwarto czat. „Język odpowiedzi AI” — „Automatycznie” zmienia tylko język odpowiedzi, a nie link (prefiksy).

    Gdzie to jest i kto ma dostęp

    Menu
    „Słowniki” → „Kategorie” → „Narzędzia katalogu” → „Ustawienia widżetu - Inteligentny asystent” → karta „Linki”
    Adres strony
    ten sam formularz, karta „Ustawienia” → sekcja „Strona”
    Prefiksy języków
    „Słowniki” → „Języki”, pole prefiksu SEO każdego języka
    Przygotuj
    adres strony, prefiksy języków, adres koszyka

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo