HemDokumentation

Widget-Integrering

Lägg till din AI-chattbot på vilken webbplats som helst på några sekunder med vår enkla embed-kod.

Kom igång snabbt

Lägg in denna kod före den avslutande </body>-taggen:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

Det är allt! Din chattbot är nu live på din webbplats.

Hitta din Chatbot-ID

  1. Gå till din chattbots inställningar
  2. Navigera till fliken Bädda in
  3. Kopiera embed-koden (inkluderar ditt ID)

Chatbot‑ID:t i embed‑koden är inte samma som namnet i din dashboard‑URL. Kopiera alltid ID:t från fliken Bädda in.

Anpassa widgeten

Widgetens utseende och beteende konfigureras i din dashboard — inte i embed‑koden. Gå till Dashboard → Chatbots → [din chatbot] → Widget för att justera:

  • Position — nedre höger, nedre vänster eller inline
  • Colors — primär-, bakgrunds- och textfärger, samt hörnradie
  • Storlek — widgetens bredd och höjd

För att öppna chatten automatiskt efter en konfigurerbar fördröjning, aktivera Öppna automatiskt i fliken Beteende på samma inställningssida. På white‑label‑planer är ChatReact‑profileringen dold som standard — samma flik Beteende har en Show "Powered by ChatReact"‑växling om ni ändå vill visa den i widgetens sidfot.

Ändringar tillämpas automatiskt på er webbplats — ingen uppdatering av embed‑koden krävs. Se guiden Widget Customization för alla tillgängliga alternativ.

Widgetens språk upptäcks automatiskt från varje besökares webbläsare, baserat på de språk ni aktiverar i er chattbots flik Språk.

Välj positionen Inline för att bädda in chatten direkt på sidan där skript‑taggen placeras. Widgeten är alltid öppen, utan bubbla eller stängningsknapp — idealiskt för dedikerade chattsidor eller supportsidor.

FAQ‑widget

Visa vanliga frågor som ett accordion på vilken sida som helst:

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

FAQ‑widgeten visar publicerade FAQ från din chattbot. Färger och stil (primär, bakgrunds‑ och textfärger, hörnradie) konfigureras i Översikt → Vanliga frågor → Inställningar.

Alternativ för FAQ‑widget

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
BreddChoose between 100% (full width) or a custom pixel width (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderDisplay order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop)Dashboard → FAQs → Settings → Behavior
KategorifilterShow only specific categories in the widgetEmbed code data-categories attribute
Custom ContainerRender the widget inside your own element instead of the default chatreact-faq divEmbed code data-container attribute
SpråkOverride the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language)Embed code data-lang attribute
Accordion BehaviorAllow multiple FAQs open at once, or auto-expand the first FAQDashboard → FAQs → Settings → Behavior

Exempel på kategori‑filter

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

När widgeten filtreras till en enda kategori så åsidosätter den kategoriens egna sorteringsordning (inställd i Dashboard → FAQs → Categories) den globala sorteringsinställningen.

Mobiloptimering

Chattwidgeten är fullt optimerad för mobila enheter:

  • Fullbredds‑layout på små skärmar
  • Slide‑up‑animation vid öppning
  • iOS‑tangentbords­hantering (widgeten anpassar sig efter tangentbordet på skärmen)
  • Safe‑area‑stöd för iPhone‑notch och home‑indikator
  • Större touch‑mål för bättre användbarhet
  • Inmatningssrifttstorlek förhindrar iOS auto‑zoom

Plattformsspecifika guider

WordPress

Rekommenderat: Använd den officiella ChatReact WordPress Plugin för enklast integration med Gutenberg‑block, Elementor‑widgets och shortcodes.

Alternativ: Manuell embed via ett "Header/Footer Scripts"‑plugin:

  1. Installera valfritt "Header/Footer Scripts"‑plugin
  2. Lägg till embed‑koden i footer‑sektionen
  3. Spara och publicera

Shopify

Rekommenderat: ChatReact Shopify App

Installera ChatReact‑appen från Shopify App Store för enklast integration:

  1. Installera ChatReact‑appen i din Shopify‑admin
  2. Ange ditt Chatbot‑ID i appens inställningar
  3. Chattwidgeten visas automatiskt i er butik
  4. Hantera widget‑tilldelningar per sida, eller aktivera den överallt

Appen stöder även Form och FAQ‑widgets som App Blocks i Theme Editor.

Alternativ: Manuell embed

  1. Gå till Online Store → Themes → Edit Code
  2. Öppna theme.liquid
  3. Lägg till kod före </body>
  4. Spara

Webflow

  1. Gå till Project Settings → Custom Code
  2. Lägg till i Footer Code
  3. Publicera webbplatsen

Next.js / React

Använd Script‑komponenten:

import Script from 'next/script';

export default function Layout({ children }) {
  return (
    <>
      {children}
      <Script 
        src="https://www.chatreact.ai/embed/widget.js"
        data-chatbot-id="YOUR_CHATBOT_ID"
        strategy="lazyOnload"
      />
    </>
  );
}

Vue.js

Lägg till i din huvud‑App.vue eller layout:

<script setup>
import { onMounted } from 'vue';

onMounted(() => {
  const script = document.createElement('script');
  script.src = 'https://www.chatreact.ai/embed/widget.js';
  script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
  script.async = true;
  document.body.appendChild(script);
});
</script>

JavaScript‑API

Interagera med widgeten programmatiskt:

// Open the chat
ChatReact.open();

// Close the chat
ChatReact.close();

// Toggle open/closed
ChatReact.toggle();

// Start a fresh conversation
ChatReact.newChat();

// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();

Testning

Förhandsgranskningsläge

Innan ni bäddar in live:

  1. Använd funktionen Förhandsgranska i din dashboard
  2. Testa olika scenarier
  3. Verifiera att svaren är korrekta

Testar ni på en lokal utvecklingssajt? Använd standard‑embed‑koden oförändrad — den fungerar även på localhost‑sidor.

Felsökning

Widgeten visas inte

  1. Kontrollera webbläsarkonsolen för fel
  2. Verifiera att chatbot‑ID:t är korrekt
  3. Säkerställ att chattboten är aktiv (inte inaktiverad)
  4. Kontrollera om annonsblockerare stör
  5. Kontrollera er plananvändning — widgeten pausas när er plans månatliga gräns nås

Caching‑ & optimerings‑plugins

Vissa caching‑ eller skript‑optimeringsplugins skriver om skript‑URL:er, vilket kan stoppa widgeten från att laddas. Om det händer, lägg till en explicit API‑URL i skript‑taggen:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-api-url="https://www.chatreact.ai"
  async
></script>

Samma attribut fungerar på FAQ‑ och form‑widgetarnas skript.

Stilkonflikter

Om er websidas CSS krockar:

  • Widgeten scoper sina stilar till sin egen container och använder högprioriterade regler för att motstå konflikter
  • Kontrollera z‑index för element som överlappar widgeten
  • Undvik breda !important‑regler i er sites CSS som riktar sig mot generiska element

Prestanda

Widgeten är designad för minimal påverkan:

  • Laddas asynkront — blockerar aldrig er sidrendering
  • Lättviktig: ungefär 30 KB komprimerad överföring

Nästa steg