Przejdź do głównej treści
ChattyBox Logo

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 we wdrożonym źródle strony.
  • 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.
  • Ta sama powłoka aplikacji usuwa skrypt podczas nawigacji po stronie klienta.
  • Polityka bezpieczeństwa treści blokuje https://chattybox.ai/widget.js.
  • CSS lub inny widget nakłada się na program uruchamiający.

Najmniejsza poprawka:

  1. Otwórz wdrożoną stronę publiczną w oknie incognito.
  2. Wyszukaj źródło strony dla chattybox.ai/widget.js.
  3. Upewnij się, że skrypt pojawia się raz i zawiera data-api-key i data-api-url.
  4. 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="https://app.chattybox.ai"
  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ł lub został utworzony dla innego projektu.
  • Klucz tymczasowy został wdrożony w środowisku produkcyjnym lub klucz produkcyjny został wdrożony w środowisku tymczasowym.
  • Klucz pozwolił na pochodzenie, ale bieżące pochodzenie witryny nie jest uwzględnione.
  • Strona jest ładowana z http://localhost, adresu URL podglądu lub domeny niestandardowej, która nie jest dozwolona dla tego klucza.

Poprawki:

  1. Otwórz projekt w panelu kontrolnym ChattyBox.
  2. Skopiuj nowy fragment z karty Umieść.
  3. Jeśli skonfigurowano dozwolone źródła, dodaj dokładne źródło obsługujące stronę, łącznie z protokołem i nazwą hosta.
  4. Wdróż lub ponownie opublikuj witrynę i przetestuj ponownie w oknie incognito.

Zły język​

Widget wybiera język w następującej kolejności:

  1. data-locale w skrypcie widżetu.
  2. Wartość strony <html lang>.
  3. Język przeglądarki odwiedzającego.
  4. Angielski rezerwowy.

Poprawki:

  • Usuń niepoprawną wartość data-locale, jeśli strona powinna automatycznie wykrywać język.
  • 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.
  • Jeśli odpowiedzi cytują lub pobierają treść z niewłaściwego języka, ponownie zeskrobuj wszystkie wersje językowe.

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 polegania na zrzutach ekranu, filmach, ukrytych akordeonach lub treściach iframe jako jedynym źródle.
  • Zeskrob ponownie zaktualizowaną stronę i przetestuj ponownie.

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 przekierowuje, blokuje roboty, wymaga uwierzytelnienia lub jest wykluczana przez reguły robots.
  • Zawartość strony uległa zmianie po ostatnim skrobaniu.
  • Treść jest renderowana w sposób uniemożliwiający robotowi wyodrębnienie przydatnego tekstu.

Poprawki:

  1. Potwierdź, że strona otwiera się publicznie w prywatnym oknie przeglądarki.
  2. Użyj trybu mapy witryny, aby uzyskać szeroki zasięg, lub ręcznych adresów URL dla wybranego zestawu.
  3. Prześlij kanoniczny adres URL zamiast adresu URL monitorującego, adresu URL przekierowania lub adresu URL logowania.
  4. Zeskrob ponownie po opublikowaniu zmian w treści.
  5. Sprawdź pulpit nawigacyjny pod kątem nieudanych lub pominiętych stron.

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-key i data-api-url.
  • Jedno pytanie testowe, które powinno działać, i strona źródłowa, która na nie odpowiada.