Embed een AI Chatbot op je website

Website Embed

Dit is de universele manier om uw chatbot aan elke website toe te voegen. U plakt twee korte regels in de HTML van uw site: een <script>-tag die de widget laadt, en een <web-chat-agent>-element dat aangeeft welke chatbot moet worden getoond. Dat is alles, de zwevende chatbubbel verschijnt in de hoek van elke pagina waarop de code wordt uitgevoerd.

Gebruikt u WordPress, TYPO3, Shopify, Wix, Squarespace of Webflow, gebruik dan de speciale handleiding voor uw platform. Daarin ziet u precies waar u dezelfde code moet plakken.

Waar vindt u uw Chatbot-ID

U hoeft het ID nooit handmatig in te voeren. In het WebChatAgent-dashboard:

  1. Open uw chatbot.
  2. Ga naar Kanalen → Chatwidget en vouw Installatiedetails tonen uit.
  3. Klik op de knop Kopiëren bij het codeblok.

Het gekopieerde fragment bevat al uw Chatbot-ID, dus u hoeft het alleen maar te plakken. (Als u het ruwe ID ooit los nodig hebt: het is de lange reeks in uw dashboard-URL: /dashboard/<your-chatbot-id>.)

De te plakken code

Plak dit vlak voor de sluitende </body>-tag van uw site:

<script src="https://webchatagent.com/widget/web-chat-agent.js" async></script>
<web-chat-agent chatbot-id="YOUR_ID"></web-chat-agent>

Vervang YOUR_ID door uw Chatbot-ID (of, nog eenvoudiger, kopieer het kant-en-klare fragment uit het dashboard zodat het ID al is ingevuld). De widget laadt asynchroon, dus uw pagina wordt niet vertraagd, en verschijnt als een zwevende chatknop in de onderste hoek.

Optionele attributen

De widget haalt zijn kleuren, titel, welkomstbericht en gedrag uit uw dashboardinstellingen, waardoor u normaal gesproken alleen chatbot-id nodig hebt. Om een aantal zaken direct in de HTML te overschrijven, voegt u deze attributen toe aan het <web-chat-agent>-element:

  • chatbot-id, Uw Chatbot-ID. Verplicht.
  • theme, Visuele stijl: "default" of "modern". Standaard ingesteld op "default".
  • initially-open, Stel in op "true" om de chat automatisch te openen wanneer de pagina laadt. Standaard ingesteld op "false" (gesloten).
  • tracking-consent, Optioneel toestemmingssignaal voor permanente personalisatie: "unknown", "denied" of "granted". Indien weggelaten, staat dit standaard op "unknown" en blijven anonieme lokale triggers gewoon werken.
  • context-data, Sessiecontext van uw pagina voor de AI (bijvoorbeeld "Customer=Acme GmbH;OrderID=A-1023"), handig wanneer de widget binnen een CRM of ingelogde omgeving draait. Formaten, limieten en beveiligingsopmerkingen vindt u in de ontwikkelaarshandleiding.
<web-chat-agent
  chatbot-id="YOUR_ID"
  theme="modern"
  initially-open="false"
></web-chat-agent>

Al het overige, merkkleur, avatar, lettertypen, positie en gedrag, configureert u onder Kanalen → Chatwidget. U hoeft de code dus niet opnieuw aan te passen om de stijl van de widget te wijzigen. Het assistentprofiel configureert u onder Instellingen → Antwoordstijl en rol.

Cookietoestemming en proactieve triggers

De widget voegt geen tweede cookiebanner toe. Zonder toestemmingssignaal draait deze in de anonieme Privacy Mode: triggers voor tijd, scrollen, exit-intent, inactiviteit, URL, zichtbaarheid en rage-clicks worden lokaal in het geheugen geëvalueerd. Herkenning van terugkerende bezoekers, permanente tellers, proactieve analyses en door AI gegenereerde begroetingen wachten op een granted-signaal.

Zie Cookietoestemming en anonieme proactieve triggers voor de volledige gedragsmatrix, CMP-voorbeelden en opslagreferentie.

De chat in de pagina insluiten

Het bovenstaande fragment levert een zwevende knop op. Plaatst u de chat liever binnen uw paginalay-out, bijvoorbeeld een volledig chatpaneel op een speciale ondersteuningspagina, gebruik dan de inline-widget. Deze laadt een ander script en een ander element:

<script src="https://webchatagent.com/widget/chat-widget-inline.js" async></script>
<web-chat-agent-inline chatbot-id="YOUR_ID"></web-chat-agent-inline>

De inlinechat wordt weergegeven op de plek waar u het element plaatst, dus zet het in de container waarin u de chat wilt tonen. Zie de handleiding voor inlinechat voor details over de lay-out.

Werkt overal

Beide fragmenten bestaan uit gewone HTML en een custom element. Ze werken daarom op elk websiteplatform, waaronder WordPress, TYPO3, Shopify, Wix, Squarespace, Webflow en handgecodeerde HTML/JS-sites. Plak de code in de HTML van uw site en publiceer.

Probleemoplossing

  • Verschijnt de widget niet? Controleer of de code in de HTML van de pagina staat (vóór </body>) en of u de pagina hebt gepubliceerd of eventuele caching-plug-ins hebt gewist. Controleer de browserconsole op geblokkeerde scripts.
  • Alleen zichtbaar op één pagina? Plaats het fragment op een sitewijde locatie (voettekst / globale code) en niet op een afzonderlijke pagina.