Kom igång
De dokumenterade kvoterna för inkluderade sidor delas mellan en ägares projekt. Se priser för plankvoter och Konto och fakturering i instrumentpanelen för kontots aktuella användning och tillgängliga kvot.
Bygg en användbar chattbot innan du lägger den på webbplatsen. Grundflödet är skapa → lägg till innehåll → granska → testa → anpassa → integrera.
1. Skapa ett konto och ett projekt
Logga in på ChattyBox-instrumentpanelen, välj Ny chatbot och ge projektet ett namn samt ange eventuellt en Webbplatsens URL. När projektet har skapats öppnas Kunskap → Importera och uppdatera. Om du öppnar ett projekt utan att ange en flik öppnas Översikt som standard. Att skapa projektet startar inte en import.
Se priser för aktuella gränser för projekt, sidor och användning.
2. Konfigurera din innehållskälla
I Kunskap → Importera och uppdatera ansluter du den offentliga webbplatsen, granskar upptäckta sidor, justerar det rekommenderade eller ett anpassat urval och startar import eller uppdatering av de valda sidorna. Ändringar i källinställningarna sparas automatiskt: kontrollera sparstatusen och åtgärda valideringsfel eller försök spara igen om det misslyckades innan du fortsätter. Avancerade källinställningar har också en separat åtgärd Skrapa nu som använder det konfigurerade upptäcktsläget. Regler för inkludering/uteslutning och crawldjup finns via konfiguration som kod, inte i instrumentpanelens kontroller.
ChattyBox extraherar läsbart HTML-innehåll och köar ändrat innehåll för indexering. Upptäckt och autosparning startar inte själva importen. Tjänsten renderar inte JavaScript och tillämpar inte robots.txt; använd offentliga sidor som du har rätt att indexera och välj lanseringsomfattning med omsorg. Tiden beror på upptäckt, sidantal och indexeringsarbete.
Använd Lägg till och uppdatera innehåll när du behöver vägledning om webbplatskartor, manuella URL:er, genomsökning, flerspråkighet eller omskrapning.
3. Granska indexerat innehåll
Öppna Kunskap → Sidor och jämför de faktiska sidorna med dina förväntade källor. Öppna skrapjobbet för att granska antal och varningar om delvis innehåll, och kontrollera det separata embedding-jobbet innan du utvärderar svar. En slutförd skrapning garanterar inte att varje begärd sida eller varje avsnitt indexerades. Läs om status och partiell indexering.
4. Testa svarskvaliteten
Öppna Testa chatbot och ställ representativa frågor som riktiga besökare kommer att använda. Kontrollera att svaren:
- använder den indexerade dokumentationen i stället för obestyrkta antaganden;
- länkar till användbara källsidor;
- hanterar saknad information med den avsedda reservlösningen;
- fungerar för viktiga språk och termer.
Förbättra källinnehållet eller källurvalet och uppdatera igen när planens väntetid tillåter det. Free tillåter högst en uppdatering per vecka och betalda planer högst en per dag. Funktionen Testa chatbot använder ägarens meddelandekvot och sparar konversationer. Testinteraktioner kan visas i Samtal → Analys och, om de upptäcks som obesvarade, i Samtal → Obesvarade frågor; debitering och registrering av luckor beror på resultatet. Installera inte chattboten bara för att den första skrapningen blev klar.
5. Anpassa upplevelsen
Använd Anpassa → Beteende för att välja Hjälpsam assistent, Säljrepresentant, Teknisk support, Sarkastisk bot eller Anpassad persona och redigera instruktionerna. Ändringarna sparas automatiskt; kontrollera sparstatusen innan du fortsätter. Om du redigerar en förinställning ändras den till Anpassad persona. Instruktionerna kompletterar ChattyBox inbyggda regler för källförankring och formatering; hämtat innehåll läggs till automatiskt, så klistra inte in kunskapsbasen i prompten.
Persona-text ersätter inte den tvingande reservlösningen för saknad kontext/innehållsluckor. Den separata inställningen assistant.fallbackMessage finns via konfiguration som kod, inte i Persona-formuläret. Testa både frågor som stöds och reservbeteendet efter att ändringarna sparats.
Om du planerar att använda den hostade widgeten kan du öppna Anpassa → Utseende för att förhandsgranska titel, välkomstmeddelande, färger, ikon, position och språk. Ändringar sparas automatiskt; kontrollera sparstatusen. Fast-läge och script-åsidosättningar påverkar widgetens UI-språk, inte språket på sidorna som indexeras; se felsökning av språk. Free innehåller styling men kräver ChattyBox-varumärket; Starter och högre kan dölja det.
Gör dessa val efter att innehållet har testats, så att visuell konfiguration inte döljer problem med sökning eller dokumentation.
6. Välj en integration
| Mål | Nästa steg |
|---|---|
| Montera ChattyBox underhållna gränssnitt från applikationskod | JavaScript SDK |
| Bygga och underhålla ett eget gränssnitt | Headless JavaScript SDK |
| Låta en AI-kodningsassistent integrera npm-paketet | AI-assisterad integration |
| Hantera projektkonfiguration från Git och CI | Distribuera konfiguration med CLI |
| Använda det underhållna gränssnittet utan npm eller ett byggsteg | Skript för den hostade widgeten |
| Lägga till den underhållna widgeten i WordPress utan temaändringar | WordPress-tillägg |
| Lägga till den underhållna widgeten i Drupal 10 eller 11 med Composer | Drupal-modul |
Webbläsarintegrationer behöver en offentlig widget-API-nyckel. Kontrollera nyckelns origin-inställningar: en nyckel som förberetts för en webbplats kan redan vara begränsad till den origin:en, medan nycklar utan begränsningar fungerar från olika origins. Under Installera → Nycklar & domäner använder du Redigera origins för att hantera valfria begränsningar och lägga till de produktions-, förhandsgransknings-, staging- och localhost-origins du behöver. Begränsade origins matchas exakt efter schema, värdnamn och port (till exempel är https://example.com och http://localhost:3000 olika origins). Under Installation på webbplatsen väljer du nyckeln och kopierar det genererade kodfragmentet och API-URL:en.
Offentliga widgetnycklar är avsedda att visas i webbläsarkod. Konfigurationstoken för distribution och andra administrativa autentiseringsuppgifter är privata och får aldrig läggas till på en webbplats. Originbegränsningar är valfri förstärkning, inte autentisering.
För att hämta en befintlig offentlig nyckel anger du en HTTP(S)-webbadress under Installation på webbplatsen och väljer nyckeln i kodfragmentet. Väljaren visar nycklar som inte har gått ut och som är obegränsade eller tillåtna för adressens origin. För en begränsad nyckel anger du en tillåten origin; använd Hantera nycklar och tillåtna domäner för att granska begränsningarna. Om formuläret inte är tillgängligt slutför du först det förberedelsesteg som visas i instrumentpanelen. Om du vill rotera nyckeln skapar du en ny, uppdaterar och testar installationen och tar sedan bort den gamla. Borttagningen stoppar omedelbart installationer som fortfarande använder den. En nyckel hör till en chattbot; namnet ”staging” eller ”production” skapar inte en miljögräns.
7. Validera före lansering
Installera den valda integrationen på en förhandsgransknings- eller staging-webbplats först. Testa den driftsatta origin:en, navigering mellan rutter, källhänvisningar, reservbeteende, mobil layout och webbläsarkonsolen innan du publicerar brett.
Slutför lanseringschecklistan. Använd sedan Samtal → Historik på alla planer, eller Samtal → Analys och Obesvarade frågor på Pro och Business, för att förbättra dokumentationen utifrån verkliga frågor.
Instrumentpanelens vyer
Öppna ett projekt på /chatbot/<projectId>. Flikarna styrs av frågeparametern tab, inte av separata undersidor:
| Vy i arbetsytan | Värde för tab | Vad du gör där |
|---|---|---|
| Översikt | overview | Granska förberedelsestatus och senaste aktivitet |
| Kunskap → Importera och uppdatera | settings | Upptäck, välj, importera och uppdatera sidor; justera källinställningar |
| Kunskap → Sidor | content | Granska sidor och skrapjobb, ta bort innehåll och återskapa embeddings |
| Testa chatbot | test | Ställ frågor och gå tillbaka till sparade konversationer |
| Samtal → Historik | logs | Läs sparade konversationer och ta bort enskilda eller alla konversationer |
| Samtal → Analys | analytics | Granska registrerade interaktioner från de senaste 30 dagarna, högst 5 000 poster; Pro/Business |
| Samtal → Obesvarade frågor | gaps | Granska och hantera upptäckta obesvarade frågor; Pro/Business |
| Anpassa → Beteende | prompts | Välj eller redigera assistentinstruktioner |
| Anpassa → Utseende | appearance | Förhandsgranska och justera den hostade widgetens utseende och språk |
| Installera → Nycklar & domäner | keys | Skapa/ta bort offentliga widgetnycklar och ändra valfria originbegränsningar |
| Installera → Installation på webbplatsen | embed | Förbered en installation och kopiera en nyckels kodfragment |
| Chatbot-inställningar | manage | Hantera chatbotuppgifter, distributionstoken och konfigurationslås eller ta bort chatboten |
Alla chatbotar går tillbaka till /dashboard. Kontoöversikten finns på /dashboard/overview; Konto och fakturering finns på /settings/account med profil, plan, meddelandeanvändning, faktureringsportal och PAYG-kontroller. /settings och /settings/billing omdirigerar dit. /settings/keys har en projektväljare för att skapa/ta bort offentliga nycklar; valfria originändringar finns i projektets Nycklar & domäner.
Behörigheter och konfigurationslås
Åtkomst till projekt i instrumentpanelen är endast för ägaren (eller den användare som äger en äldre arbetsyta). En offentlig widgetnyckel ger inte åtkomst till projektinställningar eller sparad konversationshistorik; medlemskap i en organisation ger inte i sig dessa projektbehörigheter.
För Git/CI-hantering visar Chatbot-inställningar konfigurationstoken med utvecklings-, förhandsgransknings- och/eller produktionsomfattning, valfritt utgångsdatum och möjlighet att återkalla token. Till skillnad från offentliga widgetnycklar visas tokenvärdet i sin helhet endast när det skapas. Avsnittet visar också distributionshistorik.
Valet Aktivera konfigurationslås går inte att ångra. Det blockerar konfigurationsändringar i instrumentpanelen och manuella innehållsåtgärder, inklusive att spara Persona och köra Skrapa nu, även om kontrollerna fortfarande visas. Distribuera i stället konfiguration via CLI-flödet. Hantering av offentliga nycklar, konversationsrensning och den brandinginställning som planen tillåter är inte en del av de låsta konfigurationsfälten. Tokenomfattningar för miljöer skapar inte separata chattbotar eller webbläsarnyckelmiljöer.
Konfiguration som kod innehåller även widget.enabled. Om värdet är false inaktiveras offentlig chatt, inklusive headless-SDK:t, inte bara den flytande widgeten. Det finns ingen motsvarande på/av-inställning i det aktuella formuläret för utseende.
Planer och budgetar
| Plan | Chattbotar | Inkluderade sidor | Meddelanden per månad |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1 000 |
| Pro | 10 | 5 000 | 10 000 |
| Business | 25 | 25 000 | 50 000 |
Meddelanden och inkluderade lagrade sidor är ägarkvoter som delas av ägarens chattbotar, inklusive Testa chatbot. Månatligt arbete med siduppdateringar och väntetider mellan uppdateringar är separata gränser; läs om uppdateringsbudgetar innan en stor import eller ombyggnad. Se priser för dokumenterade gemensamma plankvoter och Konto och fakturering för aktuell användning och tillgänglig kvot.
PAYG för meddelanden, sidor och webbplatser är valfritt på Pro/Business och avstängt som standard. Under Konto och fakturering kan du ange månadsbudgetar för överanvändning per funktion eller uttryckligen välja Inget utgiftstak. En budget på noll håller funktionen hårt begränsad; utan utgiftstak tillåts obegränsade användningsavgifter. PAYG låser inte upp funktioner på Free/Starter och kringgår inte crawlarnas väntetider för uppdatering. Profilnamnet kan ändras där; e-postadressen hanteras i kontoinställningarna hos din inloggningsleverantör.