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
- Gå til din chatbots indstillinger
- Naviger til Integrer fanen
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primær-, baggrunds- og tekstfarver, border-radius | Dashboard → FAQs → Settings |
| Bredde | Vælg mellem 100% (fuld bredde) eller en brugerdefineret pixelbredde (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Visningsrækkefølge: Dato (nyeste først), Navn (alfabetisk) eller Custom (manuel træk & slip) | Dashboard → FAQs → Settings → Behavior |
| Kategorifilter | Vis kun specifikke kategorier i widget'en | Embed code data-categories attribut |
| Custom Container | Renderer widget'en inde i dit eget element i stedet for standard chatreact-faq div'en | Embed code data-container attribut |
| Sprog | Tving widget-sproget (som standard bruges sidens <html lang> attribut, derefter besøgendes browsersprog) | Embed code data-lang attribut |
| Accordion Behavior | Tillad flere FAQs åbne samtidigt, eller auto-udvid den første FAQ | Dashboard → 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:
- Installer en hvilken som helst "Header/Footer Scripts" plugin
- Tilføj embed-koden til footer-sektionen
- Gem og publicer
Shopify
Anbefalet: ChatReact Shopify App
Installer ChatReact-appen fra Shopify App Store for den nemmeste integration:
- Installer ChatReact-appen i dit Shopify-admin
- Indtast dit Chatbot ID i appens indstillinger
- Chat-widget'en vises automatisk i din shopfront
- 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
- Gå til Online Store → Themes → Edit Code
- Åbn
theme.liquid - Tilføj kode før
</body> - Gem
Webflow
- Gå til Project Settings → Custom Code
- Tilføj i Footer Code
- 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:
- Brug Forhåndsvisning funktionen i dit dashboard
- Test forskellige scenarier
- 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
- Tjek browserkonsollen for fejl
- Verificér at chatbot-ID'et er korrekt
- Sørg for at chatbotten er aktiv (ikke deaktiveret)
- Tjek om adblockers forstyrrer
- 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
!importantregler 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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — indlejr standalone formularer med form-widget'en