Bädda in hjälpwidgeten på er hemsida
Widgeten lägger en flytande Hjälp-knapp i hörnet av er webbplats. Klistra
in ett script-block före </body>:
<script async src="https://DIN-ARBETSYTA.supportifier.app/kb-widget.js"
data-kb-base="https://DIN-ARBETSYTA.supportifier.app"></script>
async är viktigt: skriptet ska laddas så snart sidan är interaktiv. Lägg det
inte i en window.onload-hanterare eller i ett taggverktyg som väntar på
sidans load-händelse. Hänger en enda annan resurs på sidan — en bild, en
tredjepartspixel — kommer load sent eller aldrig, och då syns ingen
hjälpknapp alls.
Byt ut adressen mot er arbetsytas — eller er egna domän om ni har satt upp en. Koden finns färdig att kopiera i API-dokumentationen under Inställningar → Integrationer & API → Dokumentation.
Vad besökaren får
Upp till tre flikar:
- Fråga AI — chattboten, med streamande svar och källänkar. Fliken finns bara när chattboten är på.
- Sök — livesökning i era publicerade artiklar.
- Kontakt — meddelandeformuläret, som blir ett ärende hos er.
Är livechatten på, ni inom öppettid och någon agent tillgänglig erbjuds även "Prata med en människa".
Sök och Kontakt finns med för att widgeten står ensam på er sajt — till skillnad från hjälpcentrets egen chattbubbla, som har sökrutan och kontaktlänken på sidan omkring sig. Har er sajt redan sök och en kontaktsida kan ni stänga av flikarna under Inställningar → AI & kundupplevelse → AI-chattbot → Widgetens panel. Återstår bara en vy visas ingen flikrad alls, och widgeten blir en ren chattbubbla.
Samma ställe rymmer rubriken i panelens topp. Tom står det "Hjälpcenter" på besökarens språk; fyll i er egen text om panelen ska heta något annat, t.ex. ert varumärke eller "Support". (Fältet Chattens rubrik är en annan sak — det står i hjälpcentrets egen chattbubbla, inte i widgeten.) Kör ni widgeten på två språk fyller ni i det andra språkets rubrik i översättningsrutan längre upp på samma sida.
Var på sidan ikonen hamnar
Som standard sitter hjälpknappen nere till höger, 20 px från kanterna. Ligger er egen chatt, kundvagnsknapp eller cookieruta i vägen flyttar ni den under Inställningar → AI & kundupplevelse → AI-chattbot → Placering på er sajt:
- Hörn — nere till vänster eller nere till höger.
- Från sidkanten och Från nederkanten — extra pixlar in från kanten (0–400), utöver widgetens egna 20 px.
Inställningen gäller hela sajten och kräver ingen ändring i embed-koden. Behöver en enskild sida något annat — ett kampanjfält som bara finns där — styr script-taggen på just den sidan över:
<script async src="https://DIN-ARBETSYTA.supportifier.app/kb-widget.js"
data-kb-base="https://DIN-ARBETSYTA.supportifier.app"
data-kb-position="bottom-left"
data-kb-offset-side="24"
data-kb-offset-bottom="72"></script>
Panelen och den proaktiva bubblan följer med till samma hörn. På mobil fyller panelen hela skärmen oavsett val.
Språk
Widgetens egna texter — hjälpknappen, flikarna, knapparna — följer sidans språk. Ni kan säga det rakt ut på script-taggen:
<script async src="https://DIN-ARBETSYTA.supportifier.app/kb-widget.js"
data-kb-base="https://DIN-ARBETSYTA.supportifier.app"
data-kb-lang="en"></script>
Utan attributet läses sidans <html lang>, och säger inte den heller något
används arbetsytans språkinställning. Era egna texter — chattens rubrik,
välkomsthälsningen, förslagsfrågorna och kontaktformulärets rubrik, introtext
och kategorier — skriver ni på det andra språket under Inställningar → AI & kundupplevelse →
AI-chattbot respektive AI-formulär, under rubriken Samma texter på ….
Ett fält ni lämnar tomt visar texten ni redan skrivit.
Den ändrar sig med era inställningar
Widgeten hämtar accentfärg, chattexter, förslagsfrågor, proaktiva regler och kontaktformulärets kategorier och extrafält från er konfiguration vid laddning. Embed-koden behöver aldrig ändras när ni byter färg eller lägger till en kategori.
Varför widgeten och inte bara en länk
En besökare som skickas iväg till en annan domän för att ställa en fråga försvinner ofta på vägen — särskilt den som ännu inte är kund. Widgeten låter frågan ställas där personen står.
Var den hör hemma
- Alla sidor om supporten är en stor del av upplevelsen.
- Kassa, prissida och kontosidor om ni vill vara sparsamma — det är där frågor uppstår som annars blir avhopp. Kombinera med proaktiv chatt på just de sidorna.
Tekniska detaljer
- Ingen API-nyckel behövs; den läser bara publikt innehåll.
- Den påverkar inte er sidas layout — den ritar i ett eget lager.
- Panelen har ett kryss uppe till höger på alla skärmstorlekar.
- På mobil (skärmar upp till 720 px breda, eller låga liggande pekskärmar) öppnas panelen i helskärm, och skrivfältet följer med ovanför tangentbordet. På större skärmar är den ett flytande kort i hörnet.
- Hjälpknappen gungar till en kort stund var sjunde sekund, så att den syns
på en sida besökaren redan läser. Har besökaren bett sitt system om mindre
rörelse (
prefers-reduced-motion) står den helt still. - Har er sajt något fast längst ned, till exempel en bokningsrad, lyfter
data-kb-offset-bottom="72"på script-taggen hjälpknappen ovanför den.data-kb-offset-sidegör motsvarande i sidled ochdata-kb-positionbyter hörn. CSS-variablerna--kb-widget-bottomoch--kb-widget-sidegör samma sak från er egen stylesheet — praktiskt när utrymmet varierar per brytpunkt. - Vill er egen kod öppna eller stänga panelen finns
window.kbWidget.open(),close(),toggle()ochisOpen(), samt händelsernakbwidget:openochkbwidget:closepådocument. - Är besökaren inloggad hos er kan ni skicka med en signerad identitetstoken
via
data-identity-token(ellerwindow.kbWidget.setIdentityToken()), så att chatten kan svara ur kundens egna uppgifter. Se Inställningar → Integrationer & API → Inloggat läge. - Ska den bara synas på vissa sidor: lägg script-taggen bara på dem.