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 Settings → Widget 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:
data-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 leftAnpassa 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 LeftWidgetens 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_xxxxxoch sparas ilocalStorageunder 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 attdata-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