Website-integratie

Eén scriptregel zet het chatvenster op je website, plus de methoden en taalregels die je op de pagina kunt aanroepen.

In het onderstaande verwijst {API} naar het serviceadres; je vindt dit op de pagina 'Integratie' in het beheer.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>

data-key is de publieke key; kopieer deze op de pagina 'Integratie' in het beheer.
Registreer op de pagina 'Integratie' de websites waarop de widget mag worden ingesloten (bijvoorbeeld https://shop.example.com). Andere websites kunnen je publieke key niet gebruiken, zelfs als ze die hebben. Vul dit verplicht in vóór je live gaat.
Optioneel: gebruik data-theme="dark" voor een donkere stijl.
Optioneel: data-language="de". Als je website meertalig is, geef je de taal van de huidige pagina door; de klantenservice gebruikt standaard deze taal (bezoekers kunnen nog steeds wisselen). Zie Overzicht van de open API voor de ondersteunde taalcodes.
Optioneel: data-language="auto". De taal uit <html lang> wordt als standaardtaal gebruikt; als de pagina daarna van taal wisselt (de lang-attribuut wordt gewijzigd, ook zonder herladen bij een single-page-app), volgt het klantenservicevenster automatisch.

Op de pagina kun je de volgende methoden aanroepen:

Methode	Functie
`AICS.open()` / `AICS.close()` / `AICS.toggle()`	Het klantenservicevenster openen, sluiten of aan/uit zetten, bijvoorbeeld gekoppeld aan een knop 'Contact met klantenservice'
`AICS.identify(userToken)`	Nadat een klant is ingelogd, aan de klantenservice doorgeven wie het is (zie Ingelogde klanten identificeren)
`AICS.setLanguage(code)`	Aanroepen wanneer de website van taal wisselt; het klantenservicevenster en de daaropvolgende antwoorden volgen de nieuwe taal, bijvoorbeeld `AICS.setLanguage("ja")`; ook notaties zoals `zh-Hans` en `pt-BR` worden ondersteund
`AICS.reset()`	Aanroepen wanneer de klant uitlogt: het klantenservicevenster wordt ontladen en de huidige sessie gaat verloren; als je het script opnieuw laadt, krijg je een nieuw anoniem klantenservicevenster en kan de volgende persoon het gesprek van de vorige niet zien

Taal

Het klantenservicevenster toont de taal die hoort bij de locatie van de bezoeker (IP), inclusief de interfaceteksten en het welkomstbericht; als data-language is ingesteld, krijgt de paginataal voorrang. Als de locatie niet kan worden bepaald, wordt de 'Standaardtaal' uit het beheer gebruikt.
De AI antwoordt in de taal die de klant gebruikt; als uit de inhoud van het bericht geen taal valt af te leiden (emoji, ordernummer), wordt de hierboven bepaalde taal gebruikt.
De klant kan wisselen via het taalkeuzemenu boven in het venster, of rechtstreeks tegen de AI zeggen: 'Antwoord in het Engels.' Daarna blijft de AI deze taal gebruiken, zelfs als de klant in een andere taal schrijft.
Als de website van taal wisselt (via AICS.setLanguage of door bij data-language="auto" de <html lang> te wijzigen), geldt dat ook als een keuze van de klant; bij deze en de bovenstaande manieren is de laatste keuze bepalend. Alleen de standaardtaal die bij het openen van de pagina wordt meegegeven, overschrijft een eerder door de klant gekozen taal niet.
In het beheer onder 'Botinstellingen → Taal' kun je het bepalen op basis van IP uitschakelen, de standaardtaal wijzigen en beperken welke talen beschikbaar zijn.
Als de dienst achter een reverse proxy of CDN draait, moet je aan de serverzijde TRUSTED_PROXIES of COUNTRY_HEADER configureren; anders kan het echte IP-adres van de bezoeker niet worden verkregen.

Was deze pagina nuttig?

Laatst bijgewerkt: 31 oktober 2026