Dodanie ChatLab do Twojej strony internetowej pozwala odwiedzającym wchodzić w interakcję z Twoim chatbotem AI bezpośrednio w witrynie. Ten poradnik wyjaśnia, jak pobrać kod do osadzenia i dodać go do swojej strony.
Zanim zaczniesz
Utwórz i wytrenuj swojego chatbota, zanim udostępnisz go klientom. Do instalacji potrzebujesz również uprawnień do edycji i publikacji strony. Zobacz How to create your first chatbot (Jak utworzyć swojego pierwszego chatbota).
Otwieranie zakładki Test & Deploy
Wybierz swojego chatbota z głównego panelu, a następnie kliknij zakładkę Test & Deploy (Testuj i wdróż). Możesz także kliknąć zielony przycisk Test chatbot (Przetestuj chatbota) na karcie Overview (Przegląd) chatbota. Zakładka składa się z dwóch części:
- Test (po lewej) - Twój chatbot działający na żywo na makiecie zastępującej Twoją stronę internetową, dzięki czemu możesz go wypróbować, zanim zobaczą go odwiedzający. W trybie Widget okno czatu znajduje się w prawym dolnym rogu w rzeczywistym rozmiarze, z ikoną czatu pod spodem - dokładnie tak, jak widzą je odwiedzający. Przełącznik Widget / Frame w prawym górnym rogu makiety pozwala przejść do trybu Frame (Ramka), czyli stale otwartego czatu, który generuje kod iframe.
- Deploy (Wdróż, po prawej) - miejsce, w którym wybierasz platformę strony internetowej lub kanał komunikacji i postępujesz zgodnie z instrukcjami. Poniżej opcja Share a test link (Udostępnij link testowy) udostępnia linki do przesłania innym (zobacz Wysyłanie linku do Twojego chatbota).
Twoja strona internetowa w tle chatbota
Gdy Twój chatbot jest wytrenowany na pojedynczej stronie internetowej, makieta wyświetla zrzut ekranu tej strony za oknem czatu, dzięki czemu widzisz, jak chatbot prezentuje się na Twoich własnych stronach. Zrzut ekranu jest wykonywany raz przy pierwszym otwarciu zakładki (zanim będzie gotowy, makieta wyświetla zarys strony, a chatbot już działa) i zostaje zachowany; nowy jest pobierany tylko wtedy, gdy zmienisz adres. Chatboty wytrenowane na kilku stronach internetowych lub wyłącznie na plikach i tekście wyświetlają zamiast tego neutralny zarys strony.
Kliknij adres strony internetowej u góry makiety, aby zarządzać tłem:
- Website address (Adres strony internetowej) z przyciskiem Save (Zapisz) - pozwala wyświetlić inną stronę, na przykład podstronę produktu. Try again (Spróbuj ponownie) powtarza próbę wykonania zrzutu ekranu, jeśli poprzednia się nie powiodła.
- Hide background / Show background (Ukryj tło / Pokaż tło) - włącza i wyłącza zrzut ekranu bez usuwania go.
- Remove background (Usuń tło) - usuwa zrzut ekranu. Makieta wyświetla neutralny zarys strony do momentu ponownego wprowadzenia adresu.
Tło jest jedynie podglądem w panelu administracyjnym. Nie wprowadza żadnych zmian na Twojej stronie internetowej.
Wybór platformy
W sekcji Where do you want to add the chatbot? (Gdzie chcesz dodać chatbota?) w zakładce Deploy (Wdrożenie) znajdziesz listę obsługiwanych miejsc docelowych podzielonych na trzy grupy: Website (Strona internetowa), służącą do umieszczenia chatbota na stronach, do których masz dostęp, Online store platforms (Platformy sklepów internetowych - kliknij nagłówek, aby go rozwinąć) oraz Messaging channels (Kanały komunikacji), przeznaczone do połączenia z istniejącym kontem do rozmów. Kliknij pozycję odpowiadającą miejscu, w którym ma się pojawić chatbot, aby zobaczyć dopasowane instrukcje.
Obsługiwane platformy:
- HTML Code - działa z każdą stroną internetową, na której możesz edytować kod HTML
- WordPress - za pomocą oficjalnej wtyczki ChatLab lub ręcznego wklejenia kodu
- Wix - poprzez Settings > Custom Code (Ustawienia > Kod niestandardowy)
- Webflow - poprzez Site settings > Custom code (Ustawienia witryny > Kod niestandardowy), z włączonym dostępem do niestandardowego kodu dla Twojej witryny lub obszaru roboczego
- PrestaShop - za pomocą modułu ChatLab dla PrestaShop lub ręcznego wklejenia kodu
- Shopify - za pomocą aplikacji ChatLab z Shopify App Store (jako app embed w Twoim szablonie) lub ręcznego wklejenia kodu w pliku theme.liquid
- WooCommerce - za pomocą wtyczki do WordPressa lub ręcznego wklejenia kodu
- Shoper - za pomocą aplikacji ChatLab z Shoper App Store lub ręcznego wklejenia kodu
- Abicart - poprzez Store design > Themes > Site header (Wygląd sklepu > Szablony > Nagłówek witryny)
- Ecwid - poprzez Website > Overview > Custom JavaScript code (Strona internetowa > Przegląd > Własny kod JavaScript)
- CS-Cart - za pomocą dodatku ChatLab lub ręcznego wklejenia kodu w Design > Layouts > Custom HTML code (Projekt > Układy > Własny kod HTML)
- BigCommerce - dodawany automatycznie po połączeniu sklepu lub poprzez Storefront > Script Manager (Witryna sklepu > Menedżer skryptów)
Kanały komunikacji:
- WhatsApp Business - odpowiada na koncie WhatsApp Business, zobacz WhatsApp for Business
- Facebook Messenger - odpowiada na wiadomości Twojej strony na Facebooku, zobacz Integracja z Facebook Messenger
- Instagram - odpowiada na wiadomości prywatne na Instagramie, zobacz Integracja z Instagramem
Kanały komunikacji nie korzystają z poniższego kodu embed. Są one łączone z kontem, które już posiadasz, więc żaden kod nie jest wklejany na stronę internetową.
Każda platforma zawiera instrukcje krok po kroku specyficzne dla danej integracji. W przypadku platform posiadających dedykowane artykuły pomocy, na dole widoczny jest link View full instructions (Zobacz pełną instrukcję).
Dodawanie za pomocą kodu HTML
Opcja HTML Code działa z każdą stroną internetową, na której masz dostęp do kodu źródłowego. Zobaczysz dwie opcje osadzenia: Widget oraz Iframe.
Tryb Widget
Zakładka Widget zawiera kod, który dodaje ikonę czatu na Twojej stronie internetowej. Gdy odwiedzający klikną ikonę, otwiera się okno czatu.
- Kliknij zakładkę Widget
- Kliknij Copy to clipboard (Kopiuj do schowka), aby skopiować kod
- Znajdź sekcję
<head>na swojej stronie internetowej - Wklej kod jako ostatni element w sekcji
<head> - Odśwież przeglądarkę, aby sprawdzić, czy ikona chatbota się wyświetla
Tryb Iframe
Zakładka Iframe zawiera kod, który osadza chatbota bezpośrednio w treści Twojej strony. Chatbot jest zawsze widoczny i może być otoczony innymi elementami strony.
- Kliknij zakładkę Iframe
- Kliknij Copy to clipboard (Kopiuj do schowka), aby skopiować kod
- Wklej kod w dowolnym miejscu w kodzie HTML strony, w którym ma się pojawić chatbot
- Dostosuj atrybuty
widthiheight, aby dopasować je do układu strony
Nie wiesz, co wybrać? Przeczytaj What is the difference between widget and Iframe? (Jaka jest różnica między widgetem a Iframe?), aby poznać szczegółowe porównanie.
Dodawanie za pomocą wtyczki lub aplikacji: WordPress, WooCommerce, PrestaShop, Shopify, Shoper i CS-Cart
Dla tych sześciu platform ChatLab oferuje własną wtyczkę, moduł, aplikację lub dodatek. Po połączeniu z Twoim chatbotem rozwiązanie to automatycznie dodaje chatbota do Twojej witryny, więc nie musisz kopiować żadnego kodu. W przypadku sklepów internetowych łączy ono także sklep, dzięki czemu chatbot może przeszukiwać Twoje produkty i sprawdzać status zamówienia. Ręczne wklejenie kodu jest nadal możliwe jako alternatywa, ale wyświetla ono wyłącznie widget czatu.
Gdy wybierzesz jedną z tych platform, pojawią się dwie zakładki: Plugin Installation (Instalacja wtyczki - zalecana) oraz Manual Installation (Instalacja ręczna).
Instalacja wtyczki (zalecana)
- Kliknij przycisk u góry zakładki Plugin Installation: Get the plugin on WordPress.org dla WordPressa i WooCommerce, Download the ChatLab module (.zip) dla PrestaShop, Get the app in the Shopify App Store dla Shopify, Get the app in the Shoper App Store dla Shopera lub Download the ChatLab add-on (.tgz) dla CS-Cart. Przycisk dla PrestaShop nie otwiera strony marketplace - pobiera moduł na Twój komputer jako pojedynczy plik ZIP (
chatlab.zip), który w kolejnym kroku prześlesz do swojego sklepu. - Zainstaluj wtyczkę, moduł, aplikację lub dodatek ChatLab w panelu administracyjnym swojej witryny. W przypadku PrestaShop otwórz Modules > Module Manager > Upload a module (Moduły > Menedżer modułów > Załaduj moduł) w panelu administracyjnym PrestaShop i wybierz pobrany plik ZIP. Pełny przewodnik po PrestaShop znajdziesz w artykule Jak dodać chatbota do PrestaShop. W przypadku CS-Cart otwórz Add-ons > Downloaded add-ons (Dodatki > Pobrane dodatki), wybierz Manual installation (Instalacja ręczna) z menu koła zębatego i prześlij pobrany plik.
- Otwórz tam ChatLab, zaloguj się na swoje konto ChatLab i po wyświetleniu monitu wybierz tego chatbota. W przypadku PrestaShop kliknij Configure (Konfiguruj) przy zainstalowanym module, a następnie Connect my store (Połącz mój sklep). W przypadku CS-Cart otwórz Marketing > ChatLab AI Chatbot i kliknij Continue (Kontynuuj). W przypadku sklepu WooCommerce pozostaw zaznaczoną opcję WooCommerce integration, aby dane sklepu również zostały połączone.
- Połączenie zostanie zakończone automatycznie, a chatbot pojawi się na Twojej stronie internetowej. W Shopify otwórz dodatkowo Online Store > Themes > Customize > App embeds (Sklep internetowy > Motywy > Dostosuj > Osadzone aplikacje), włącz ChatLab AI Chat i zapisz zmiany. Otwórz swoją stronę i wyślij wiadomość testową.
Każda platforma posiada dedykowany przewodnik ze wszystkimi krokami i zrzutami ekranu:
- WordPress - Jak dodać chatbota do strony WordPress
- PrestaShop - Jak dodać chatbota do PrestaShop
- WooCommerce - Integracja z WooCommerce
- Shopify - Integracja z Shopify
- Shoper - Integracja z Shoper
- CS-Cart - Integracja z CS-Cart
Shoper
Wybierz Shoper na liście platform w sekcji Deploy (Wdrażanie). Na zakładce Plugin Installation kliknij Get the app in the Shoper App Store, aby otworzyć bezpłatną aplikację ChatLab w Shoper App Store.
- Zainstaluj bezpłatną aplikację ChatLab z Shoper App Store. Możesz ją również znaleźć w panelu administracyjnym Shoper w zakładce Dodatki i integracje > Aplikacje.
- Otwórz aplikację ChatLab w panelu administracyjnym Shoper. Panel ChatLab otworzy się w nowym oknie.
- Ustaw swoje hasło lub zaloguj się na swoje konto ChatLab i po wyświetleniu monitu połącz sklep z tym chatbotem.
- Twój sklep połączy się automatycznie, a chatbot pojawi się na stronie Twojego sklepu.
Aby dodać wyłącznie widget czatu bez aplikacji, przejdź do zakładki Manual Installation, skopiuj kod, a następnie w panelu administracyjnym Shoper przejdź do sekcji Dodatki i integracje > Integracje własne, wklej kod w polu Nagłówek strony i zapisz zmiany. Odśwież stronę sklepu, aby sprawdzić, czy chatbot się wyświetla. Szczegółowy opis znajdziesz w artykule Integracja z Shoper.
Instalacja ręczna
Przejdź do zakładki Manual Installation (Instalacja ręczna), skopiuj kod i wklej go w nagłówku swojej witryny zgodnie z instrukcją wyświetloną dla Twojej platformy. W przypadku systemów WordPress i WooCommerce wykonuje się to za pomocą wtyczki do wstawiania kodu, takiej jak Insert Headers and Footers. Opublikuj zmiany i przetestuj czat. Zainstaluj chatbota tylko raz - korzystając z wtyczki bądź aplikacji albo z ręcznie wklejonego kodu, nigdy z obu metod naraz.
Dodawanie za pośrednictwem innych platform
W przypadku platform Wix, Webflow i Abicart nie ma wtyczki do zainstalowania: kod wklejasz na swoją stronę samodzielnie. W przypadku Ecwid aplikacja ChatLab z Ecwid App Market łączy sklep z Twoim chatbotem; jeśli widget czatu nie pojawia się w witrynie sklepu, wklej kod w sekcji Custom JavaScript code (Niestandardowy kod JavaScript) lub na stronie internetowej, na której osadzony jest Twój sklep. W przypadku BigCommerce ChatLab dodaje widget za Ciebie, gdy sklep jest połączony z dostępem do treści; w przeciwnym razie kod wklejasz w Script Managerze (Menedżerze skryptów). Wybierz platformę w sekcji Deploy (Wdróż), aby zobaczyć:
- Kod do osadzenia z opcjami Widget oraz Iframe
- Instrukcje wklejania krok po kroku przygotowane dla danej platformy
- Link View full instructions (Zobacz pełną instrukcję) prowadzący do pełnego poradnika dla platformy
Pełne poradniki dla tych platform:
- Jak dodać chatbota do strony Wix
- Jak dodać chatbota do strony Webflow
- Integracja z Abicart
- Integracja z Ecwid
- Integracja z BigCommerce
Zgodność z RODO (GDPR)
Jeśli potrzebujesz, aby Twój chatbot ładował się dopiero po wyrażeniu zgody na pliki cookie, zobacz Setting up ChatLab for GDPR compliance, gdzie znajdziesz poradniki integracji z narzędziami CookieBot, Usercentrics i Google Tag Manager.
Content Security Policy (CSP)
Jeśli Twoja strona internetowa korzysta z nagłówków Content Security Policy, musisz zezwolić na domeny ChatLab, aby chatbot mógł działać. Wymagane dyrektywy zależą od tego, czy używasz trybu Widget, czy Iframe.
Tryb Widget
Widget ładuje na Twojej stronie skrypt, który tworzy interfejs czatu. Dołącz poniższe źródła ChatLab do swoich istniejących dyrektyw CSP; nie zastępuj polityki dla reszty swojej witryny:
script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com 'unsafe-inline';
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;
Domyślnie widget wstrzykuje niektóre style inline. Twoja polityka musi również zezwalać na wbudowany skrypt konfiguracyjny, na przykład za pomocą wartości nonce lub hasha CSP. Zezwól w img-src na źródła obrazów używane przez Twojego bota i karty produktów; dźwięk i inne włączone funkcje mogą wymagać dodatkowych źródeł. W przypadku domeny agencyjnej użyj domen z wygenerowanego fragmentu kodu.
CSP Safe Mode - unikanie unsafe-inline
Jeśli polityka bezpieczeństwa Twojej strony internetowej nie zezwala na 'unsafe-inline' w style-src, możesz włączyć CSP Safe Mode. Spowoduje to ładowanie arkusza stylów kontenera widgetu z zewnętrznego pliku CSS. Nie autoryzuje to Twojego wbudowanego skryptu konfiguracyjnego ani nie gwarantuje, że każdy niestandardowy styl i włączona funkcja spełniają wymogi Twojej polityki.
Aby go włączyć, dodaj window.aichatbotCspSafe = true; przed znacznikiem skryptu ChatLab:
<script>
window.aichatbotApiKey = "YOUR_API_KEY";
window.aichatbotCspSafe = true;
</script>
<script src="https://script.chatlab.com/aichatbot.js" defer></script>
Po włączeniu CSP Safe Mode przetestuj politykę arkuszy stylów bez 'unsafe-inline'. Punktem wyjścia jest:
script-src https://script.chatlab.com;
style-src https://script.chatlab.com https://fonts.googleapis.com;
connect-src https://api.chatlab.com wss://api.chatlab.com;
font-src https://fonts.gstatic.com;
Tryb Iframe
Strona nadrzędna musi zezwalać na źródło z adresu URL skopiowanego iframe. W przypadku standardowego hostingu ChatLab dodaj to do istniejącej polityki:
frame-src https://api.chatlab.com;