ForsideDokumentation

Widget Embedding

Tilføj din AI-chatbot til ethvert website på få sekunder med vores simple embed-kode.

Kom godt i gang

Tilføj denne kode før den lukkende </body> tag:

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

Det er det! Din chatbot er nu live på dit website.

Find din chatbot-ID

  1. Gå til din chatbots indstillinger
  2. Naviger til Integrer fanen
  3. Kopiér embed-koden (inkluderer dit ID)

Chatbot-ID'et i embed-koden er ikke det samme som navnet i din dashboard-URL. Kopiér altid ID'et fra Integrer fanen.

Tilpasning af widget

Widget'ens udseende og adfærd konfigureres i dit dashboard — ikke i embed-koden. Gå til Dashboard → Chatbots → [din chatbot] → Widget for at justere:

  • Position — nederst til højre, nederst til venstre eller inline
  • Colors — primær-, baggrunds- og tekstfarver samt border-radius
  • Størrelse — widget-bredde og højde

For at åbne chatten automatisk efter en konfigurerbar forsinkelse skal De aktivere Åbn automatisk i Adfærd fanen på samme indstillingsside. På white-label planer er ChatReact-branding skjult som standard — den samme Adfærd fanen har en Show "Powered by ChatReact" toggle, hvis De alligevel ønsker at vise den i widget-footeren.

Ændringer anvendes automatisk på Deres website — der er ikke behov for at opdatere embed-koden. Se Widget Customization guiden for alle tilgængelige muligheder.

Widget-sproget detekteres automatisk ud fra hver besøgendes browsersprog, baseret på de sprog De aktiverer i Deres chatbot's Sprog fanen.

Vælg Inline positionen for at indlejre chatten direkte i siden på det sted, hvor script-taggen er placeret. Widget'en er altid åben, uden boble eller luk-knap — ideel til dedikerede chatsider eller supportsektioner.

FAQ-widget

Vis FAQs som et accordion på enhver side:

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

FAQ-widget'en viser publicerede FAQs fra din chatbot. Farver og styling (primær-, baggrunds- og tekstfarver, border-radius) konfigureres i Dashboard → FAQs → Indstillinger.

FAQ-widget indstillinger

SettingDescriptionWhere to Configure
Colors & StylingPrimær-, baggrunds- og tekstfarver, border-radiusDashboard → FAQs → Settings
BreddeVælg mellem 100% (fuld bredde) eller en brugerdefineret pixelbredde (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderVisningsrækkefølge: Dato (nyeste først), Navn (alfabetisk) eller Custom (manuel træk & slip)Dashboard → FAQs → Settings → Behavior
KategorifilterVis kun specifikke kategorier i widget'enEmbed code data-categories attribut
Custom ContainerRenderer widget'en inde i dit eget element i stedet for standard chatreact-faq div'enEmbed code data-container attribut
SprogTving widget-sproget (som standard bruges sidens <html lang> attribut, derefter besøgendes browsersprog)Embed code data-lang attribut
Accordion BehaviorTillad flere FAQs åbne samtidigt, eller auto-udvid den første FAQDashboard → FAQs → Settings → Behavior

Eksempel på kategorifilter

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

Når widget'en er filtreret til en enkelt kategori, vil den pågældende kategoris egen sorteringsrækkefølge (sat i Dashboard → FAQs → Categories) overskrive den globale sorteringsindstilling.

Mobiloptimering

Chat-widget'en er fuldt optimeret til mobile enheder:

  • Fuldbredde-layout på små skærme
  • Slide-up animation ved åbning
  • iOS tastaturhåndtering (widget'en justerer sig i forhold til on-screen tastatur)
  • Safe-area support for iPhone notch og home-indikator
  • Større touch-mål for bedre brugervenlighed
  • Input-tekststørrelse forhindrer iOS auto-zoom

Platform-specifikke guider

WordPress

Anbefalet: Brug den officielle ChatReact WordPress Plugin for den nemmeste integration med Gutenberg-blokke, Elementor-widgets og shortcodes.

Alternativ: Manuel embed via en "Header/Footer Scripts" plugin:

  1. Installer en hvilken som helst "Header/Footer Scripts" plugin
  2. Tilføj embed-koden til footer-sektionen
  3. Gem og publicer

Shopify

Anbefalet: ChatReact Shopify App

Installer ChatReact-appen fra Shopify App Store for den nemmeste integration:

  1. Installer ChatReact-appen i dit Shopify-admin
  2. Indtast dit Chatbot ID i appens indstillinger
  3. Chat-widget'en vises automatisk i din shopfront
  4. Administrer widget-tilknytninger per side, eller aktiver den overalt

Appen understøtter også Form- og FAQ-widgets som App Blocks i Theme Editor.

Alternativ: Manuel indlejring

  1. Gå til Online Store → Themes → Edit Code
  2. Åbn theme.liquid
  3. Tilføj kode før </body>
  4. Gem

Webflow

  1. Gå til Project Settings → Custom Code
  2. Tilføj i Footer Code
  3. Publicer site

Next.js / React

Brug 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

Tilføj til din hoved 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

Interagér med widget'en programmatisk:

// 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();

Test

Preview-tilstand

Før De embedder live:

  1. Brug Forhåndsvisning funktionen i dit dashboard
  2. Test forskellige scenarier
  3. Verificér at svarene er korrekte

Tester De på et lokalt udviklingssite? Brug standard embed-koden uændret — den virker også på localhost sider.

Fejlfinding

Widget vises ikke

  1. Tjek browserkonsollen for fejl
  2. Verificér at chatbot-ID'et er korrekt
  3. Sørg for at chatbotten er aktiv (ikke deaktiveret)
  4. Tjek om adblockers forstyrrer
  5. Tjek Deres plan-forbrug — widget'en pauses, når Deres plans månedlige grænse nås

Caching- & optimerings-plugins

Nogle caching- eller script-optimerings-plugins omskriver script-URL'er, hvilket kan forhindre widget'en i at loade. Hvis det sker, tilføj en eksplicit API-URL i script-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>

Samme attribut virker på FAQ- og form-widget-scriptet.

Styling-konflikter

Hvis Deres sites CSS konflikerer:

  • Widget'en scoper sine styles til sin egen container og bruger høj-prioritets regler for at modstå konflikter
  • Tjek z-index værdier på elementer, der overlapper widget'en
  • Undgå brede !important regler i Deres site-CSS, som målretter generiske elementer

Ydeevne

Widget'en er designet til minimal påvirkning:

  • Loader asynkront — blokerer aldrig Deres side-rendering
  • Letvægter: cirka 30 KB komprimeret transfer

Næste skridt