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.
| Makro | Co jest wstawiane | Przykł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 prefiks | en lub nic |
{url} | adres SEO produktu z katalogu | smartfon-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 zmian | peł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.
1
Szablon produktu2
Szablon artykułu3
Zewnętrzne źródło4
Szablon zdjęcia- Makra są objaśnione pod polem.
- Link, który AI podaje w odpowiedzi.
- Kod źródła i ID szablonu — dla linku do produktu w źródle.
- Ś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.
| Język rozmowy | Prefiks w „Językach” | Link |
|---|---|---|
| polski (główny) | pusty | https://myshop.pl/smartfon |
| angielski | en | https://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:
- 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.
- 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ć.
1
Shop API URL2
Shop API Secret3
Generuj- Adres modułu Elbuz Smart Assistant po stronie sklepu.
- Klucz, taki sam tutaj i w module. Na zrzucie ukryty.
- 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 | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient z angielskiej strony trafia na polską stronę produktu | Szablon jest pusty lub bez {language_code} albo w „Język odpowiedzi AI” wybrano polski | Ustaw {site_url}/{language_code}/{url} (prefiksy) |
| Link prowadzi na stronę główną | Produkt nie ma adresu SEO w katalogu | Wypeł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 pusty | Wypeł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ówieniach | Puste „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
- Jeśli potrzebujesz pełnego obrazu ustawień czatu — jak ustawić widżet czatu na stronie.
- Jeśli przycisk „Kup” w czacie nic nie dodaje do koszyka strony — kod zdarzeń i koszyk strony.
- Jeśli te same linki trzeba ustawić w oknie wyszukiwania — linki w inteligentnej wyszukiwarce.
- Jeśli AI podaje link do artykułu, którego nie powinno, — artykuły dla konsultanta.
