Ga naar inhoud

Plaats Quickchat AI op je website als zwevende Widget, inline Insluiten of gehoste Chatpagina. Lees over installatie, toegang, uiterlijk, teksten en aangepaste parameters.

Je kunt je Quickchat AI-agent op drie manieren op het web aanbieden. Kies wat bij de gewenste weergave past:

  • Widget: de zwevende chatknop in de hoek van je site. Geschikt voor algemene ondersteuning.
  • Insluiten: een chatvenster dat precies op de gewenste plek in een pagina staat. Geschikt voor een specifiek appscherm, een helpcentrumpagina of een productdetailpagina.
  • Chatpagina: een gehoste chat op volledig scherm via Quickchat, zonder installatie of code. Handig om een link te delen via bijvoorbeeld een supportmail, interne Slack of met bètatesters, zonder iets in hun browser te veranderen.

Installeer je gekozen weergave via Kanalen → Je website → Installeren. De pagina heeft drie subtabs: Installeren voor de installatiemethode, Uiterlijk voor de vormgeving en Tekstinhoud voor de teksten en labels die bezoekers zien. De tab Installeren begint met een methodekeuze, heeft een aparte sectie voor beschikbaarheid en toegang, en toont een kopieerbare Scenario ID voor plugins en de API.

Optionele hulpmiddelen voor de installatie

Section titled “Optionele hulpmiddelen voor de installatie”
  • Vergelijk publicatiemethoden. Vergelijk je opgegeven kanalen, toegang tot je website en benodigde functies met de installatieopties van Quickchat AI. Dit inspecteert je website of account niet.

  • Vergelijk HTML en Markdown van een voorbeeldpagina. Haal de oorspronkelijke HTML, Markdown-inhoud en toollinks van een vast Quickchat AI-voorbeeld op. Dit voert geen JavaScript uit en inspecteert geen willekeurige websites.

Met de Widget plaats je je Quickchat AI-agent rechtstreeks op je website, zodat bezoekers eenvoudig met de AI kunnen praten. De Widget verschijnt meestal als chatknop rechtsonder. Na een klik opent een chatvenster waarin bezoekers vragen kunnen stellen, hulp kunnen krijgen en informatie kunnen opzoeken.

Open Kanalen → Je website → Installeren. De tab begint met ‘Hoe wil je je AI-agent toevoegen?’ en toont de installatiemethoden, met de eenvoudigste eerst. Kies wat bij je site past:

  • WordPress: installeer onze gratis Quickchat AI Agent-plugin en plak je Scenario ID. De Widget verschijnt automatisch; je hoeft geen themacode aan te passen.
  • Shopify: voeg de Widget toe via de Theme Editor van je winkel. Zie de Shopify-handleiding.
  • Webflow, Wix en andere: kopieer één codefragment en plak het in de instelling voor aangepaste code die voor de hele site geldt, op alle pagina’s. Gebruik geen Insluiten- of HTML-element op één pagina. Zie Websitebouwers.
  • Deel in plaats daarvan een link: installeer niets en deel de link naar je gehoste Chatpagina.
  • Handmatig installeren met code: kopieer de onbewerkte Widget- of Insluiten-code en plak deze zelf in je HTML.

Elke methode opent een gericht stappenpaneel met alleen de benodigde code of ID.

Je Scenario ID staat bovenaan de tab Installeren als kopieerbaar veld. Plugins en de API gebruiken deze identifier. Kopieer hem hier als een installatiestap erom vraagt.

Beheer je zelf de HTML, open dan Handmatig installeren met code op de tab Installeren en volg deze stappen:

  1. Kopieer het Widget-fragment.
  2. Open het HTML-bestand van je pagina. Gebruik bij een websitebouwer de instelling voor code op de hele site; zie Websitebouwers.
  3. Plak het fragment vlak vóór de afsluitende </body>-tag op elke pagina waar de Widget moet verschijnen.

Controleer een Widget-fragment tegen de Scenario ID die je opgeeft. De controle leest de geplakte code en haalt je website niet op.

Voeg bij Webflow, Wix, Squarespace, Hostinger en vergelijkbare bouwers de Widget één keer toe via de instelling voor code op de hele site:

  1. Open de instelling die code aan elke pagina toevoegt. Deze heet bijvoorbeeld Custom code, Code injection, Footer code of Body end.
  2. Plak daar het Widget-fragment en pas het toe op alle pagina’s. Kun je de positie kiezen, kies dan de footer of het einde van de body. Het fragment werkt niet in de head.
  3. Publiceer je site. De chatknop verschijnt op elke pagina.

