Osadzanie na stronie

Jedna linia script osadza okno czatu na stronie, a także metody i reguły językowe, które można wywołać na stronie.

W dalszej części {API} oznacza adres usługi, który znajdziesz w panelu administracyjnym na stronie „Integracja”.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key to publiczny klucz — skopiujesz go na stronie „Integracja” w panelu administracyjnym.
  • Na stronie „Integracja” zarejestruj witryny, w których można osadzić widget (np. https://shop.example.com); inne strony nie będą mogły go użyć, nawet jeśli zdobędą Twój publiczny klucz. Pamiętaj, aby wypełnić to pole przed uruchomieniem na produkcji.
  • Opcjonalnie data-theme="dark" włącza ciemny motyw.
  • Opcjonalnie data-language="de": jeśli Twoja witryna jest wielojęzyczna, przekaż język bieżącej strony — obsługa klienta będzie domyślnie używać tego języka (odwiedzający nadal mogą go zmienić). Kody obsługiwanych języków znajdziesz w omówieniu otwartego API.
  • Opcjonalnie data-language="auto": jako język domyślny przyjmowany jest atrybut <html lang> strony, a gdy strona później zmieni język (wystarczy zmiana atrybutu lang, działa też w aplikacjach jednostronicowych bez przeładowania), okno obsługi klienta automatycznie przełączy się razem z nią.

Na stronie możesz wywołać:

MetodaDziałanie
AICS.open() / AICS.close() / AICS.toggle()Otwiera, zamyka i przełącza okno obsługi klienta — np. pod przyciskiem „Skontaktuj się z nami”
AICS.identify(userToken)Po zalogowaniu się klienta informuje obsługę, kim jest (zobacz Identyfikacja zalogowanych klientów)
AICS.setLanguage(code)Wywoływane przy zmianie języka witryny — okno obsługi i kolejne odpowiedzi przełączą się na ten język, np. AICS.setLanguage("ja"); akceptuje też zapisy takie jak zh-Hans czy pt-BR
AICS.reset()Wywoływane przy wylogowaniu klienta: odmontowuje okno obsługi i porzuca bieżącą sesję; ponowne wczytanie skryptu daje nowe, anonimowe okno, więc następna osoba nie zobaczy rozmowy poprzedniej

Język

  • Okno obsługi klienta wyświetla język odpowiadający lokalizacji odwiedzającego (IP), w tym teksty interfejsu i powitanie; jeśli ustawiono data-language, pierwszeństwo ma język strony. Gdy nie da się ustalić lokalizacji, używany jest „Język domyślny” ustawiony w panelu administracyjnym.
  • AI odpowiada w języku, którego używa klient; gdy z treści wiadomości nie da się rozpoznać języka (emoji, numer zamówienia), używa języka ustalonego powyżej.
  • Klient może przełączyć język w menu językowym w nagłówku okna albo po prostu napisać do AI „odpowiadaj po angielsku”. Od tego momentu AI będzie używać tego języka, nawet jeśli klient napisze w innym.
  • Zmiana języka witryny (AICS.setLanguage lub zmiana <html lang> przy data-language="auto") również liczy się jako wybór klienta — spośród wszystkich powyższych sposobów decyduje ostatni; język domyślny przekazany przy otwarciu strony nie nadpisze języka wcześniej wybranego przez klienta.
  • W panelu administracyjnym w sekcji „Ustawienia bota → Język” możesz wyłączyć wykrywanie po IP, zmienić język domyślny i ograniczyć listę dostępnych języków.
  • Jeśli wdrożenie działa za reverse proxy lub CDN, musisz skonfigurować po stronie serwera TRUSTED_PROXIES lub COUNTRY_HEADER; w przeciwnym razie nie uzyskasz prawdziwego adresu IP odwiedzającego.

Czy ta strona była pomocna?

Ostatnia aktualizacja: