Web Messenger (Chat Widget)

Installera och anpassa din chattwidget på din webbplats.

S

Written by SWEO AI Team

Updated over 2 weeks ago


Installation

Gå till SettingsWidget Installation och kopiera embed-koden.

Klistra in före </body> på din webbplats:

<script
  src="https://din-domän.com/api/widget/chat-widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="https://din-domän.com"
  data-title="Chat with us"
  data-color="#6366f1"
  data-position="right"
></script>

Alla data-* attribut:

AttributStandardBeskrivningdata-api-key(obligatoriskt)Din API-nyckel från Settingsdata-api-urlwindow.location.originAPI-bas-URLdata-titleChat with usText i chatheaderndata-color#6366f1Primärfärg (hex)data-positionrightright eller left

Anpassa utseende

Under Settings → Widget Installation kan du konfigurera:

InställningStandardAlternativTitleChat with usFritext, t.ex. "Hej! Hur kan vi hjälpa?"Color#6366f1 (indigo)Valfri hex-färg via färgväljarePositionBottom RightBottom Left

Widgetens storlek:

  • Bubble — 56×56px cirkel, z-index: 99999, 20px från botten
  • Panel — 380px bred (max calc(100vw - 40px)), 88px från botten

Beteendeinställningar

Widgeten har dessa inbyggda beteenden:

  • Anonymt användar-ID — Genereras automatiskt som anon_xxxxx och sparas i localStorage under nyckeln __chat_widget_uid
  • Konversationshistorik — Sparas per användar-ID, kunden ser sin historik vid återbesök
  • Streaming — Svar visas token för token via SSE (POST /api/chat/stream)
  • Responsiv — Panelen anpassar sig automatiskt till mobilskärmar

Proaktiva meddelanden

Proaktiva meddelanden kan triggas via JavaScript API:t. Lägg till efter widget-scriptet:

<script>
  // Visa välkomstmeddelande efter 5 sekunder
  setTimeout(() => {
    window.__sweo_widget?.open();
  }, 5000);
</script>

Du kan även konfigurera automationsregler under AI & Automation → Automation som skickar proaktiva meddelanden baserat på beteende.

Funktioner

Widgeten stödjer:

  • Realtid-streaming — Token-för-token svar via SSE
  • Markdown — AI:ns svar renderas med formatering
  • Citations — Källhänvisningar visas från Knowledge Base
  • Eskalering — Kunden meddelas om ärendet eskaleras till agent
  • Flerspråkigt — AI svarar på kundens språk automatiskt

Felsökning

Vanliga problem med widgeten:

ProblemOrsakLösningWidgeten syns inteScript laddas inteKontrollera att data-api-url är korrekt och att CORS tillåts"Missing API key" i konsolendata-api-key saknasKopiera API-nyckel från SettingsAI svarar inteIngen Knowledge BaseLadda upp minst en källa i KnowledgeHTTP 401Felaktig API-nyckelRotera nyckeln via Settings (24h grace period)Widgeten döljer elementz-index-konfliktWidgeten har z-index: 99999 — justera andra elements z-index