Voeg de Widget niet toe via een Embed- of HTML-element op één pagina. Veel bouwers tonen die elementen in een klein, apart frame waarin de Widget niet kan openen. Zelfs als hij wel laadt, zou hij alleen op die ene pagina verschijnen.

Waar je de instelling voor de hele site vindt:

WebsitebouwerInstelling voor code op de hele site
WebflowSite settings → Custom code → Footer code
WixSettings → Custom Code, daarna All pages en Body - end. Vereist een gekoppeld domein.
SquarespaceCustom Code → Code Injection → Footer. Beschikbaar bij Core, Plus, Advanced en sommige oudere abonnementen.
Hostinger Website BuilderMore (⋯) → Integrations → Custom code. Scripts worden automatisch aan het einde van de pagina geladen.

Menu’s kunnen veranderen en vertaald zijn naar de taal van je websitebouwer. Heeft jouw bouwer of abonnement geen instelling voor code op de hele site, deel dan je Chatpagina-link.

Geen ontwikkelaar? Onder Hulp nodig? op de tab Installeren staan twee snelkoppelingen:

  • Vraag AI om hulp: opent de assistent in de app met een vooraf ingevulde vraag over het toevoegen van de agent aan je website.
  • Mail instructies naar een ontwikkelaar: stuurt een collega alles wat nodig is, waaronder het Widget-fragment, je Scenario ID en een link naar deze handleiding, zodat die de installatie kan uitvoeren.

Neem voor meer hulp contact op via contact@quickchat.ai.

De Chatpagina is een gehoste versie van je AI-agent op volledig scherm via een Quickchat-URL. Er hoeft niets te worden geïnstalleerd. Deel de link en bezoekers kunnen direct in hun browser met je agent praten. Gebruik dit wanneer:

  • Je een chat wilt, maar geen website hebt of de code niet wilt aanpassen.
  • Je de AI intern deelt met een kleine groep, zoals bètatesters, je supportteam of potentiële klanten, en een link met toegangscontrole nodig hebt in plaats van een openbare Widget.
  • Je de AI als vervolgmogelijkheid wilt delen via e-mail, Slack of je CRM.

Stel onder Installeren → Toegang tot chatpagina in wie de Chatpagina mag openen. Zie Toegangscontrole.

Zo begin je opnieuw met een lege chat:

  • Widget of Insluiten: Open de chat en klik op de knop met een pen in een vierkant rechtsboven in het chatvenster.
  • Chatpagina: Kies New chat in de zijbalk of gebruik de knop met een pen in een vierkant in de header.

Dit start een nieuw gesprek met je AI-agent. Het vorige gesprek blijft in de Inbox. De Widget sluiten en opnieuw openen of de pagina vernieuwen kan het bestaande gesprek hervatten. De AI vragen om te ‘resetten’ of ‘de chat te wissen’ start geen nieuw gesprek. Je hoeft geen browsercookies te verwijderen.

Op de tab Installeren staan de toegangsinstellingen in de uitklapbare sectie Beschikbaarheid en toegang. Hier vind je twee instellingen voor je publicatie:

De schakelaar bovenaan Beschikbaarheid en toegang. Als deze aanstaat, werken de Widget- en Insluiten-scripts normaal in de browser van bezoekers. Als deze uitstaat, zijn Widget en Insluiten op je site niet beschikbaar, ook als de code nog aanwezig is. Handig om de AI tijdelijk offline te halen zonder het fragment te verwijderen, of om publieke toegang te beperken terwijl de Chatpagina openblijft voor uitgenodigde gebruikers.

Los van de Widget- en Insluiten-schakelaar stel je in wie de Chatpagina kan openen:

  • Iedereen: de Chatpagina-URL is openbaar. Iedereen met de link kan hem gebruiken.
  • Alleen uitgenodigde gebruikers: Om de Chatpagina te gebruiken, moeten mensen zich aanmelden en een rol bij deze AI-agent hebben. Kies Chatgebruiker voor mensen die alleen hoeven te chatten.
  • Niemand: de Chatpagina is volledig uitgeschakeld.

De link Chatgebruikers uitnodigen opent Instellingen → Organisatie → Teamleden. Selecteer Chatgebruiker in het uitnodigingsformulier om toegang tot de Chatpagina te geven zonder toegang tot het dashboard. Voor uitnodigingen is een vrije gebruikersplaats nodig. Het oude Basic-abonnement staat geen rolkeuze toe. Zie Teamleden en rollen voor de abonnementslimieten.

