Lista kontrolna przed uruchomieniem

Użyj tej listy kontrolnej, zanim udostępnisz ChattyBox klientom. Wykrywa typowe braki konfiguracji, przez które chatbot wygląda na zainstalowany, ale nie jest gotowy.

W przypadku wdrożenia wsparcia połącz tę listę z przewodnikiem po chatbocie AI do obsługi klienta, aby odpowiedzi z treści publicznych miały jasną ścieżkę eskalacji w przypadku pytań dotyczących konta, kwestii wrażliwych lub nierozwiązanych problemów.

Gotowość treści

• Wybrano publiczne treści dostępne do crawlowania, które wolno indeksować i na podstawie których chatbot ma odpowiadać.
• Strony prywatne, administracyjne, płatności, konta, wersje robocze i staging wykluczono przez świadomy wybór źródeł. Nie polegaj na robots.txt — crawler nie egzekwuje jego dyrektyw.
• Wybrano sitemap, ręczne URL-e, homepage lub crawl; crawl najpierw sprawdza standardowe lokalizacje sitemap, a dopiero potem przechodzi do linków. Nie uzupełnia niepełnej sitemap linkami.
• Uwzględniono ważne strony produktu, cen, zasad, pomocy, FAQ, wdrażania i rozwiązywania problemów.
• Wielojęzyczna witryna zawiera wersje językowe, z których widżet ma odpowiadać.

Weryfikacja skanowania

• Zadanie się zakończyło; porównano liczbę zapisanych i wybranych stron oraz rzeczywistą listę stron w widoku Baza wiedzy → Strony. Status Completed sam nie dowodzi pełnego pokrycia.
• Liczba zindeksowanych stron odpowiada oczekiwaniom dla planu i zakresu uruchomienia.
• Sprawdzono strony Partially indexed pod kątem brakującego tekstu ponad limit 512 KiB; w razie potrzeby długie strony podzielono.
• Zakończyło się oddzielne zadanie embeddingów, a wyszukiwanie przetestowano na reprezentatywnych pytaniach.
• Ostatnio edytowane lub migrowane strony zostały przeskanowane ponownie.
• Brakujące strony sprawdzono pod kątem uwierzytelniania, wyzwań antybotowych, nieudanych lub niebezpiecznych przekierowań, filtrów źródeł i treści dostępnych wyłącznie przez JavaScript. Ważny tekst znajduje się w pobieranym HTML i nie wymaga renderowania JavaScriptu.
• Nieaktualne zapisane strony usunięto z widoku Baza wiedzy → Strony, a nie tylko z sitemap; skorygowano też źródło w Baza wiedzy → Import i odświeżanie, aby nie zostały ponownie odkryte.

Zużycie i uprawnienia

• Właściciel projektu ma dostęp do panelu i może zarządzać chatbotem; klucze publiczne ani członkostwo w organizacji same w sobie nie dają uprawnień do panelu.
• W Rozliczenia i wykorzystanie (/settings/account) sprawdzono, czy właścicielowi wystarczy wspólny dla jego chatbotów limit wiadomości na testy i ruch po uruchomieniu.
• Sprawdzono limit zapisanych stron współdzielony przez chatboty właściciela oraz oddzielny miesięczny budżet odświeżania stron. Ręczne przebudowy indeksu również zużywają budżet odświeżania.
• Harmonogram odświeżania odpowiada planowi: Free najwyżej raz w tygodniu, płatne plany najwyżej raz dziennie. Ręczne ponowienia skanowania podlegają temu samemu okresowi karencji, także po nieudanym zadaniu.
• W Pro/Business PAYG jest wyłączone, ma limit dla każdej funkcji albo jest celowo bez limitu; PAYG nie znosi okresu karencji ani miesięcznego budżetu odświeżania crawlera.
• Jeśli używasz blokady konfiguracji, znasz jej nieodwracalne ograniczenia oraz odrębny, poufny przepływ pracy z tokenem wdrożeniowym.

Jakość odpowiedzi

• Zadano prawdziwe pytania testowe z przypadków użycia sprzedaży, pomocy, wdrażania i dokumentacji.
• Sprawdzono, czy reprezentatywne odpowiedzi są oparte na zindeksowanej treści i czy pytania bez wsparcia otrzymują oczekiwaną odpowiedź fallback. Oceń odpowiedzi — udany test nie gwarantuje poprawności wszystkich przyszłych odpowiedzi.
• Przydatne odpowiedzi zawierają cytowania źródeł.
• Linki cytowań otwierają oczekiwane publiczne strony źródłowe.
• Słabe odpowiedzi naprawiono przez ulepszenie treści źródłowych lub dodanie brakujących stron, a następnie ponowne skanowanie.
• Jeśli zmieniono Personę, sprawdź, czy status automatycznego zapisu potwierdza zapisanie zmian; przed testem popraw błędy walidacji lub ponów nieudaną próbę zapisu. Osobno przetestuj wymuszoną odpowiedź fallback. Sformułowania Persony nie zastępują skonfigurowanej odpowiedzi przy braku kontekstu.
• Pytania testowe zawierają potrzebny kontekst: generator odpowiedzi otrzymuje najwyżej 12 ostatnich zapisanych wiadomości, każdą skróconą do 2 000 znaków, a nie całą rozmowę.

