Integracja chatbota z WordPress
Niniejsza instrukcja przeprowadzi Cię przez proces integracji naszego chatbota z Twoją stroną WordPress. Po wykonaniu wszystkich kroków, Twoi klienci będą mogli komunikować się z chatbotem bezpośrednio na Twojej stronie internetowej.
Ważne wymagania wstępne: Aby przeprowadzić integrację, potrzebujesz posiadać stronę WordPress z uprawnieniami administratora oraz mieć możliwość instalowania i aktywowania wtyczek.
Spis treści
- 0Przegląd procesu integracji
- 1Konfiguracja widgetu chatbota
- 2Przejście do panelu administracyjnego WordPress
- 3Instalacja wtyczki AI Chat Widget
- 4Pobranie kodu do osadzenia
- 5Konfiguracja wtyczki w WordPress
- 6Wybór stron do wyświetlania chatbota
- 7Testowanie integracji
- 8Rate Limiting
- 9Rozwiązywanie problemów
Wybierz swój punkt startowy
Konfiguracja widgetu
Nie mam jeszcze skonfigurowanego widgetu chatbota
Integracja z WordPress
Mam już skonfigurowany widget i chcę go dodać do mojej strony WordPress
0
Przegląd procesu integracji
Integracja chatbota z WordPress to prosty proces, który składa się z kilku głównych etapów:
- Konfiguracja widgetu chatbota - utworzenie i konfiguracja chatbota na naszej platformie.
- Instalacja wtyczki WordPress - pobranie i instalacja dedykowanej wtyczki AI Chat Widget.
- Pobranie kodu osadzania - skopiowanie kodu z naszej platformy.
- Konfiguracja wtyczki - wklejenie kodu i konfiguracja ustawień wyświetlania.
- Testowanie integracji - sprawdzenie poprawności działania chatbota na stronie WordPress.
Czas realizacji: Cały proces integracji zajmuje zwykle od 10 do 15 minut, w zależności od Twojego doświadczenia z platformą WordPress. Poniższa instrukcja przeprowadzi Cię krok po kroku przez wszystkie etapy.
Wskazówka: Przed rozpoczęciem procesu integracji, upewnij się, że masz dostęp do:
- Panelu administracyjnego WordPress z uprawnieniami do instalacji wtyczek
- Konta na naszej platformie AI Chatbot z aktywną subskrypcją
- Skonfigurowanego widgetu chatbota
1
Konfiguracja widgetu chatbota
Pierwszym krokiem integracji jest utworzenie i konfiguracja widgetu chatbota na naszej platformie. Widget ten będzie następnie osadzony na Twojej stronie WordPress.
Jeśli nie masz jeszcze skonfigurowanego widgetu chatbota, postępuj zgodnie z poniższymi instrukcjami. Jeśli już masz skonfigurowany widget, możesz przejść bezpośrednio do kroku 2.
Szczegółowa instrukcja konfiguracji widgetu: Pełna instrukcja konfiguracji widgetu chatbota jest dostępna na stronie Instrukcja konfiguracji widgetu. Zalecamy otworzyć tę instrukcję w nowej karcie i postępować zgodnie z nią, aby skonfigurować widget przed kontynuowaniem integracji z WordPress.
Po skonfigurowaniu widgetu chatbota zgodnie z instrukcją, wróć do tej strony, aby kontynuować proces integracji z WordPress.
2
Przejście do panelu administracyjnego WordPress
Po skonfigurowaniu widgetu chatbota, kolejnym krokiem jest przejście do panelu administracyjnego WordPress, gdzie zainstalujemy dedykowaną wtyczkę.
Szczegółowa instrukcja:
- Otwórz przeglądarkę internetową i przejdź do adresu Twojego panelu administracyjnego WordPress. Zazwyczaj jest to https://twojadomena.pl/wp-admin/ lub https://twojadomena.pl/wp-login.php.
- Zaloguj się do panelu administracyjnego, używając swoich danych dostępowych (nazwa użytkownika i hasło).
- Po zalogowaniu zostaniesz przekierowany do kokpitu WordPress (Dashboard), który jest głównym panelem administracyjnym.
Uprawnienia administratora: Aby zainstalować wtyczkę, potrzebujesz konta z uprawnieniami administratora. Jeśli logujesz się jako użytkownik z uprawnieniami niższymi niż administrator (np. redaktor, autor), możesz nie mieć dostępu do instalacji wtyczek. W takim przypadku poproś administratora strony o pomoc.
3
Instalacja wtyczki AI Chat Widget
W tym kroku zainstalujemy dedykowaną wtyczkę AI Chat Widget, która umożliwi integrację chatbota z Twoją stroną WordPress.
Szczegółowa instrukcja:
- W panelu bocznym WordPress znajdź opcję Wtyczki (Plugins) i kliknij na nią.
- W sekcji Wtyczki, kliknij przycisk Dodaj nową (Add Plugin) znajdujący się na górze strony.
- Kliknij przycisk Prześlij wtyczkę (Upload Plugin) znajdujący się w górnej części ekranu po lewej stronie.
- Pobierz wtyczkę AI Chat Widget, klikając poniższy przycisk:
- Po pobraniu pliku ZIP, wróć do panelu WordPress i kliknij przycisk Wybierz plik.
- Wybierz pobrany plik ZIP wtyczki AI Chat Widget.
- Kliknij przycisk Zainstaluj teraz (Install Now).
- Po zakończeniu instalacji, kliknij przycisk Włącz wtyczkę (Activate Plugin).
Ekran instalacji wtyczki w WordPress
Wskazówka dotycząca bezpieczeństwa: Zawsze pobieraj wtyczki z zaufanych źródeł. Nasza wtyczka AI Chat Widget jest bezpieczna i regularnie aktualizowana, aby zapewnić kompatybilność z najnowszymi wersjami WordPress.
Rozwiązywanie typowych problemów z instalacją:
Błąd: "Przekroczono maksymalny rozmiar pliku"
Ten błąd występuje, gdy rozmiar pliku wtyczki przekracza limit ustawiony na serwerze.
Rozwiązanie:
- Skontaktuj się z administratorem serwera i poproś o zwiększenie limitu upload_max_filesize w pliku php.ini.
- Alternatywnie, możesz zainstalować wtyczkę ręcznie poprzez FTP:
- Rozpakuj pobrany plik ZIP na swoim komputerze
- Połącz się z serwerem przez FTP
- Przejdź do katalogu wp-content/plugins/
- Prześlij rozpakowany folder wtyczki
- Wróć do panelu WordPress i aktywuj wtyczkę w sekcji Wtyczki
Błąd: "Nie można utworzyć katalogu"
Ten błąd występuje, gdy WordPress nie ma wystarczających uprawnień do zapisu w katalogu wtyczek.
Rozwiązanie:
- Skontaktuj się z administratorem serwera i poproś o nadanie odpowiednich uprawnień do katalogu wp-content/plugins/.
- Typowe uprawnienia dla katalogu wtyczek to 755 (rwxr-xr-x).
- Alternatywnie, zainstaluj wtyczkę ręcznie przez FTP, jak opisano powyżej.
Wtyczka została zainstalowana, ale nie jest widoczna
Czasami wtyczka może być zainstalowana, ale nie pojawia się na liście wtyczek.
Rozwiązanie:
- Odśwież stronę z listą wtyczek.
- Sprawdź, czy wtyczka nie jest ukryta na kolejnych stronach listy (jeśli masz wiele wtyczek).
- Użyj funkcji wyszukiwania na stronie wtyczek, aby znaleźć "AI Chat Widget".
- Jeśli wtyczka nadal nie jest widoczna, spróbuj wyczyścić pamięć podręczną przeglądarki lub zalogować się ponownie do panelu WordPress.
4
Pobranie kodu do osadzenia
Po zainstalowaniu wtyczki, potrzebujemy skopiować kod osadzania chatbota z naszej platformy, który następnie wkleimy do konfiguracji wtyczki WordPress.
Szczegółowa instrukcja:
- Otwórz nową kartę w przeglądarce i zaloguj się do swojego konta na platformie AI Chatbot.
- Przejdź do sekcji Dashboard w panelu nawigacyjnym.
- Znajdź skonfigurowany wcześniej widget chatbota i kliknij
Opcje a następnie Kod do osadzenia. - Wyświetli się okno z kodem JavaScript do osadzenia chatbota.
- Kliknij przycisk Kopiuj lub zaznacz cały kod i skopiuj go do schowka (Ctrl+C lub Cmd+C).
Okno z kodem do osadzenia chatbota
5
Konfiguracja wtyczki w WordPress
Teraz wrócimy do panelu WordPress, aby skonfigurować wtyczkę AI Chat Widget i wkleić skopiowany kod osadzenia.
Szczegółowa instrukcja:
- Wróć do panelu administracyjnego WordPress.
- W menu bocznym znajdź nowo dodaną opcję AI Chat Widget i kliknij na nią. Jeśli nie widzisz tej opcji, możesz odnaleźć wtyczkę przechodząc do sekcji Wtyczki (Plugins) następnie do Pobrane Wtyczki (Installed Plugins) i wyszukać wtyczkę po nazwie "AI Chat Widget". Aby wtyczka była widoczna w menu bocznym należy kliknąć przycisk Activate.
- Zostaniesz przekierowany do strony konfiguracji wtyczki AI Chat Widget.
- Na stronie konfiguracji wtyczki znajdź sekcję Kod osadzenia chatbota.
- Kliknij przycisk Edytuj kod i wklej skopiowany wcześniej kod osadzenia (Ctrl+V lub Cmd+V). Zatwierdz wprowadzony skrypt przyciskiem Zastosuj zmiany.
- Kliknij przycisk Zapisz zmiany na dole strony, aby zachować wprowadzone zmiany.
Strona konfiguracji wtyczki AI Chat Widget
Uwaga: Upewnij się, że kod został wklejony w całości i bez żadnych dodatkowych znaków. Jakiekolwiek modyfikacje kodu mogą spowodować, że chatbot nie będzie działał poprawnie.
6
Wybór stron do wyświetlania chatbota
W tym kroku skonfigurujemy, na których stronach i podstronach Twojej witryny WordPress ma być wyświetlany chatbot.
Szczegółowa instrukcja:
- Na stronie konfiguracji wtyczki AI Chat Widget, przewiń w dół do sekcji Ustawienia wyświetlania.
- Znajdziesz tu opcje wyboru stron, na których chatbot ma być wyświetlany:
- Na wszystkich stronach - chatbot będzie wyświetlany na każdej stronie i podstronie Twojej witryny
- Tylko na stronie głównej - chatbot będzie wyświetlany tylko na stronie głównej
- Na wybranych stronach - chatbot będzie wyświetlany na wszystkich zaznaczonych stronach
- Wybierz odpowiednią opcję zgodnie z Twoimi preferencjami.
- Jeśli wybrałeś opcję Na wybranych stronach, pojawi się lista stron Twojej witryny. Zaznacz odpowiednie strony zgodnie z Twoimi preferencjami.
- Po dokonaniu wyboru, kliknij przycisk Zapisz zmiany, aby zatwierdzić konfigurację.
Strategiczne umieszczenie chatbota: Rozważ strategicznie, na których stronach chatbot będzie najbardziej przydatny. Na przykład, strony kontaktowe, strony produktowe i strony FAQ to typowe miejsca, gdzie użytkownicy często potrzebują pomocy. Jednocześnie, na niektórych stronach (np. polityka prywatności, warunki korzystania) chatbot może nie być konieczny.
Wskazówka: Możesz zawsze zmienić te ustawienia później. Warto rozpocząć od umieszczenia chatbota na kluczowych stronach i monitorować interakcje użytkowników. Na podstawie zebranych danych możesz później zoptymalizować umieszczenie chatbota.
7
Testowanie integracji
Po skonfigurowaniu wszystkich niezbędnych elementów, czas na przetestowanie integracji i upewnienie się, że chatbot działa zgodnie z oczekiwaniami na Twojej stronie WordPress.
Szczegółowa instrukcja testowania:
- Test widoczności chatbota:
- Otwórz swoją stronę WordPress w nowej karcie przeglądarki
- Przejdź do jednej ze stron, na których skonfigurowałeś wyświetlanie chatbota
- Sprawdź, czy ikona chatbota jest widoczna w odpowiednim miejscu (zazwyczaj w prawym dolnym rogu)
- Jeśli nie widzisz ikony, odśwież stronę (czasami jest to konieczne po pierwszej instalacji)
- Test interakcji z chatbotem:
- Kliknij na ikonę chatbota, aby go otworzyć
- Upewnij się, że chatbot otwiera się poprawnie i wyświetla wiadomość powitalną
- Wyślij testową wiadomość, np. "Cześć" lub "Dzień dobry"
- Sprawdź, czy chatbot odpowiada na wiadomość
- Test na różnych stronach:
- Przejdź do innych stron swojej witryny, aby sprawdzić, czy chatbot pojawia się zgodnie z konfiguracją
- Sprawdź zarówno strony, na których chatbot powinien być widoczny, jak i te, gdzie nie powinien się pojawiać
- Test na różnych urządzeniach:
- Sprawdź, jak chatbot wygląda i działa na urządzeniu mobilnym (możesz użyć narzędzi deweloperskich przeglądarki, aby symulować urządzenie mobilne)
- Upewnij się, że chatbot jest użyteczny i nie przeszkadza w korzystaniu ze strony na małym ekranie
Wskazówka dotycząca testowania: Warto przetestować chatbota w trybie incognito przeglądarki lub wyczyścić pamięć podręczną przeglądarki przed testowaniem. Dzięki temu będziesz mieć pewność, że chatbot działa poprawnie dla nowych użytkowników.
8
Rate Limiting
Rate limiting to mechanizm ograniczający liczbę wiadomości, które użytkownik może wysłać do chatbota w określonym czasie. Chroni to system przed nadmiernym obciążeniem i zapewnia sprawiedliwe wykorzystanie zasobów.
Jak działa Rate Limiting:
- Limit per użytkownik: Każdy użytkownik ma swój własny limit (nie dzielony z innymi)
- Okno czasowe: 60 sekund
- Reset automatyczny: Licznik resetuje się co minutę
- Konfigurowalny limit: Każdy użytkownik może mieć różny limit ustawiony przez administratora
Co to oznacza dla użytkowników:
Gdy użytkownik osiągnie swój limit wiadomości w ciągu minuty, chatbot wyświetli mu komunikat informujący o konieczności odczekania przed wysłaniem kolejnej wiadomości. Po upływie minuty od pierwszej wiadomości w danym oknie czasowym, licznik automatycznie się resetuje.
Rate limitng a jakość obsługi: Rate limiting nie wpływa na jakość obsługi użytkowników w normalnym użytkowaniu. Standardowe limity są ustawione na poziomie umożliwiającym naturalne rozmowy, chroniąc jednocześnie przed automatycznymi atakami lub nadmiernym użytkowaniem systemu.
Zwiększenie limitów rate limitingu:
Jeśli standardowe limity rate limitingu nie są wystarczające dla Twojego przypadku użycia (np. w przypadku chatbotów o bardzo wysokim ruchu lub specjalistycznych zastosowań), możesz poprosić o ich zwiększenie.
Jak zwiększyć limity: W celu zwiększenia limitów rate limitingu dla Twojego chatbota, skontaktuj się z administracją strony ChatbotAssistant. W wiadomości opisz swój przypadek użycia, oczekiwany ruch oraz uzasadnienie dla wyższych limitów.
9
Rozwiązywanie problemów
Mimo starannego wykonania wszystkich kroków integracji, czasami mogą pojawić się problemy z działaniem chatbota. W tej sekcji przedstawiamy rozwiązania najczęściej występujących problemów.
Typowe problemy i ich rozwiązania:
Chatbot nie pojawia się na stronie
Możliwe przyczyny:
- Kod osadzenia nie został poprawnie wklejony lub zapisany
- Wtyczka nie jest aktywna
- Konflikty z innymi wtyczkami lub motywem WordPress
- Ustawienia wyświetlania wykluczają aktualną stronę
- Problemy z pamięcią podręczną przeglądarki lub systemu buforowania WordPress
Rozwiązanie:
- Upewnij się, że wtyczka AI Chat Widget jest aktywna w sekcji Wtyczki
- Sprawdź, czy kod osadzenia został poprawnie wklejony w konfiguracji wtyczki
- Zweryfikuj ustawienia wyświetlania i upewnij się, że chatbot jest skonfigurowany do wyświetlania na stronie, którą testujesz
- Wyczyść pamięć podręczną przeglądarki i odśwież stronę
- Jeśli używasz wtyczki do buforowania (np. WP Super Cache, W3 Total Cache), wyczyść bufor strony
- Tymczasowo wyłącz inne wtyczki, aby sprawdzić, czy nie powodują konfliktu
Chatbot jest widoczny, ale nie odpowiada na wiadomości
Możliwe przyczyny:
- Problemy z połączeniem do serwera chatbota
- Błędy w konfiguracji chatbota na platformie AI Chatbot
- Wygasły token dostępu lub błędny identyfikator chatbota
- Blokady w przeglądarce (np. blokowanie skryptów, polityka Same-Origin)
Rozwiązanie:
- Otwórz konsolę deweloperską przeglądarki (F12 lub Ctrl+Shift+I), aby sprawdzić, czy występują błędy JavaScript
- Zaloguj się do platformy AI Chatbot i upewnij się, że chatbot jest aktywny i działa poprawnie w środowisku testowym
- Wygeneruj nowy kod osadzenia na platformie i zaktualizuj go w konfiguracji wtyczki
- Wyłącz rozszerzenia przeglądarki, które mogą blokować skrypty (np. adblocker, blokery śledzenia)
- Sprawdź, czy Twoja strona używa HTTPS - chatbot może wymagać bezpiecznego połączenia
Chatbot wygląda nieprawidłowo na stronie
Możliwe przyczyny:
- Konflikty ze stylami motywu WordPress
- Responsywne problemy na urządzeniach mobilnych
- Niestandardowe modyfikacje CSS na stronie
- Niekompatybilne wersje bibliotek JavaScript
Rozwiązanie:
- Sprawdź, czy chatbot wygląda nieprawidłowo tylko na określonych stronach czy na całej witrynie
- Użyj narzędzi deweloperskich przeglądarki, aby zidentyfikować konflikty CSS
- Skontaktuj się z twórcą motywu, jeśli podejrzewasz, że to motyw powoduje problemy
- Sprawdź wersję jQuery używaną przez Twoją stronę - niektóre starsze motywy mogą używać przestarzałych wersji
Po aktualizacji WordPress chatbot przestał działać
Możliwe przyczyny:
- Niekompatybilność wtyczki z nową wersją WordPress
- Zmiany w sposobie ładowania skryptów w nowej wersji WordPress
- Problemy z pamięcią podręczną po aktualizacji
- Błędy w aktualizacji WordPress
Rozwiązanie:
- Sprawdź, czy wtyczka AI Chat Widget jest aktualna - może wymagać aktualizacji do najnowszej wersji
- Wyczyść wszystkie bufory i pamięć podręczną po aktualizacji WordPress
- Wyłącz i ponownie włącz wtyczkę AI Chat Widget
- Sprawdź, czy w konsoli deweloperskiej przeglądarki nie pojawiają się nowe błędy
- Pobierz najnowszą wersję wtyczki z naszej strony i zainstaluj ją ponownie
- Jeśli problem nadal występuje, skontaktuj się z naszym zespołem wsparcia
Wsparcie techniczne: Jeśli napotkasz problemy, których nie możesz rozwiązać samodzielnie, skontaktuj się z naszym zespołem wsparcia technicznego. Przygotuj szczegółowy opis problemu, zrzuty ekranu błędów oraz informacje o Twojej wersji WordPress i użytym motywie, aby przyspieszyć proces rozwiązywania problemu.