Met Uiterlijk en Tekstinhoud pas je het uiterlijk en de bezoekersteksten van Widget, Insluiten en Chatpagina aan. Alle drie delen deze instellingen. Een wijziging geldt dus overal waar je agent is gepubliceerd.

Het rechterpaneel van Installeren, Uiterlijk en Tekstinhoud heeft eigen voorbeeldinstellingen. Wissel tussen Widget, Insluiten en Chatpagina, en tussen Desktop en Mobiel, om wijzigingen te bekijken voordat je publiceert.

De visuele instellingen zijn gegroepeerd onder Branding, Size & Position, Thema en Overige instellingen.

  • Avatar van AI-agent: de profielfoto of het logo van de agent. Eén afbeelding van maximaal 5 MB wordt zowel in de chatheader als op de startknop gebruikt. Dit is één instelling, niet twee: één upload verschijnt op beide plekken en vervangt het vroegere afzonderlijke headerlogo en starticoon. Elke agent begint met een ingebouwde standaardavatar. Standaard herstellen herstelt deze; verwijderen zorgt dat er helemaal geen avatar verschijnt. Beschikbaar op elk abonnement, inclusief Free.

Avatar van AI-agent geldt voor Widget, Insluiten en Chatpagina, maar niet voor Discord. Daar komt de botavatar uit de Discord-app. Zie Discord.

  • Grootte startknop: Klassiek, Alleen invoerveld of Klein. Bepaalt hoe de startknop eruitziet voordat de chat wordt geopend.
  • De startknop sluiten: de Klassiek-variant heeft rechtsboven een kleine sluitknop. Op desktop verschijnt deze bij aanwijzen; op aanraakschermen is hij altijd zichtbaar. De Widget wordt alleen voor de huidige paginaweergave verborgen en verschijnt weer bij de volgende paginalaadactie. De andere formaten hebben geen sluitknop.
  • Label startknop: alleen zichtbaar bij Klein. Aangepaste tekst van maximaal 25 tekens op de kleine startknop, bijvoorbeeld ‘Vraag AI’ of ‘Chat’. Laat het veld leeg voor alleen een icoon.
  • Widgetpositie: linksonder, middenonder of rechtsonder.
  • Chat window dimensions: breedte van 300–700px en hoogte van 400–1200px.
  • Versleepbare chatknop: laat bezoekers de startknop verslepen. Handig als hij belangrijke inhoud bedekt.

Kies de kleuren van de chat:

  • Licht en Donker zijn vaste stijlen die voor elk account hetzelfde zijn.
  • Aangepast geeft toegang tot een eigen kleurenpalet. Je kunt kleuren kiezen voor de achtergrond, header en headertekst, accentkleur voor onder meer de startknop vóór de chat, suggesties en beoordelingen, berichtballonnen en hun tekst, AI-berichttekst, link color, invoerveld, randen en meer. Elke kleur wordt op WCAG AA-contrast met de achtergrond gecontroleerd. Je krijgt een waarschuwing als een combinatie moeilijk leesbaar is.

Merkkleuren voor header en accenten horen bij Aangepast. Licht en Donker blijven neutrale stijlen; omschakelen neemt geen aangepaste kleuren mee.

Onder Transparantie bepaalt Achtergrond hoe doorschijnend het chatvenster is. Dit werkt in elke themamodus; het thema bepaalt de tint:

  • Effen: een ondoorzichtige achtergrond. Dit is de standaard.
  • Glas: het venster wordt doorschijnend en de website erachter vervaagt als achter matglas. De tint is wit bij Licht, donker bij Donker en je gekozen achtergrondkleur bij Aangepast. Een afwijkende headerkleur blijft bij Aangepast behouden, zodat je huisstijl zichtbaar blijft. Dekking van glas bepaalt hoe sterk de tint de pagina bedekt: vanaf het minimum waarbij tekst op elke website leesbaar blijft, 50% bij Licht, 65% bij Donker en afhankelijk van de kleuren bij Aangepast, tot 95%. Werkt geen enkele doorzichtigheid met je Aangepast-kleuren, dan gebruikt de Widget een ondoorzichtige achtergrond en leggen de instellingen uit waarom. Glas blijft geselecteerd en wordt weer toegepast zodra je tekst- of achtergrondkleuren genoeg contrast bieden.

