Widget Insluiten
Voeg uw AI-chatbot binnen enkele seconden aan elke website toe met onze eenvoudige embed-code.
Snel aan de slag
Voeg deze code toe vóór de afsluitende </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 Embed-tabblad
- Kopieer de embed-code (bevat uw ID)
De chatbot-ID in de embed-code is niet hetzelfde als de naam in uw dashboard-URL. Kopieer altijd de ID van het Embed-tabblad.
Het widget aanpassen
Het uiterlijk en gedrag van het widget worden geconfigureerd in uw dashboard — niet in de embed-code. Ga naar Dashboard → Chatbots → [uw chatbot] → Widget om aan te passen:
- Positie — rechtsonder, linksonder of inline
- Kleuren — primaire, achtergrond- en tekstkleuren, plus border-radius
- Grootte — widgetbreedte en -hoogte
Om de chat automatisch te openen na een configureerbare vertraging, schakelt u Auto-Open in het Behavior-tabblad van dezelfde instellingenpagina in.
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 browserinstellingen van elke bezoeker, op basis van de talen die u inschakelt in het Languages-tabblad van uw chatbot.
Kies de Inline-positie om de chat direct in de pagina in te sluiten op de plek waar de script-tag is geplaatst. Het widget staat altijd open, zonder bubble of sluitknop — ideaal voor speciale chatpagina's of supportsecties.
FAQ-widget
Toon veelgestelde vragen 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 veelgestelde vragen van uw chatbot. Kleuren en styling (primaire, achtergrond- en tekstkleuren, border-radius) worden geconfigureerd in Dashboard → FAQs → Settings.
Opties voor de FAQ-widget
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Width | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Category Filter | 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 |
| Language | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
Voorbeeld Category Filter
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Wanneer het widget gefilterd is op één categorie, heeft de sorteervolgorde van die categorie (ingesteld in Dashboard → FAQs → Categories) voorrang op de globale sorteervolgorde.
Mobiele optimalisatie
Het chatwidget is volledig geoptimaliseerd voor mobiele apparaten:
- Volledige breedte lay-out op kleine schermen
- Slide-up animatie bij openen
- iOS-toetsenbordafhandeling (widget past zich aan het schermtoetsenbord aan)
- Safe-area-ondersteuning voor iPhone-notch en home-indicator
- Grotere touch-targets voor betere bruikbaarheid
- Invoertekstgrootte voorkomt iOS auto-zoom
Platform-specifieke gidsen
WordPress
Aanbevolen: Gebruik de officiële ChatReact WordPress Plugin voor de eenvoudigste integratie met Gutenberg-blokken, Elementor-widgets en shortcodes.
Alternatief: Handmatig insluiten via een "Header/Footer Scripts"-plugin:
- Installeer een "Header/Footer Scripts"-plugin
- Voeg de embed-code toe aan de footer-sectie
- Opslaan en publiceren
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 in de app-instellingen
- Het chatwidget verschijnt automatisch in uw storefront
- Beheer widgettoewijzingen per pagina, of schakel het overal in
De app ondersteunt ook Form- en FAQ-widgets als App Blocks in de Theme Editor.
Alternatief: Handmatig insluiten
- Ga naar Online Store → Themes → Edit Code
- Open
theme.liquid - Voeg code toe vóór
</body> - Opslaan
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
Interageer programmatisch met het widget:
// 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
Voorbeeldweergave
Voordat u live insluit:
- Gebruik de Preview-functie in uw dashboard
- Test verschillende scenario's
- Controleer of antwoorden accuraat zijn
Testen op een lokale ontwikkelomgeving? Gebruik de standaard embed-code onveranderd — deze werkt ook op localhost-pagina's.
Problemen oplossen
Widget verschijnt niet
- Controleer de browserconsole op fouten
- Verifieer of de chatbot-ID correct is
- Zorg dat de chatbot actief is (niet uitgeschakeld)
- Controleer of adblockers het widget blokkeren
- Controleer uw plangebruik — het widget pauzeert wanneer uw maandelijkse limiet van het plan is bereikt
Caching- & optimalisatie-plugins
Sommige caching- of script-optimalisatie-plugins herschrijven script-URL's, waardoor het widget mogelijk niet laadt. Als dat gebeurt, voeg dan een expliciete API-URL toe aan de 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>
Hetzelfde attribuut werkt ook voor de FAQ- en form-widget-scripts.
Stylingconflicten
Als de CSS van uw site conflicteert:
- Het widget scope't zijn stijlen naar zijn eigen container en gebruikt regels met hoge prioriteit om conflicten te weerstaan
- Controleer z-index-waarden van elementen die het widget overlappen
- Vermijd brede
!important-regels in uw site-CSS die generieke elementen targeten
Prestatie
Het widget is ontworpen voor minimale impact:
- Laadt asynchroon — blokkeert nooit uw paginarendering
- Lichtgewicht: ongeveer 30 KB gecomprimeerde overdracht
Volgende stappen
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — embed standalone forms with the form widget