Visa all dokumentation

Stella AI Chatbot: Installationsguide och Användarmanual

Stella AI Chatbot för webbplatser och kundsupport

Guide för Stella AI Chatbot som täcker FAQ-automation, leadsinsamling, AI-konversationer, RAG, mänsklig hantering och Pro-analys för alla webbplatser.

Den här guiden täcker både Free- och Pro-versionerna på ett och samma ställe. Där en funktion endast finns i Pro är den markerad med (Pro).

1. Installation

1.1 Krav

  1. Node.js 18+ - Krävs för att köra chatbotens backend-server.
  2. npm - Krävs för att installera projektets beroenden.
  3. Modern webbläsare - Krävs för att öppna adminpanelen och testa widgetens beteende.
  4. PostgreSQL 13+ (valfritt i Pro) - Krävs endast om du väljer PostgreSQL-lagringsläge.
  5. pgvector (valfritt i Pro) - Krävs för PostgreSQL-baserad vektorlikhetssökning i RAG-läge.
  6. Ollama (valfritt i Pro) - Krävs endast om du vill generera lokala embeddings utan API-kostnad.

1.2 Ladda ner och förbered

  1. Packa upp paketet - Packa upp antingen stella-ai-chatbot-free eller stella-ai-chatbot-pro.
  2. Öppna mappen i terminalen - Kör alla installations-/startkommandon från den här katalogen.
  3. Installera beroenden - Laddar ner alla nödvändiga backend-bibliotek.
npm install

1.3 Konfigurera miljön

  1. Skapa .env - Kopiera .env.example till .env.
  2. Ange obligatoriska variabler:
    • NODE_ENV - Definierar körläge (development eller production).
    • APP_SECRET - Används för att signera/verifiera säkra tokens och sessioner.
    • ADMIN_USER - Användarnamn för admininloggning.
    • ADMIN_PASS - Lösenord för admininloggning.
    • INSTALL_TOKEN - Skyddar installationen mot obehörig åtkomst.
    • CORS_ORIGINS / ALLOWED_ORIGINS - Styr vilka origins som får anropa API:er.
    • DATA_ENCRYPTION_KEY - Används för kryptering av känslig data (om stöds i din version).
  3. Valfria variabler:
    • PORT - Serverport (plattformen kan skriva över dynamiskt).
    • TRUST_PROXY=true - Aktiverar korrekt IP-detektering bakom reverse proxy/CDN.

1.4 Starta applikationen

npm start
  • /install - Installationsguide för första gången.
  • /admin - Admininloggning och dashboard.

1.5 Installationssteg

  1. Öppna installationen - /install initierar chatbotsystemet.
  2. Ange installationstoken - Bekräftar behörig installation.
  3. Välj lagringsläge:
    • Free: JSON-lagring.
    • Pro: JSON eller PostgreSQL.
  4. Slutför installationen - Skapar nödvändiga standardvärden/inställningar.
  5. install.lock skapas - Förhindrar oavsiktlig ominstallation och finns i data-mappen.

1.6 Bädda in widget på valfri webbplats

  1. Öppna avsnittet Embed Code - Genererar script för frontend-integration.
  2. Kopiera scriptet - Innehåller widget-laddare och API-bas-URL.
  3. Klistra in före </body> - Säkerställer att widgeten laddas efter sidinnehållet.
  4. Uppdatera webbplatsen - Verifierar att chatboten visas och fungerar.

1.7 Checklista för produktion

  1. Aktivera HTTPS - Skyddar trafik och inloggningsuppgifter.
  2. Använd starka hemligheter - Förhindrar att token/session komprometteras.
  3. Begränsa domäner - Förhindrar missbruk av widget/API på obehöriga webbplatser.
  4. Skydda installationen - Blockerar offentliga återinstallationsattacker.
  5. Aktivera CSRF-/säkerhetskontroller - Skyddar admin-ändringar.
  6. Ange retention-policy - Håller loggar hanterbara och kompatibla.

2. Användarguide (Steg för steg)

2.1 Admininloggning

  1. Öppna /admin - Öppnar admins startsida.
  2. Logga in - Använder inloggningsuppgifter från .env.
  3. Navigera i menyn - Overview, Settings, FAQs, Logs.

2.2 Overview-sidan

  1. Användningsstatistik - Visar sammanfattning av chatbot-aktivitet.
  2. Matched vs unmatched - Visar trend för svarskvalitet.
  3. Topp matchade nyckelord - Identifierar vad användare frågar om och får svar på.
  4. Topp omatchade frågor - Visar luckor i FAQ/AI-innehåll som bör förbättras.

2.3 Settings-sidan

A. Core Identity

  1. Chatbot Name - Rubrik som visas i chatthuvudet.
  2. Avatar Upload - Varumärkesbild i widget-knapp och chatt.
  3. Avatar Shape - Styr om avataren visas rund eller fyrkantig.
  4. Show Live Preview - Slår av/på realtidsförhandsvisning i admin.

B. Messaging & Engagement

  1. Welcome Message - Meddelande som visas när användaren öppnar chatten.
  2. No Match Message - Reservsvar när inget matchande svar hittas.
  3. Fuzzy Match - Matchar liknande nyckelord/frågor även utan exakt träff.
  4. Fuzzy Threshold - Styr hur strikt fuzzy matchning ska vara.
  5. Lead Capture - Samlar in namn/e-post före eller under chatten.
  6. Lead Capture Prompt - Meddelande som visas när användardata efterfrågas.

C. Widget Appearance

  1. Widget Position - Placerar widget-knappen till vänster eller höger.
  2. Widget Size - Styr launcher-knappens storlek.
  3. Brand/Theme Colors - Matchar widgetens färger med webbplatsens varumärke.
  4. Avatar Size - Styr avatarstorlek i chattgränssnittet.
  5. Animation - Lägger till effekter som pulse/shake/float.
  6. Chatbox Width/Height - Styr dimensionerna på chattpanelen.

D. System & Performance

  1. Items Per Page - Antal poster per sida i admin-tabeller.
  2. Log Retention Days - Hur länge loggar sparas innan rensning.
  3. Auto Cleanup - Tar automatiskt bort gammal data enligt retention-regel.
  4. Enforce HTTPS - Blockerar osäkra icke-HTTPS-anrop (ej localhost).
  5. Enforce Admin CSRF - Kräver CSRF-token för admin-ändringar.

E. Categories

  1. Add Category - Skapar ny gruppering för FAQ/chattflöden.
  2. Recommended Categories - Upp till 3 kategorier visas först i widgeten.
  3. Delete Category - Tar bort oanvänd kategori (eller merge/omfördelning används).

F. Embed Code

  1. API Base URL - Definierar backend-URL som widgetscriptet använder.
  2. Allowed Widget Domains - Begränsar var widgeten får köras.
  3. Widget Domain Policy - restricted kräver lista över tillåtna domäner.
  4. Regenerate / Copy Code - Uppdaterar och kopierar embed-script.

2.4 Pro-funktioner i Settings (Pro)

A. Human Handoff (Pro)

  1. Enable Handoff - Aktiverar eskalering till mänsklig support.
  2. Escalate After Unmatched - Antal misslyckade matcher innan handoff.
  3. Handoff Message - Meddelande som visas när eskalering triggas.
  4. Support URL - Länk användaren klickar för mänsklig support.
  5. Business Hours - Valfritt tidsfönster för handoff-beteende.

B. AI Powered Responses (Pro)

  1. AI Provider - Väljer LLM-tjänst i backend.
  2. API Key - Autentiseringsnyckel för vald leverantör.
  3. Load Models - Hämtar tillgängliga modeller för leverantören/nyckeln.
  4. AI Model - Modell som används för svarsgenerering.
  5. Test Connection - Verifierar att nyckel/modell/leverantör fungerar.
  6. Max Tokens - Maximal längd på AI-svar.
  7. System Instructions - Definierar botens beteende, ton och regler.
  8. AI Disclaimer - Valfri informationsrad under AI-svar.

C. Vector Retrieval (RAG) (Pro)

  1. Enable RAG - Tillåter hämtning från indexerat webbplatsinnehåll.
  2. Use PostgreSQL pgvector - Aktiverar skalbar lagring/sökning av vektorer.
  3. Embedding Provider - Tjänst som omvandlar text till vektorer.
  4. Embedding API Key - Autentisering för embedding-leverantör.
  5. Fetch Models - Hämtar tillgängliga embedding-modeller.
  6. Embedding Model - Modell för indexering och fråge-embeddings.
  7. Test Embedding Connection - Verifierar att embedding-endpoint fungerar.
  8. Crawl Root URL / Sitemap - Definierar crawlens startpunkter.
  9. Max Pages / Max Depth - Styr crawl-omfattning och djup.
  10. Chunk Size / Overlap - Styr textsegmentering för bättre retrieval-kvalitet.
  11. Include / Exclude Patterns - Finjusterar vilka URL:er som crawlas.
  12. Resume Mode - Hoppar över redan indexerade URL:er vid omcrawl.
  13. Crawl Website Content - Startar indexeringsjobb.
  14. RAG Ranking Mode - Styr rankningsstrategi (Balanced / Exact Product First).

2.5 FAQs-sidan

  1. Add FAQ - Manuell Q&A med unikt nyckelord.
  2. Edit/Delete FAQ - Underhåll och korrigering av befintliga svar.
  3. Import File - Massimport av FAQ från TXT/CSV/CSB/DOCX.
  4. Delimiter Option - Tolkar anpassade filformat (:, ,, | osv).
  5. Duplicate Keyword Handling - Hoppa över eller suffixa dubbletter vid import.
  6. Category Handling - Skapa saknade kategorier eller använd fallback-kategori.
  7. Import Summary - Visar antal tillagda/avvisade/dubbletter.

2.6 Logs-sidan

  1. Session Filters - Sök på sessionsnyckel, namn eller e-post.
  2. Show Chat - Visar chatthistorik endast för vald session.
  3. Leads Table - Visar insamlade kontaktuppgifter.
  4. Pagination - Navigera i stora datamängder med kontroller uppe och nere.

2.7 Frontend-beteende

  1. Widget Open - Användaren öppnar widgeten och går in i chatten.
  2. Welcome/Categories - Introduktion och rekommendationer visas (om aktiverat).
  3. User Query Handling:
    • Free: FAQ + fuzzy match-flöde.
    • Pro: FAQ + AI + RAG + handoff-regler.
  4. Lead Collection - Namn/e-post-formulär visas när funktionen är aktiverad.
  5. Logging - Sessioner/meddelanden/leads sparas för analys.

2.8 Felsökning

  1. Widgeten syns inte - Kontrollera embed-kod, domänpolicy och webbläsarkonsol.
  2. Korta AI-svar - Prova annan modell/leverantör, höj max tokens, testa leverantörens metadata.
  3. RAG svarar inte - Bekräfta crawl, embedding-inställningar och rankingläge.
  4. Installation blockerad - Verifiera installationstoken och lock/maintenance-beteende.

2.9 Rekommenderad utrullning

  1. Börja med FAQ + kategorier - Bygg en stabil bas för svar.
  2. Aktivera fuzzy match - Öka tolerans för variation i frågor.
  3. Aktivera lead capture - Börja samla kvalificerade leads.
  4. (Pro) Aktivera AI - Hantera bredare naturligt språk.
  5. (Pro) Aktivera RAG - Förankra svar i eget webbplatsinnehåll.
  6. (Pro) Aktivera handoff - Eskalera komplexa ärenden till människor.
  7. Slutför säkerhet + driftsätt - Lås policy och gå live.