Instalacja widżetu

• Widżet jest zainstalowany na przeznaczonych do tego stronach publicznych.
• Skrypt ładuje się tylko raz na stronie.
• Skrypt zawiera data-api-key.
• Skrypt zawiera data-api-url.
• Tryby Wykryj automatycznie / Stały oraz Zezwalaj na nadpisanie przez skrypt ustawiono celowo. data-locale ma pierwszeństwo tylko wtedy, gdy nadpisanie jest dozwolone — również w trybie Stały.
• Osobno przetestowano język interfejsu widżetu, język pytań i odpowiedzi oraz zindeksowane wersje językowe.
• Widżet otwiera się i wysyła pytanie testowe w oknie incognito.
• Testowanie widoku mobilnego potwierdza, że przycisk uruchamiający i panel czatu są użyteczne.

Kontrola klucza API i originu

• Właściwy klucz publiczny wybrano w Instalacja → Instalacja na stronie; jego ustawieniami można zarządzać w Klucze i domeny.
• Rotację klucza przeprowadzono, instalując i testując nowy klucz przed usunięciem starego. Sama nazwa klucza nie ogranicza środowiska.
• Klucz publiczny przetestowano w docelowych witrynach produkcyjnych, preview/staging i localhost. Sprawdź jego ograniczenia: klucz przygotowany dla witryny może już być ograniczony do jej originu; klucze bez ograniczeń działają ze wszystkich originów przeglądarki.
• Jeśli włączono opcjonalne dodatkowe zabezpieczenie, w Klucze i domeny → Edytuj originy podano dokładne originy (schemat, host i port muszą się zgadzać). Ograniczenie originu nie uwierzytelnia odwiedzających, a publiczne klucze przeglądarkowe nie są sekretami.
• W kodzie frontendu, GTM, niestandardowym HTML CMS ani źródle strony nie ma prywatnych kluczy API serwera, tokenów administratora ani sekretów.

Kontrole przeglądarki i wdrożenia

• Konsola przeglądarki nie zawiera błędów ChattyBox.
• Content Security Policy zezwala na skrypt widżetu i adres URL API, jeśli witryna korzysta z CSP.
• Blokery reklam ani narzędzia zgody nie blokują widżetu na stronach, na których powinien być widoczny.
• Przetestowano ostateczną wdrożoną witrynę, a nie tylko środowisko lokalne.

Po uruchomieniu

• Na każdym planie przeglądaj Rozmowy → Historia, a w Pro/Business także Analitykę i Pytania bez odpowiedzi.
• Interpretuj Analitykę jako maksymalnie 5 000 zarejestrowanych interakcji z ostatnich 30 dni, w tym z Czatu testowego — nie jako potwierdzenie dokładności odpowiedzi ani wyłącznie ruchu odwiedzających.
• Sprawdzaj wykryte luki, ponownie testuj poprawioną treść i ręcznie oznaczaj luki jako rozwiązane. Domyślna lista ukrywa rozwiązane luki; Uwzględnij rozwiązane luki. i Cofnij pozwalają je wyświetlić i ponownie otworzyć. Ponowne wystąpienie pytania nie otwiera luki automatycznie.
• Jeśli ważne jest przypisanie strony, sprawdź Popularne wyzwalacze. Hostowany widżet wysyła kontekst strony, w tym jej ścieżkę (pathname); nie ładuj go ani nie pozostawiaj na wrażliwych lub prywatnych trasach. Sama zmiana trasy w SPA nie usuwa już zainicjowanego widżetu. Przy jego usuwaniu użyj metody właściwej dla integracji: hostowany loader v16 w bieżącym kodzie udostępnia window.ChattyBox.destroy(); przy montowaniu przez SDK wywołaj handle.remove() dla każdego uchwytu zwróconego przez mountWidget(). Sprawdź obsługę we wdrożonej wersji loadera. Headless SDK sendMessage() nie wysyła kontekstu strony źródłowej.
• Dodaj brakującą dokumentację, FAQ lub przykłady na podstawie prawdziwych pytań odwiedzających.
• Po zmianach treści ponownie przeskanuj zaktualizowane strony.
• W razie potrzeby obróć publiczne klucze widżetu; ograniczenia originów zmieniaj tylko wtedy, gdy są włączone opcjonalne ograniczenia i zmieniają się dozwolone domeny.
• Nie usuwaj rozmów w celu zresetowania zużycia ani analityki — te dane są przechowywane osobno.

Jeśli którykolwiek punkt się nie zgadza, przed uruchomieniem użyj sekcji Rozwiązywanie problemów.