Pierwsze kroki
Udokumentowane limity stron w pakiecie są współdzielone przez projekty właściciela. Sprawdź limity planów w cenniku, a bieżące wykorzystanie i dostępny limit konta w Konto i rozliczenia w panelu.
Zbuduj użytecznego chatbota, zanim umieścisz go w swojej witrynie. Podstawowa kolejność to utwórz → dodaj treść → przejrzyj → przetestuj → dostosuj → zintegruj.
1. Utwórz konto i projekt
Zaloguj się do panelu ChattyBox, wybierz Nowy chatbot, podaj nazwę oraz opcjonalny Adres URL strony. Po utworzeniu projekt otwiera się w Baza wiedzy → Import i odświeżanie. Jeśli otworzysz projekt bez wybranej zakładki, domyślnie zobaczysz Przegląd. Samo utworzenie projektu nie rozpoczyna importu.
Aktualne limity projektów, stron i wykorzystania znajdziesz na stronie cennika.
2. Skonfiguruj źródło treści
W Baza wiedzy → Import i odświeżanie połącz publiczną witrynę, przejrzyj wykryte strony, dostosuj zalecany lub własny wybór, a następnie uruchom import lub odświeżenie wybranych stron. Zmiany ustawień źródła zapisują się automatycznie: przed kontynuowaniem sprawdź stan zapisu, popraw błędy walidacji lub ponów nieudany zapis. Zaawansowane ustawienia źródła zawierają osobną akcję Zbieraj teraz, która korzysta ze skonfigurowanego trybu wykrywania. Reguły include/exclude i głębokość crawl są dostępne przez konfigurację jako kod, a nie w panelu.
ChattyBox pobiera czytelną treść HTML i kolejkuje zmienioną treść do indeksowania. Samo wykrywanie stron ani automatyczny zapis nie rozpoczynają importu. Usługa nie renderuje JavaScriptu ani nie egzekwuje robots.txt; wybieraj publiczne strony, które masz prawo indeksować, i świadomie określ zakres na start. Czas zależy od wykrywania, liczby stron i indeksowania.
Skorzystaj z Dodawanie i odświeżanie treści, gdy potrzebujesz wskazówek dotyczących mapy witryny, ręcznego adresu URL, indeksowania, treści wielojęzycznych lub ponownego skanowania.
3. Przejrzyj zindeksowaną treść
Otwórz Baza wiedzy → Strony i porównaj faktycznie zapisane strony z oczekiwanymi źródłami. Otwórz zadanie importu, aby sprawdzić liczniki i ostrzeżenia o częściowej treści, a przed oceną odpowiedzi sprawdź także osobne zadanie przygotowania embeddingów. Ukończony import nie gwarantuje, że każda żądana strona ani każda jej sekcja została zindeksowana. Zobacz postęp i częściowe indeksowanie.
4. Przetestuj jakość odpowiedzi
Otwórz Przetestuj chatbota i zadawaj reprezentatywne pytania, które będą zadawać prawdziwi odwiedzający. Sprawdź, czy odpowiedzi:
- korzystają ze zindeksowanej dokumentacji, a nie z nieuzasadnionych założeń;
- zawierają linki do przydatnych stron źródłowych;
- obsługują brakujące informacje za pomocą zamierzonej odpowiedzi awaryjnej;
- działają dla ważnych języków i terminologii.
Gdy odpowiedź jest słaba, popraw treść źródłową lub wybór stron, a następnie odśwież je po upływie limitu częstotliwości planu: Free pozwala na odświeżanie najwyżej raz w tygodniu, a płatne plany — raz dziennie. Testy w widoku Przetestuj chatbota korzystają z limitu wiadomości właściciela i zapisują rozmowy. Testowe interakcje mogą pojawić się w analityce, a jeśli zostaną rozpoznane jako pytania bez odpowiedzi — także w wykrytych lukach w treści; rozliczenie i zapis luki zależą od wyniku. Nie instaluj chatbota tylko dlatego, że pierwszy import się zakończył.
5. Dostosuj środowisko
W Personalizacja → Zachowanie wybierz lub edytuj instrukcje asystenta. Możesz wybrać Helpful Assistant, Sales Representative, Technical Support, Sarcastic Bot lub Custom Persona. Zmiany zapisują się automatycznie — przed kontynuowaniem sprawdź stan zapisu. Edycja gotowego ustawienia przełącza je na Custom. Instrukcje uzupełniają wbudowane zasady oparcia odpowiedzi na źródłach i formatowania; pobrana treść jest dołączana automatycznie, więc nie wklejaj bazy wiedzy do promptu. Persona nie zastępuje wymuszonej odpowiedzi awaryjnej przy braku kontekstu lub luce w treści. Oddzielne ustawienie assistant.fallbackMessage jest dostępne przez konfigurację jako kod, a nie w formularzu Persona. Po zapisie przetestuj zarówno pytania obsługiwane, jak i odpowiedź awaryjną.
Jeśli planujesz użyć hostowanego widżetu, w Personalizacja → Wygląd podejrzyj tytuł, wiadomość powitalną, kolory, ikonę, pozycję i zachowanie językowe. Zmiany zapisują się automatycznie — przed kontynuowaniem sprawdź stan zapisu. Tryb Stały i nadpisania skryptu wpływają na język interfejsu widżetu, a nie na język indeksowanych stron; zobacz rozwiązywanie problemów z językiem. Plan Free obejmuje stylizację, ale wymaga brandingu ChattyBox; od planu Starter można go ukryć.
Te ustawienia wybierz dopiero po przetestowaniu treści, aby konfiguracja wizualna nie ukryła problemów z wyszukiwaniem ani dokumentacją.
6. Wybierz integrację
| Cel | Następny krok |
|---|---|
| Zamontować utrzymywany interfejs ChattyBox z poziomu kodu aplikacji | JavaScript SDK |
| Zbudować i utrzymywać własny interfejs | Headless JavaScript SDK |
| Pozwolić asystentowi programowania AI zintegrować pakiet npm | Integracja z pomocą AI |
| Zarządzać konfiguracją projektu z poziomu Git i CI | Wdrażanie konfiguracji za pomocą CLI |
| Użyć utrzymywanego interfejsu bez npm ani etapu budowania | Skrypt hostowanego widżetu |
| Dodać utrzymywany widżet do WordPressa bez edytowania motywu | Wtyczka WordPress |
| Dodać utrzymywany widżet do Drupal 10 lub 11 za pomocą Composera | Moduł Drupal |
Integracje przeglądarkowe wymagają publicznego klucza API widżetu. W Instalacja → Instalacja na stronie przygotuj instalację dla witryny albo zarządzaj kluczem bezpiecznym dla przeglądarki w Instalacja → Klucze i domeny. Sprawdź ograniczenia originów: klucz przygotowany dla domeny witryny może już być ograniczony do tego originu, a klucze utworzone bez ograniczeń działają z dowolnego originu. W Edytuj originy możesz opcjonalnie włączyć ograniczenia lub dodać originy produkcyjne, podglądowe, stagingowe i localhost. Przy włączonym ograniczeniu dopasowanie jest dokładne i obejmuje schemat, nazwę hosta oraz port (np. https://example.com i http://localhost:3000 to różne originy). W Instalacja na stronie wybierz klucz i skopiuj wygenerowany fragment oraz adres URL API.
Publiczne klucze widżetu są przeznaczone do umieszczania w kodzie przeglądarki. Tokeny wdrażania konfiguracji i inne dane uwierzytelniające do zarządzania są prywatne i nigdy nie należy dodawać ich do witryny.
Ograniczenia originów są opcjonalnym dodatkowym zabezpieczeniem, a nie uwierzytelnianiem odwiedzających. Aby odzyskać istniejący klucz, wpisz adres URL witryny HTTP(S) w Instalacja na stronie i wybierz klucz we fragmencie. Lista pokazuje niewygasłe klucze bez ograniczeń lub dozwolone dla originu podanego adresu. Aby wybrać klucz z ograniczeniami, wpisz dozwolony origin; sprawdź ograniczenia przez Zarządzaj kluczami i dozwolonymi domenami. Jeśli formularz instalacji jest niedostępny, najpierw wykonaj wskazany w panelu krok konfiguracji. Aby go zmienić, utwórz nowy klucz, zaktualizuj i przetestuj instalację, a następnie usuń stary; usunięcie natychmiast zatrzyma instalacje, które nadal go używają. Klucz należy do jednego chatbota — nazwa „staging” lub „production” nie tworzy granicy środowiska.
7. Zweryfikuj wszystko przed uruchomieniem
Najpierw zainstaluj wybraną integrację w witrynie podglądowej lub stagingowej. Przed szerszą publikacją przetestuj wdrożony origin, nawigację między trasami, cytowania, zachowanie odpowiedzi awaryjnych, układ mobilny i konsolę przeglądarki.
Ukończ listę kontrolną przed uruchomieniem, następnie używaj Rozmowy → Historia na każdym planie oraz Rozmowy → Analityka / Pytania bez odpowiedzi w Pro/Business; więcej informacji znajdziesz na stronie analityki i pytań bez odpowiedzi.
Mapa panelu
Otwórz projekt pod /chatbot/<projectId>. Zakładki są widokami w jednym obszarze roboczym i używają parametru tab, a nie osobnych podstron:
| Widok | Wartość tab | Co można tu zrobić |
|---|---|---|
| Przegląd | overview | Sprawdzić postęp konfiguracji i ostatnią aktywność |
| Baza wiedzy → Import i odświeżanie | settings | Wykrywać, wybierać, importować i odświeżać strony oraz zmieniać ustawienia źródła |
| Baza wiedzy → Strony | content | Przejrzeć strony i zadania importu, usunąć treść lub ponownie zbudować embeddingi |
| Przetestuj chatbota | test | Zadawać pytania i wracać do zapisanych rozmów |
| Rozmowy → Historia | logs | Czytać zapisane rozmowy i usuwać pojedyncze lub wszystkie |
| Rozmowy → Analityka | analytics | Przeglądać ostatnie 30 dni zapisanych interakcji (maks. 5 000); Pro/Business |
| Rozmowy → Pytania bez odpowiedzi | gaps | Przeglądać i rozwiązywać wykryte pytania bez odpowiedzi; Pro/Business |
| Personalizacja → Zachowanie | prompts | Wybierać lub edytować instrukcje asystenta |
| Personalizacja → Wygląd | appearance | Podglądać i dostosowywać wygląd oraz język hostowanego widżetu |
| Instalacja → Klucze i domeny | keys | Tworzyć i usuwać publiczne klucze oraz edytować opcjonalne ograniczenia originów |
| Instalacja → Instalacja na stronie | embed | Przygotować instalację i skopiować fragment z kluczem |
| Ustawienia chatbota | manage | Zarządzać szczegółami chatbota, tokenami wdrożeniowymi i blokadą konfiguracji lub usunąć chatbota |
Lista chatbotów znajduje się pod /dashboard; Przegląd konta — pod /dashboard/overview, a Konto i rozliczenia — pod /settings/account, gdzie dostępne są profil, plan, wykorzystanie wiadomości, portal rozliczeń i ustawienia PAYG. Ścieżki /settings i /settings/billing przekierowują tam. /settings/keys pozwala wybrać projekt przy tworzeniu lub usuwaniu kluczy; opcjonalne ograniczenia originów edytuje się w widoku Klucze i domeny chatbota.
Plany i limity
| Plan | Chatboty | Strony na koncie | Wiadomości miesięcznie |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1 000 |
| Pro | 10 | 5 000 | 10 000 |
| Business | 25 | 25 000 | 50 000 |
Limity wiadomości i przechowywanych stron są limitami właściciela współdzielonymi przez jego chatboty, w tym podczas testów w widoku Przetestuj chatbota. Miesięczny limit prac odświeżania stron i limity częstotliwości odświeżania to osobne ograniczenia; przed dużym importem lub przebudową sprawdź limity odświeżania. Zobacz cennik i bieżące wykorzystanie oraz dostępny limit na stronie Konto i rozliczenia.
PAYG dla wiadomości, stron i witryn jest opcjonalne w Pro/Business i domyślnie wyłączone. W Konto i rozliczenia ustaw miesięczne budżety przekroczeń dla poszczególnych funkcji albo jawnie wybierz Bez limitu wydatków. Budżet równy zero utrzymuje twardy limit dla danej funkcji; brak limitu wydatków pozwala na nieograniczone opłaty za użycie. PAYG nie odblokowuje funkcji w Free/Starter ani nie omija przerw między odświeżeniami crawlera. Nazwę profilu można tam edytować; adresem e-mail zarządza się w ustawieniach konta dostawcy logowania.
Uprawnienia i blokada konfiguracji
Dostęp do projektu w panelu ma wyłącznie jego właściciel (lub użytkownik będący właścicielem starszego obszaru roboczego). Publiczny klucz widżetu nie zapewnia dostępu do ustawień projektu ani zapisanej historii rozmów; samo członkostwo w organizacji nie nadaje tych uprawnień do projektu.
Do zarządzania przez Git/CI w widoku Ustawienia chatbota dostępne są tokeny wdrożeniowe konfiguracji z zakresem środowisk development, preview i/lub production, opcjonalnym terminem wygaśnięcia oraz możliwością unieważnienia. W przeciwieństwie do publicznych kluczy widżetu pełną wartość tokenu wdrożeniowego można zobaczyć tylko podczas jego tworzenia. W tej sekcji dostępna jest też historia wdrożeń.
W widoku Ustawienia chatbota włączenie config lock jest nieodwracalne. Blokuje zapisy konfiguracji z panelu i ręczne operacje na treści, w tym zapis Persona i akcję Zbieraj teraz, nawet jeśli odpowiedni przycisk pozostaje widoczny. Zamiast tego wdrażaj konfigurację przez CLI. Zarządzanie kluczami publicznymi, czyszczenie rozmów i dozwolone planem ustawienie brandingu pozostają poza zablokowanymi polami konfiguracji. Zakresy środowisk tokenu wdrożeniowego uprawniają do wdrożeń, ale nie tworzą osobnych chatbotów ani środowisk dla kluczy przeglądarkowych.
Konfiguracja jako kod udostępnia również ustawienie widget.enabled. Ustawienie go na false wyłącza czat publiczny, w tym headless SDK — nie tylko pływający widżet. W bieżącym formularzu Wygląd nie ma odpowiadającego przełącznika włączania ani wyłączania.