Chat op je website plaatsen

Kort antwoord: ga naar Help Center → Instellingen → Chat op je website. Geef de website een naam en de adressen waar de chat mag verschijnen, klik op Koppeling opslaan, en plaats daarna de installatiecode op je site.

Stap voor stap

1. Open Help Center → Instellingen en kies links Chat op je website.
2. Geef bij Naam van deze website een herkenbare naam, bijvoorbeeld Hoofdwebsite.
3. Vul bij Websites waar chat mag verschijnen de volledige adressen in waar de chatknop mag werken, één per lijn.
4. Klik op Koppeling opslaan.
5. Bij de gekoppelde website vind je de Installatie-instructies met de code die je op je website plaatst.

Kiezen welke kennis deze chat mag gebruiken

Per gekoppelde website kies je welke kennis de agent mag raadplegen. Er zijn twee standen:

• Alle bronnen, de standaard. Alle gepubliceerde artikels, bronnen en snippets van je kennisbank. Bestaande koppelingen staan hierop en veranderen dus niet van gedrag.
• Geselecteerde bronnen. Enkel de aangevinkte collecties en de aangevinkte websites of PDF's, plus je snippets zolang je die aanlaat.

Collecties staan als een boom. Vink je een collectie aan, dan gaan haar subcollecties mee; die kan je daarna nog apart uitzetten. De beperking geldt overal tegelijk: zowel voor de kennis die Sarrai uit zichzelf ophaalt als voor wat ze via haar eigen zoekfunctie vindt. Ze kan er dus niet omheen redeneren en somt ook geen onderwerpen op die buiten je selectie vallen.

Drie dingen die je niet aan het scherm ziet, en die alle drie belangrijk zijn.

Dit is een relevantieknop en geen beveiliging. Je versmalt binnen wat toch al gepubliceerd en publiek is, en de sitesleutel in je installatiecode kan iedereen lezen. Gebruik het om antwoorden scherp te houden, nooit om vertrouwelijke content af te schermen. Dat laatste doe je door ze niet te publiceren.

Een lege selectie betekent niets, niet alles. Zet je "Geselecteerde bronnen" aan zonder één collectie aan te vinken, dan vindt de agent geen enkel artikel meer. De chat blijft werken en antwoordt netjes dat het buiten haar kennis valt, maar er komt geen waarschuwing dat je selectie leeg is.

Systeemkennis blijft altijd beschikbaar. Wat Sarrai over haar eigen mogelijkheden weet, valt nooit binnen de beperking.

Goed om te weten

Per gekoppelde website kan je de chat in- of uitschakelen, een nieuwe beveiligingscode genereren of de koppeling verwijderen.

Identiteitsintegratie is enkel zinvol als je de chat achter een login plaatst: dan geef je de identiteit van de ingelogde gebruiker (naam, e-mail, bedrijf) versleuteld mee, zodat je in de Inbox meteen ziet met wie je chat. Die versleutelde token bouw je op je eigen server en zet je in het data-identity-attribuut van de installatiecode. Voor anonieme bezoekers laat je dat attribuut gewoon weg.

Twee regels daarbij die je backend-ontwikkelaar moet kennen. Het geheim hoort nooit in je HTML of JavaScript: alleen de daarmee versleutelde token mag naar de browser, want wie het geheim in je paginabron kan lezen, kan zich als eender welke klant voordoen. En genereer een verse token bij elke paginaweergave: de vervaltijd wordt op de server gecontroleerd en een verlopen token wordt stil genegeerd. Bouw je de token één keer bij het inloggen en laat je hem dagenlang meereizen, dan werkt het eerst wel en later niet meer, zonder dat iemand een foutmelding ziet.

De taal van de widget

Het data-locale-attribuut in de installatiecode bepaalt de taal van de widget zelf. Vul je niets in, dan volgt hij de lang van je pagina.

Voor de inhoud is die keuze op een website-chat wel binair: begint de locale met nl, dan wordt het Nederlands, en al de rest wordt Engels. Een webshop met data-locale="fr-BE" krijgt dus een Engels welkomstbericht en geen Frans. Dat is bewust zo voor de website-chat; je Help Center zelf houdt gewoon zijn Franstalige onthaal.

Dit gaat alleen over het welkomstbericht en de taal waarop Sarrai terugvalt. De taal waarin ze antwoordt volgt nog steeds het bericht van de bezoeker, dus zodra iemand in het Frans typt, antwoordt ze in het Frans.

Welke voorbeeldvragen de bezoeker in de chat te zien krijgt, stel je in bij Voorbeeldvragen chat in datzelfde instellingen-menu.

Drie dingen om op te letten. De lijst toegestane websites wordt exact gematcht (schema, (sub)domein en poort moeten kloppen, en het moet https:// zijn): staat het exacte adres er niet in, dan verschijnt de chatknop gewoon niet, zonder foutmelding voor je bezoeker. De chat op je eigen website is bovendien een betaalde functie (Pro/Enterprise). En het identiteitsgeheim wordt maar één keer getoond bij het aanmaken, bewaar het meteen; vernieuw je het later, dan stoppen bestaande identiteitstokens met werken tot je het ook aan de andere kant bijwerkt.

Ook gezocht als

"chatknop op mijn site zetten", "widget installeren", "de chat embedden", "code voor de chatbot op website", "chat achter een login"

Zie ook

• De chat verschijnt niet of werkt niet: wat nu?
• De huisstijl van je help center instellen
• Welke content gebruikt de AI? (Bronnen)