Rozwiązywanie problemów
Użyj tej strony, jeśli widget jest zainstalowany, ale nie zachowuje się zgodnie z oczekiwaniami.
Widżet nie pojawia się
Najpierw sprawdź konsolę przeglądarki. ChattyBox zgłasza brak wymaganych atrybutów.
Najczęstsze przyczyny:
- Skrypt nie jest obecny ani we wdrożonym HTML, ani w żywym DOM.
- Skrypt został dodany do niewłaściwego szablonu, układu, kontenera menedżera tagów lub obszaru kodu CMS.
- Skrypt stoi za regułą zgody lub wyzwalaczem menedżera tagów, który nie został uruchomiony.
- Komponent montujący loader nie uruchamia się na tej trasie.
- Polityka bezpieczeństwa treści blokuje
https://chattybox.ai/widget.js. - CSS lub inny widget nakłada się na program uruchamiający.
Najmniejsza poprawka:
- Otwórz wdrożoną stronę publiczną w oknie incognito.
- Wyszukaj
chattybox.ai/widget.jsw źródle strony i panelu Elements; loader SDK może być tylko w DOM. - Upewnij się, że skrypt pojawia się raz i zawiera
data-api-keyidata-api-url. - Przenieś skrypt do globalnej stopki, układu aplikacji, Docusaurus katalogu głównego lub GTM wyzwalacza All Pages, jeśli go brakuje.
Brakuje data-api-url
Widget kończy działanie wcześniej, gdy brakuje data-api-url.
Użyj pełnego fragmentu z dashboardu lub dodaj wymagany atrybut:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Jeśli Twój panel wyświetla inny adres URL API, użyj wartości panelu zamiast wartości przykładowej.
Nieprawidłowy klucz API lub błędy pochodzenia
Najczęstsze przyczyny:
- Klucz publicznego widżetu został skopiowany niepoprawnie.
- Klucz został usunięty, wygasł albo pochodzi z innego wdrożenia backendu niż API URL.
- Opcjonalne ograniczenie originu jest włączone, ale bieżący origin nie jest uwzględniony.
- Strona jest ładowana z
http://localhost, adresu URL podglądu lub domeny niestandardowej, która nie jest dozwolona dla tego klucza.
Poprawki:
- Otwórz projekt w panelu kontrolnym ChattyBox.
- Skopiuj nowy fragment z karty Umieść.
- Jeśli skonfigurowano dozwolone źródła, dodaj dokładne źródło obsługujące stronę, łącznie z protokołem i nazwą hosta.
- Wdróż lub ponownie opublikuj witrynę i przetestuj ponownie w oknie incognito.
Zły język
Niezawodny ugruntowany chatbot RAG potrzebuje jasnych źródeł dla każdej odpowiedzi.
Widget wybiera język UI w następującej kolejności:
data-locale, tylko gdy Allow Script Override jest włączone.- W trybie Fixed — skonfigurowany język domyślny.
- W Auto —
<html lang>, potem język przeglądarki, potem domyślny.
Poprawki:
- Dla automatyki wybierz Auto-detect oraz usuń błędne
data-localelub wyłącz override. - Ustaw
<html lang="de">,<html lang="fr">lub pasujący kod języka na zlokalizowanych stronach. - Dodaj
data-locale="de"tylko wtedy, gdy strona musi wymusić określony język interfejsu widgetu. - UI locale nie wymusza języka odpowiedzi; zindeksuj i przetestuj każdą wersję treści.
Brak cytatów i słabych odpowiedzi
ChattyBox odpowiedzi ze zindeksowanej treści. Brakujące cytaty lub słabe odpowiedzi zwykle oznaczają, że nie odnaleziono potrzebnej treści źródłowej lub nie odpowiada ona jasno na pytanie.
Poprawki:
- Zadaj to samo pytanie na czacie testowym dashboardu i porównaj cytowane strony.
- Upewnij się, że strona źródłowa jest publiczna i uwzględniona w indeksowaniu.
- Dodaj jasne nagłówki, przykłady, często zadawane pytania i kieruj tekst odpowiedzi na stronę źródłową.
- Unikaj zrzutów, iframe, ukrytego i JavaScript-only content jako jedynego źródła; sprawdź ostrzeżenia częściowej indeksacji i zakończenie embeddingów.
Strony nie zeskrobane lub nieaktualna zawartość
Najczęstsze przyczyny:
- Brakuje strony w przesłanej mapie witryny.
- Ręczny tryb adresu URL nie obejmował strony.
- Strona blokuje zwykłe pobranie HTML, wymaga logowania/CAPTCHA, przekierowuje do zablokowanego celu albo została odfiltrowana lub przekroczyła budżet.
- Zawartość strony uległa zmianie po ostatnim skrobaniu.
- Treść jest dostępna tylko przez JavaScript albo poza wybranym semantycznym korzeniem.
Poprawki:
- Potwierdź, że strona otwiera się publicznie w prywatnym oknie przeglądarki.
- Użyj trybu mapy witryny, aby uzyskać szeroki zasięg, lub ręcznych adresów URL dla wybranego zestawu.
- Prześlij kanoniczny adres URL zamiast adresu URL monitorującego, adresu URL przekierowania lub adresu URL logowania.
- Zeskrob ponownie po cooldownie: 7 dni Free lub 24 godziny dla planów płatnych, także po błędnym zadaniu.
- Porównaj zapisane/wybrane liczby z Content. ChattyBox nie sprawdza
robots.txt; usunięcie URL ze źródła nie usuwa zapisanej strony.
Nadal utknąłem
Zbierz te dane przed skontaktowaniem się z pomocą techniczną:
- Adres URL strony publicznej, na której powinien pojawić się widżet.
- Zrzut ekranu lub kopia dowolnego błędu konsoli przeglądarki.
- Czy na stronie zastosowano zwykły HTML, Next.js, Docusaurus, WordPress, CMS lub Google Tag Manager.
- Określa, czy fragment zawiera
data-api-keyidata-api-url. - Jedno pytanie testowe, które powinno działać, i strona źródłowa, która na nie odpowiada.