Widget Insluiting
Voeg uw AI-chatbot binnen enkele seconden toe aan elke website met onze eenvoudige embed-code.
Snel aan de slag
Voeg deze code toe vóór de sluitende </body> tag:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Dat is alles! Uw chatbot staat nu live op uw website.
Uw Chatbot-ID vinden
- Ga naar de instellingen van uw chatbot
- Navigeer naar het Insluiten tabblad
- Kopieer de embed-code (inclusief uw ID)
De chatbot-ID in de embed-code is niet hetzelfde als de naam in uw dashboard-URL. Kopieer altijd de ID uit het Insluiten tabblad.
De widget aanpassen
Het uiterlijk en gedrag van de widget worden in uw dashboard geconfigureerd — niet in de embed-code. Ga naar Dashboard → Chatbots → [uw chatbot] → Widget om het aan te passen:
- Position — rechtsonder, linksonder of inline
- Colors — primaire, achtergrond- en tekstkleuren, plus border-radius
- Grootte — widget-breedte en -hoogte
Om de chat automatisch te openen na een configureerbare vertraging, schakelt u Automatisch openen in op het Gedrag tabblad van dezelfde instellingenpagina. Op white-label plannen wordt ChatReact-branding standaard verborgen — hetzelfde Gedrag tabblad heeft een Show "Powered by ChatReact" schakelaar als u deze toch in de widget-footer wilt weergeven.
Wijzigingen worden automatisch op uw website toegepast — u hoeft de embed-code niet bij te werken. Zie de Widget Customization gids voor alle beschikbare opties.
De widgettaal wordt automatisch gedetecteerd op basis van de taalinstellingen in de browser van elke bezoeker, op basis van de talen die u inschakelt in het Talen tabblad van uw chatbot.
Kies de Inline positie om de chat direct in de pagina in te sluiten op de plek waar het script-tag staat. De widget is altijd geopend, zonder bubbel of sluitknop — ideaal voor speciale chatpagina's of supportsecties.
FAQ Widget
Toon FAQ's als een accordion op elke pagina:
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
De FAQ-widget toont gepubliceerde FAQ's van uw chatbot. Kleuren en styling (primaire, achtergrond- en tekstkleuren, border-radius) worden geconfigureerd in Dashboard → FAQ's → Instellingen.
FAQ Widget-opties
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primaire, achtergrond- en tekstkleuren, border-radius | Dashboard → FAQs → Settings |
| Breedte | Kies tussen 100% (volledige breedte) of een aangepaste pixelbreedte (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Weergavevolgorde: Datum (nieuwste eerst), Naam (alfabetisch), of Aangepast (handmatig slepen) | Dashboard → FAQs → Settings → Behavior |
| Categoriefilter | Toon alleen specifieke categorieën in de widget | Embed code data-categories attribuut |
| Custom Container | Render de widget binnen uw eigen element in plaats van de standaard chatreact-faq div | Embed code data-container attribuut |
| Taal | Overschrijf de widgettaal (standaard de <html lang> attribuut van uw pagina, daarna de browsertaal van de bezoeker) | Embed code data-lang attribuut |
| Accordion Behavior | Sta toe dat meerdere FAQ's tegelijk open zijn, of laat automatisch de eerste FAQ uitklappen | Dashboard → FAQs → Settings → Behavior |
Voorbeeld categorie-filter
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Wanneer de widget gefilterd is op één categorie, overschrijft de sortering van die categorie (ingesteld in Dashboard → FAQs → Categories) de globale sorteerinstelling.
Mobiele optimalisatie
De chatwidget is volledig geoptimaliseerd voor mobiele apparaten:
- Full-width lay-out op kleine schermen
- Slide-up animatie bij openen
- iOS-toetsenbordafhandeling (widget past zich aan het on-screen toetsenbord aan)
- Safe-area ondersteuning voor iPhone-notch en home-indicator
- Grotere touch-targets voor betere bruikbaarheid
- Invoertekstgrootte voorkomt iOS-auto-zoom
Platform-specifieke handleidingen
WordPress
Aanbevolen: Gebruik de officiële ChatReact WordPress Plugin voor de eenvoudigste integratie met Gutenberg-blokken, Elementor-widgets en shortcodes.
Alternatief: Handmatige insluiting via een "Header/Footer Scripts"-plugin:
- Installeer een "Header/Footer Scripts"-plugin
- Voeg de embed-code toe aan de footer-sectie
- Sla op en publiceer
Shopify
Aanbevolen: ChatReact Shopify App
Installeer de ChatReact-app vanuit de Shopify App Store voor de eenvoudigste integratie:
- Installeer de ChatReact-app in uw Shopify-beheer
- Voer uw Chatbot ID in de app-instellingen in
- De chatwidget verschijnt automatisch in uw storefront
- Beheer widget-toewijzingen per pagina, of schakel deze overal in
De app ondersteunt ook Form- en FAQ-widgets als App Blocks in de Theme Editor.
Alternatief: Handmatige insluiting
- Ga naar Online Store → Themes → Edit Code
- Open
theme.liquid - Voeg code toe vóór
</body> - Sla op
Webflow
- Ga naar Project Settings → Custom Code
- Voeg toe aan Footer Code
- Publiceer site
Next.js / React
Gebruik de Script-component:
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
Voeg toe aan uw hoofd-App.vue of 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
Interactie met de widget via code:
// 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();
Testen
Preview-modus
Voordat u live insluit:
- Gebruik de Voorbeeld functie in uw dashboard
- Test verschillende scenario's
- Controleer of antwoorden accuraat zijn
Testen op een lokale ontwikkelomgeving? Gebruik de standaard embed-code ongewijzigd — deze werkt ook op localhost pagina's.
Problemen oplossen
Widget verschijnt niet
- Controleer de browserconsole op fouten
- Verifieer dat de chatbot-ID correct is
- Zorg dat de chatbot actief is (niet uitgeschakeld)
- Controleer of adblockers interfereren
- Controleer uw plangebruik — de widget pauzeert wanneer het maandelijkse limiet van uw plan is bereikt
Caching- & optimalisatie-plugins
Sommige caching- of script-optimalisatie-plugins herschrijven script-URL's, wat kan voorkomen dat de widget laadt. Als dat gebeurt, voeg dan een expliciete API-URL toe aan het script-tag:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Diezelfde attribuut werkt op de FAQ- en formulier-widget-scripts.
Stijlconflicten
Als de CSS van uw site conflicteert:
- De widget beperkt zijn stijlen tot zijn eigen container en gebruikt regels met hoge prioriteit om conflicten te weerstaan
- Controleer z-index waarden van elementen die de widget overlappen
- Vermijd brede
!importantregels in uw site-CSS die generieke elementen targeten
Prestaties
De widget is ontworpen voor minimale impact:
- Laadt asynchroon — blokkeert nooit uw paginarender
- Lichtgewicht: ongeveer 30 KB gecomprimeerde overdracht
Volgende stappen
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — plaats standalone formulieren met de form-widget