HomeDocumentatie

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

  1. Ga naar de instellingen van uw chatbot
  2. Navigeer naar het Insluiten tabblad
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimaire, achtergrond- en tekstkleuren, border-radiusDashboard → FAQs → Settings
BreedteKies tussen 100% (volledige breedte) of een aangepaste pixelbreedte (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderWeergavevolgorde: Datum (nieuwste eerst), Naam (alfabetisch), of Aangepast (handmatig slepen)Dashboard → FAQs → Settings → Behavior
CategoriefilterToon alleen specifieke categorieën in de widgetEmbed code data-categories attribuut
Custom ContainerRender de widget binnen uw eigen element in plaats van de standaard chatreact-faq divEmbed code data-container attribuut
TaalOverschrijf de widgettaal (standaard de <html lang> attribuut van uw pagina, daarna de browsertaal van de bezoeker)Embed code data-lang attribuut
Accordion BehaviorSta toe dat meerdere FAQ's tegelijk open zijn, of laat automatisch de eerste FAQ uitklappenDashboard → 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:

  1. Installeer een "Header/Footer Scripts"-plugin
  2. Voeg de embed-code toe aan de footer-sectie
  3. Sla op en publiceer

Shopify

Aanbevolen: ChatReact Shopify App

Installeer de ChatReact-app vanuit de Shopify App Store voor de eenvoudigste integratie:

  1. Installeer de ChatReact-app in uw Shopify-beheer
  2. Voer uw Chatbot ID in de app-instellingen in
  3. De chatwidget verschijnt automatisch in uw storefront
  4. 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

  1. Ga naar Online Store → Themes → Edit Code
  2. Open theme.liquid
  3. Voeg code toe vóór </body>
  4. Sla op

Webflow

  1. Ga naar Project Settings → Custom Code
  2. Voeg toe aan Footer Code
  3. 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:

  1. Gebruik de Voorbeeld functie in uw dashboard
  2. Test verschillende scenario's
  3. 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

  1. Controleer de browserconsole op fouten
  2. Verifieer dat de chatbot-ID correct is
  3. Zorg dat de chatbot actief is (niet uitgeschakeld)
  4. Controleer of adblockers interfereren
  5. 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 !important regels 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