Transparantie geldt voor de Widget, ook op telefoons, en voor Insluiten. De volledige Chatpagina heeft altijd een ondoorzichtige achtergrond. Bezoekers die op hun apparaat ‘Transparantie verminderen’ hebben ingeschakeld, zien Effen in Chrome en Edge, de browsers die deze instelling doorgeven. Kan een browser de achtergrond niet vervagen, dan blijft Glas vrijwel ondoorzichtig om tekst leesbaar te houden.

Bij Aangepast krijgt de Chatpagina ook eigen zijbalkkleuren: Achtergrond zijbalk, Tekst zijbalk, Zijbalk bij aanwijzen en Zijbalktekst bij aanwijzen. Ze gelden alleen voor de Chatpagina op volledig scherm, niet voor Widget of Insluiten. Laat tekstkleuren leeg om automatisch een leesbare kleur bij de gekozen achtergrond te gebruiken.

Je kunt ook de corner radius, de afronding van tekstballonnen, invoervelden en knoppen, en de text size instellen. Beide werken in elke themamodus.

  • Spraakinvoer: laat bezoekers een gesproken bericht opnemen met de microfoon in de chat. De opname wordt naar tekst in het invoerveld omgezet, zodat ze die vóór verzending kunnen aanpassen. Opnames stoppen automatisch na twee minuten. Beschikbaar op betaalde abonnementen.
  • Bestandsbijlagen: laat bezoekers een afbeelding of document toevoegen. Staat standaard aan; zet dit uit om de bijlageknop te verwijderen.
  • Widget automatisch openen: opent de Widget automatisch zodra de pagina laadt.
  • Quickchat AI-branding verbergen: verbergt de voettekst ‘Powered by Quickchat AI’ voor een volledig eigen merkervaring. Beschikbaar op abonnementen met white-labeling.

Wil je bezoekers gesprekken laten beoordelen, open dan Gesprekken → Inzichten → Gespreksbeoordeling. Daar staan zowel instellingen als resultaten. Zie Conversation Rating.

Open Kanalen → Je website → Tekstinhoud om de begroeting en andere bezoekersteksten te bewerken:

  • Koptekst: tekst bovenaan het chatvenster.
  • Welkomstbericht: het eerste bericht van de agent aan het begin van elk gesprek, bijvoorbeeld ‘Hoi, kan ik je helpen?’.
  • Als pop-up tonen: toont het welkomstbericht als zwevende tekstballon naast de startknop om aandacht te trekken voordat een bezoeker klikt. Dit wordt soms een teaser of launcher message genoemd. De ballon gebruikt de tekst van Welkomstbericht zelf; wijzig dat veld om de inhoud aan te passen.
  • Gespreksstarters: maximaal 3 voorbeeldberichten die verschijnen voordat de bezoeker typt. Een klik verstuurt het gekozen bericht als eerste bericht. Hiermee stuur je bezoekers naar onderwerpen waar je AI sterk in is, zoals ‘Hoe installeer ik de Widget?’ of ‘Welke integraties ondersteunen jullie?’.
  • Placeholdertekst: hulptekst in het lege invoerveld.
  • Disclaimertekst: tekst achter het gesprek, meestal om duidelijk te maken dat iemand met AI praat. Houd deze tekst duidelijk en zichtbaar.

De sectie Startscherm van de chat staat onder deze velden op dezelfde tab Tekstinhoud. Schakel deze daar in en bewerk de header, knop en berichttekst.

De standaardwebsitewidget toont op dit scherm een kop, een bericht en een startknop. Er zijn geen invoervelden voor e-mail of telefoon en je kunt deze gegevens niet verplicht stellen vóór de chat. Slimme gegevensverzameling kan er tijdens het gesprek naar vragen. Om contactgegevens te verplichten voordat iemand mag chatten, heb je een apart websiteformulier of een aangepaste integratie nodig.

Standaard ziet elke bezoeker Tekstinhoud precies zoals jij die hebt ingevoerd. Op betaalde abonnementen kun je vertalingen per taal toevoegen, zodat bezoekers de Widget in hun eigen taal zien.

  1. Open Tekstinhoud en klik bij Andere talen op Vertalen. Het paneel Widgettekst vertalen opent en toont je oorspronkelijke tekst bij elke vertaling als Standaard (bron).
  2. Klik op Taal toevoegen en kies een taal. Quickchat AI genereert een vertaling van je huidige tekst. Controleer en bewerk de header, begroeting, gespreksstarters, invoerhint, het pre-chatscherm en de disclaimer. Wijzigingen worden automatisch opgeslagen.
  3. Lege velden gebruiken je standaardtekst, zodat je alleen hoeft te vertalen wat je wilt wijzigen. Mislukt automatisch vertalen, dan kun je de tekst zelf invoeren.

Het aantal talen dat je kunt toevoegen hangt af van je abonnement.

Hoe de taal van een bezoeker wordt gekozen

Section titled “Hoe de taal van een bezoeker wordt gekozen”

Voor Widget en Insluiten kiest Quickchat de taal in deze volgorde:

  1. Een expliciete keuze in de loader: _quickchat("language", "de"), aangeroepen vóór _quickchat("init", ...).
  2. Het <html lang>-attribuut van je pagina: bijvoorbeeld <html lang="de"> voor de Duitse vertaling. Dit is de aanbevolen methode: stel lang correct in op elke vertaalde pagina en de Widget volgt automatisch.
  3. De browsertaal van de bezoeker, gevolgd door je Standaard-tekst als er geen overeenkomst is.

Als er geen vertaling voor de taal van een bezoeker is, ziet die altijd je Standaard-tekst. Er blijven geen velden leeg.

Geavanceerde functies: aangepaste parameters

Section titled “Geavanceerde functies: aangepaste parameters”

Met Quickchat AI Widget en Insluiten kun je bij initialisatie aangepaste parameters meegeven. Je kunt ze gebruiken om:

  • analyses uit te breiden; ze zijn beschikbaar in de CSV-export van het Quickchat-platform;
  • waarden aan API Actions door te geven en, waar toegestaan, antwoorden te personaliseren. De AI ontvangt een gefilterde selectie, niet alle parameters. Zie Modelcontext en autorisatie.

Voorbeelden van nuttige parameters:

  • visitor_name: Mike
  • customer_tier: VIP
  • order_id: ord_123

visitor_name is een herkende contactsleutel. Eigen sleutels zoals customer_tier kunnen worden opgeslagen en in Actions worden gebruikt. Alleen meesturen garandeert niet dat de AI ze in zijn antwoord gebruikt. Behandel waarden uit de browser als niet-geverifieerde invoer, niet als toestemming om een klantaccount te openen.

Voeg voor zulke parameters het volgende toe aan het script uit Je website > Installeren.

Widget en Insluiten gebruiken dezelfde aanroep:

_quickchat("custom_params", {
"visitor_name": "Mike",
"customer_tier": "VIP",
"order_id": "ord_123",
});

Deze waarden worden aan elk nieuw gesprek gekoppeld. Beperk het bij voorkeur tot een klein aantal sleutels.

Aangepaste parameters met snake_case-namen, zoals order_id en customer_tier, kun je rechtstreeks in API Actions gebruiken als {{metadata_order_id}}, {{metadata_customer_tier}}, enzovoort. Zie AI Action Variables.

Voorbeeldscript:

widget

<script>
(function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
_quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"});
_quickchat("init", "abcdefghij");
</script>

Insluiten

<div id="quickchat-embedded" style="height:600px;overflow:hidden;"></div>
<script>
(function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat");
_quickchat("containerId", "quickchat-embedded");
_quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"});
_quickchat("init", "abcdefghij");
</script>

Met Insluiten plaats je de Quickchat AI-agent als chatvenster in de pagina in plaats van als zwevende knop. Gebruik dit voor een vaste plek, bijvoorbeeld een kolom in je helpcentrum, een contactpagina of een zijbalk in je app.

  1. Haal de Insluiten-code op

    • Log in op de Quickchat AI App.
    • Ga in de linkerzijbalk naar Kanalen → Je website.
    • Open Installeren en vervolgens Handmatig installeren met code.
    • Kopieer het Insluiten snippet, met zowel de container <div id="quickchat-embedded"> als het laadscript.
  2. Open het HTML-bestand van je website of de pagina in je websitebouwer.

  3. Plak de code

    • Voeg het Insluiten-fragment toe aan de <body> van je pagina.
    • Plaats het precies waar het chatvenster moet komen. De <div> bepaalt het formaat; pas style="height:600px" aan de beschikbare ruimte aan.
    • Voeg in een websitebouwer een code- of HTML-element op de gewenste plek toe en plak het fragment daarin.

Insluiten werkt alleen als je websitebouwer de code rechtstreeks in de pagina plaatst. Sommige bouwers, zoals Wix, tonen HTML-elementen in een apart frame waarin Insluiten niet kan laden. Verschijnt de chat niet op je gepubliceerde pagina, voeg dan de Widget toe via de instelling voor code op de hele site of deel je Chatpagina-link.

Laatst bewerkt: