Ga naar hoofdinhoud

Webchatwidget

Het kanaal Web Chat zet een chatvenster op uw website. Bezoekers klikken op de chatknop in een hoek van de pagina en schrijven u. Hun gesprekken komen in de MonoChat-inbox terecht zoals die van elk ander kanaal, waar uw team, uw flows en uw AI-agents ze beantwoorden.

Het kanaal koppelen​

  1. Ga naar Instellingen › Chat › Kanalen en klik op Koppelen.
  2. Selecteer Web Chat.
  3. Vul de instellingen hieronder in en sla op. Elk veld legt uit waarvoor het dient, en rechts in het formulier ziet u een voorbeeld van het venster dat meeverandert terwijl u bewerkt. Wissel in het voorbeeld tussen de gesloten chatknop, het geopende venster en een voorbeeldgesprek.
  4. Kopieer de snippet die het kanaal toont en voeg die toe aan uw website (zie De snippet installeren).

U kunt meerdere Web Chat-kanalen koppelen, bijvoorbeeld één per website.

Instellingen​

InstellingWat het doet
KanaalnaamDe naam van het kanaal in MonoChat. Het venster toont die als kop wanneer de Widgettitel leeg is.
WidgettitelDe kop van het chatvenster.
OndertitelEen regel onder de titel, bijvoorbeeld hoe snel u meestal reageert. Maak het veld leeg om de regel te verbergen.
LogoEen afbeelding naast de titel: een PNG-, JPEG-, GIF-, SVG- of WebP-bestand.
KleurDe kleur van de chatknop, de kop en de berichten van de bezoeker. Tekst erop wordt zwart of wit, zodat die leesbaar blijft.
PositieRechtsonder of linksonder op de pagina.
BijlagenLaat bezoekers afbeeldingen, video's, audio en documenten tot 10 MB versturen.
EmojiknopToont naast het berichtvak een knop met veelgebruikte emoji. Staat standaard aan.
Startknop verbergenVerbergt de chatknop; u opent het venster dan vanuit uw eigen knop met de JavaScript-API.
Mobiele weergaveHoe het venster op telefoons opent: Volledig scherm of Compact, een paneel over de onderste drie kwart van de pagina.
Toegestane domeinenDe sites waarop het venster mag verschijnen: een exacte host (www.example.com) of alle subdomeinen (*.example.com), met een optionele poort (localhost:3000). Leeg gelaten mag elke site het tonen.

Talen​

De knoppen en labels van het venster volgen de browsertaal van de bezoeker en zijn in het Engels wanneer MonoChat die taal niet heeft.

De Widgettitel, de Ondertitel, de Introductie van het formulier en de Toestemmingstekst hebben een versie voor elke taal van uw workspace; die talen stelt u in via Instellingen › CRM › Talen (zie Taalinstellingen). Klik op het veld om elke versie te schrijven. Het venster toont de versie in de browsertaal van de bezoeker, of die in uw standaardtaal wanneer er voor die taal geen is.

Om het venster in één taal te tonen, welke browser er ook wordt gebruikt, roept u MonoChat('setLocale', 'tr-TR') aan via de JavaScript-API.

Formulier vóór de chat​

Staat het formulier uit, dan beginnen bezoekers meteen te schrijven. Gebruik een flow om naar een e-mailadres of telefoonnummer te vragen (zie Flows en de widget).

Staat het formulier aan, dan vraagt het venster hierom vóór het eerste bericht:

VeldOpties
NaamUit, optioneel of verplicht
E-mailUit, optioneel of verplicht
TelefoonUit, optioneel of verplicht

U kunt ook de tekst boven de velden schrijven en een toestemmingsvakje toevoegen met uw eigen tekst en een link naar uw privacybeleid. Staat het vakje aan, dan moeten bezoekers het aanvinken om de chat te starten. De naam, het e-mailadres en het telefoonnummer worden in het profiel van de klant opgeslagen.

De snippet installeren​

Het kanaal toont een snippet waarin het widgetadres en de kanaalsleutel al zijn ingevuld, direct nadat u het koppelt en onder het voorbeeld wanneer u het kanaal bewerkt. Plak die vóór de afsluitende </body>-tag van elke pagina die de chat moet tonen:

<script>
window.MonoChat = window.MonoChat || function () { (MonoChat.q = MonoChat.q || []).push(arguments) }
</script>
<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>"></script>

Het venster laadt na uw pagina en maakt die dus niet trager.

Overstappen van de oude WebChat

Staat de snippet van een ouder WebChat-kanaal nog op uw site, verwijder die dan en plak op die plek de snippet van het nieuwe Web Chat-kanaal.

Modus volledige pagina​

Om de chat een eigen pagina te geven, zoals een supportpagina, voegt u &mode=fullpage toe aan de tweede tag van de snippet:

<script async src="https://<widget address from the channel>/static/loader.js?key=<channel key>&mode=fullpage"></script>

Het venster vult dan de hele pagina en blijft open, zonder kop en zonder chatknop; close en toggle doen niets. Het laadt met de pagina in plaats van erna, en de instelling Mobiele weergave geldt niet.

Google Tag Manager​

  1. Voeg in uw container een Custom HTML-tag toe en plak de snippet er ongewijzigd in.
  2. Kies de trigger All Pages, of een trigger die alleen afgaat op de pagina's die de chat moeten tonen.
  3. Klik op Submit en daarna op Publish.

Als de eigen scripts van uw pagina MonoChat aanroepen, kunnen ze vóór de tag draaien. Laat het eerste <script> van de snippet ook op de pagina staan, zodat hun aanroepen op het venster wachten.

Websitebouwers en webshops​

Kunt u de code van uw site niet bewerken, plak de snippet dan ongewijzigd in het veld dat uw platform biedt voor code op elke pagina, aan het eind van de pagina of in de footer:

PlatformWaar de snippet komt
WordPressInstalleer de plug-in WPCode en plak de snippet in het vak Footer. Of u op WordPress.com code kunt toevoegen, hangt af van uw abonnement.
ShopifyOnline Store › Edit code: open theme.liquid en plak de snippet vlak vóór </body>.
WixSettings › Custom Code › Add Custom Code: kies alle pagina's en Body – end. De site moet gepubliceerd zijn en een gekoppeld domein hebben.
SquarespaceHet veld Footer van Code Injection, in de abonnementen Core, Plus en Advanced.
WebflowSite settings › Custom code › Footer code, en publiceer daarna de site.
ikasSales Channel › Extensions › Scripts › Add Script: plak de snippet als scriptinhoud, sla op en controleer of het script is ingeschakeld.

JavaScript-API​

De snippet definieert een functie MonoChat op uw pagina. Roep die aan vanuit uw eigen scripts, links en knoppen om het venster te bedienen. Aanroepen die worden gedaan voordat het venster is geladen, wachten tot het klaar is, dus u kunt ze direct na de snippet doen.

Opdrachten​

AanroepWat het doet
MonoChat('open')Opent het venster.
MonoChat('close')Sluit het venster.
MonoChat('toggle')Opent het venster als het gesloten is en sluit het als het open is.
MonoChat('hideLauncher')Verbergt de chatknop. Het venster opent nog steeds met open en toggle.
MonoChat('showLauncher')Toont de chatknop weer.
MonoChat('setUser', { name, email, phone })Geeft door wat u al over de bezoeker weet. Zie Ingelogde bezoekers.
MonoChat('setLocale', 'tr-TR')Toont het venster in deze taal, ongeacht de taal van de browser. Zie Talen.
MonoChat('on', event, callback)Roept callback aan telkens wanneer event plaatsvindt. Zie Gebeurtenissen.

Gebeurtenissen​

GebeurtenisWanneercallback ontvangt
readyHet venster is geladen.Niets
openHet venster opent, via de chatknop of een aanroep.Niets
closeHet venster sluit.Niets
unreadHet aantal ongelezen antwoorden verandert: er komt een antwoord binnen terwijl het venster gesloten is, of de bezoeker opent het.Het aantal ongelezen antwoorden

Registreer uw callbacks direct na de snippet, zodat u ready niet mist.

Ingelogde bezoekers​

Is de bezoeker ingelogd op uw site, geef dan zijn gegevens door met setUser. Elk veld is optioneel en het venster leest alleen name, email en phone.

  • Het formulier vóór de chat wordt ermee ingevuld. Het wordt overgeslagen als het alles heeft wat het vraagt, tenzij het toestemmingsvakje aanstaat: dat vinken bezoekers altijd zelf aan.
  • Ze worden opgeslagen in het profiel van de klant in MonoChat, zodat uw team ziet wie er schrijft.
  • Is het e-mailadres of het telefoonnummer ongeldig, dan wordt geen van de gegevens opgeslagen.

Voorbeelden​

Open het venster vanuit uw eigen knop en verberg de chatknop:

<button onclick="MonoChat('open')">Chat met ons</button>
<script>
MonoChat('hideLauncher')
</script>

Geef een ingelogde gebruiker door en toon het venster in de taal van de pagina:

<script>
MonoChat('setUser', { name: 'Jane Doe', email: 'jane@example.com', phone: '+1 555 010 0000' })
MonoChat('setLocale', document.documentElement.lang)
</script>

Toon het aantal ongelezen antwoorden op uw eigen knop:

<button onclick="MonoChat('open')">Support <span id="chat-unread"></span></button>
<script>
MonoChat('hideLauncher')
MonoChat('on', 'unread', function (count) {
document.getElementById('chat-unread').textContent = count || ''
})
</script>

Stuur een gebeurtenis naar uw analysetool wanneer een bezoeker het venster opent:

<script>
MonoChat('on', 'open', function () {
gtag('event', 'chat_opened')
})
</script>

Gesprekken​

Elke bezoeker is een klant in MonoChat en zijn gesprek wordt in zijn browser bewaard: een bezoeker die met dezelfde browser terugkomt, ziet de laatste 200 berichten, tot 90 dagen na het laatste bericht. Een andere browser of een ander apparaat begint een nieuw gesprek. De antwoorden van uw team en de typindicator verschijnen direct in het venster.

De emojiknop naast het berichtvak biedt veelgebruikte emoji. Bezoekers kunnen ook elke emoji via hun toetsenbord typen.

Berichten die een bezoeker stuurt, tonen vinkjes zoals in WhatsApp: één grijs vinkje als het bericht is verzonden, twee grijze vinkjes als het MonoChat heeft bereikt en twee blauwe vinkjes zodra iemand van uw team het gesprek heeft geopend. In MonoChat staan uw antwoorden als afgeleverd zodra het venster van de bezoeker ze ontvangt, en als gelezen zodra de bezoeker het venster opent.

Als het venster gesloten is, toont een nieuw antwoord het aantal ongelezen berichten op de chatknop en speelt het een kort geluid af. Browsers spelen het geluid pas af nadat de bezoeker ergens op de pagina heeft geklikt of getypt.

Berichttypen​

Het venster toont berichten zoals het MonoChat-chatscherm: de naam van de agent boven zijn of haar antwoorden, een regel met de datum waar een nieuwe dag begint en de tijd in elke ballon, met de vinkjes bij de berichten van de bezoeker.

Naast tekst, emoji en bestanden kunnen uw antwoorden de typen hieronder gebruiken. Verzend ze vanuit de flownode Bericht verzenden, korte berichten, apps en functies (zie Berichttypen).

TypeHoe het venster het toont
Afbeelding, video, audio, stickerIn de ballon.
DocumentEen kaart met het bestandstype en de naam, die het bestand downloadt.
Snelle antwoordenKnoppen onder het laatste bericht. Een klik verzendt de titel van de knop als antwoord van de bezoeker.
KnopEen bericht met een optionele koptekst (een tekst, een afbeelding, een video of een document), een voettekst en knoppen die een antwoord verzenden, een webadres openen of een telefoonnummer bellen.
CTA-URLEen bericht met één knop die een webadres opent.
LijstDe rijen in de ballon, gegroepeerd per sectie. Een klik op een rij verzendt die als antwoord van de bezoeker.
CarrouselKaarten waar de bezoeker zijwaarts doorheen scrolt, elk met een afbeelding of video, een titel, een ondertitel en knoppen.
LocatieEen pin met de naam en het adres van de plek, die de plek opent in Google Maps.
LocatieverzoekEen knop Locatie versturen. De browser vraagt de bezoeker om toestemming, waarna diens locatie als locatiebericht in MonoChat binnenkomt.
ContactenDe naam en het bedrijf van elk contact, met links om hun telefoonnummers te bellen en naar hun e-mailadressen te schrijven.

Snelle antwoorden, antwoordknoppen, lijstrijen en het locatieverzoek werken alleen bij het laatste bericht, zodat bezoekers geen oude vraag kunnen beantwoorden.

Knoppictogrammen​

Knoppen die een webadres openen, kunnen een pictogram tonen: kies het in het veld Pictogram van een CTA-URL-bericht of een Web-URL-knop. Het veld verschijnt alleen wanneer u het bericht voor Web Chat samenstelt: andere kanalen tonen geen pictogrammen. De pictogrammen zijn Link, Website, WhatsApp, Instagram, Messenger, Facebook, Telegram, TikTok, Telefoon, E-mail en Locatie; een knop zonder pictogram toont het linkpictogram.

Flows en de widget​

Welkomstberichten, openingstijden, antwoorden buiten openingstijden, vragen om een e-mailadres of telefoonnummer en proactieve berichten stelt u in met flows, niet met kanaalinstellingen.

De gebeurtenis Klantactie ontvangen start een flow vanuit het venster:

  • Chatwidget voor het eerst geopend: de bezoeker opent het venster en heeft geen open gesprek. MonoChat start het gesprek, of heropent het gesloten gesprek van de bezoeker, zodat de flow de bezoeker kan schrijven voordat die zelf schrijft. Het venster opnieuw openen terwijl het gesprek open is, activeert deze actie niet opnieuw.
  • Chatwidget geopend: de bezoeker opent het venster, elke keer, de eerste keer inbegrepen. Een bezoeker zonder open gesprek krijgt er een, zoals hierboven.
  • Chatwidget gesloten: de bezoeker sluit het venster tijdens een open gesprek.

Staat het formulier vóór de chat aan, dan telt het venster als geopend zodra de bezoeker het formulier heeft ingevuld.

Alleen een pagina met de widget bekijken activeert geen van deze acties. Een bezoeker die nog niet heeft geschreven, wordt alleen een klant in MonoChat als een flow op de actie wacht.

In de modus volledige pagina opent het venster met de pagina, dus telt het laden van de pagina als het openen van het venster. Elk kanaal telt maximaal 60 keer per minuut dat het venster wordt geopend; daarboven start er geen flow.

Om bezoekers te begroeten, maakt u een flow die start met Klantactie ontvangen ingesteld op Chatwidget voor het eerst geopend en voegt u een node Bericht verzenden toe met uw welkomstbericht. Stel dat samen met de berichtbouwer, met antwoordknoppen, een lijst of links met pictogrammen.

Powered by MonoChat​

Het venster toont een kleine regel Powered by met het MonoChat-logo. Dat is geen kanaalinstelling: de regel kan alleen voor een hele MonoChat-installatie worden verborgen.