Pierwsze kroki

W nadchodzącym wydaniu strony w pakiecie będą współdzielone przez projekty właściciela; do czasu wdrożenia publiczny panel może nadal pokazywać wcześniejsze limity na chatbota.

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 New Chatbot i podaj nazwę oraz opcjonalny Website URL. Po utworzeniu otwórz chatbota z listy: domyślna zakładka Content nie oznacza, że skanowanie już się rozpoczęło.

Aktualne limity projektów, stron i wykorzystania znajdziesz na stronie cennika.

2. Skonfiguruj źródło treści

W Settings zapisz Website URL w General Settings przez Save Changes, a tryb, Maximum Pages i harmonogram w Scraping Configuration przez Save Config. To dwa osobne formularze; include/exclude i głębokość crawl są w CLI, nie w panelu.

Uruchom Scrape Now. ChattyBox pobiera czytelny publiczny HTML i kolejkowuje indeksowanie zmian; nie renderuje JavaScriptu ani nie egzekwuje robots.txt.

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ść

Wróć do Content, porównaj strony z oczekiwanymi źródłami, sprawdź ostrzeżenia częściowej indeksacji i osobne zadanie embeddingów. Ukończony scrape nie dowodzi pełnej indeksacji.

4. Przetestuj jakość odpowiedzi

Otwórz Test Chat 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ść lub wybór źródeł i skanuj po cooldownie (Free tydzień, płatne 24 h). Test Chat zużywa limit wiadomości oraz trafia do tych samych logów i metryk co czat publiczny.

5. Dostosuj środowisko

Persona dodaje instrukcje, ale nie zastępuje wymuszonego fallbacku braku kontekstu; assistant.fallbackMessage jest ustawieniem CLI. W Embed zapisz wygląd i politykę języka widżetu. Fixed/override zmieniają tylko UI, nie język indeksowania ani odpowiedzi.

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. Klucze publiczne domyślnie działają w środowisku produkcyjnym, w wersjach podglądowych, stagingowych i na localhost. Aby opcjonalnie wzmocnić ochronę, otwórz Public Keys > Edit origins, włącz Restrict this key to specific origins i dodaj każdy dozwolony origin przeglądarki. Przy włączonym ograniczeniu originy są dopasowywane dokładnie według schematu, nazwy hosta i portu (na przykład https://example.com i http://localhost:3000 to różne originy). Wróć do Embed, 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.

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 Logs na każdym planie oraz Analytics i Content Gaps w Pro/Business.

Mapa panelu i limity

Projekt otwiera się pod /chatbot/<projectId> z ?tab=content, test, logs, analytics, gaps, prompts, keys, embed lub settings; wszystkie projekty są pod /dashboard, a Account & Billing pod /settings/account. Analytics obejmuje 30 dni i maksymalnie 5 000 interakcji. Free/Starter/Pro/Business zawierają odpowiednio 1/3/10/25 chatbotów, 10/150/5 000/25 000 stron i 100/1 000/10 000/50 000 wiadomości miesięcznie. Limity odświeżeń są odrębne; PAYG jest opcjonalne tylko w Pro/Business i nie znosi cooldownów.

Blokada konfiguracji

Config lock jest nieodwracalny i blokuje zapisy konfiguracji oraz ręczne operacje treści; użyj wtedy CLI. Klucze publiczne, czyszczenie rozmów oraz dozwolone planem ustawienie brandingu pozostają osobne. Zakresy tokenów preview/production nie tworzą izolowanych chatbotów ani kluczy.