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
- Gå till din chattbots inställningar
- Navigera till fliken Bädda in
- 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
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Bredd | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Kategorifilter | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Språk | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → 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‑tangentbordshantering (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:
- Installera valfritt "Header/Footer Scripts"‑plugin
- Lägg till embed‑koden i footer‑sektionen
- Spara och publicera
Shopify
Rekommenderat: ChatReact Shopify App
Installera ChatReact‑appen från Shopify App Store för enklast integration:
- Installera ChatReact‑appen i din Shopify‑admin
- Ange ditt Chatbot‑ID i appens inställningar
- Chattwidgeten visas automatiskt i er butik
- 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
- Gå till Online Store → Themes → Edit Code
- Öppna
theme.liquid - Lägg till kod före
</body> - Spara
Webflow
- Gå till Project Settings → Custom Code
- Lägg till i Footer Code
- 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:
- Använd funktionen Förhandsgranska i din dashboard
- Testa olika scenarier
- 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
- Kontrollera webbläsarkonsolen för fel
- Verifiera att chatbot‑ID:t är korrekt
- Säkerställ att chattboten är aktiv (inte inaktiverad)
- Kontrollera om annonsblockerare stör
- 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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — bädda in fristående formulär med form‑widgeten