Integraties: vragen.ai op je site
Een integratie is één manier waarop vragen.ai op je site verschijnt: een eigen vraagpagina, een overlay op iedere pagina, of suggesties in je bestaande zoekbalk. Een omgeving kan meerdere integraties naast elkaar hebben, ieder met een eigen vorm, agent en uiterlijk. Zo krijgt je klantenservicepagina een andere opzet dan je homepage, vanuit dezelfde kennisbank.
De vormen
Iedere integratie heeft een vorm; die bepaalt hoe bezoekers de widget tegenkomen:
- Pagina: een eigen pagina op je site, bijvoorbeeld
/vragen. De widget is er de hoofdzaak. - Overlay: opent over de pagina heen, vanaf een knop. De meest gekozen vorm.
- Zijpaneel: schuift van de zijkant in beeld en kan open blijven naast de content, desgewenst met een sneltoets.
- Search Add-on: haakt in op de zoekmachine die je al hebt en toont daar een gegenereerd antwoord bij de resultaten.
- Auto-aanvullen: stelt pagina's voor terwijl de bezoeker zijn vraag typt. Draait volledig op een zoekstrategie, zonder taalmodel.
In de wizard kies je de vorm via kaarten met een live voorbeeld, zodat je ziet wat je kiest voordat je verder gaat. De Search Add-on zit niet in de wizard; die vorm kies je na het aanmaken op het tabblad Instellen.
Hoe de widget opent, bepaal je per integratie: met de ingebouwde knop, via een eigen link, of gekoppeld aan een knop die al op je site staat.
Aansturing en uiterlijk
Iedere integratie koppel je aan een agent, die de antwoorden geeft in de stijl die jij daar hebt ingesteld. Onder Aanpassen regel je het uiterlijk: de weergave van de widget en de taal van de interface (Nederlands, Engels, Duits, Frans, Turks of Arabisch). Vanaf het Professional-pakket kun je daar meer: de vragen.ai-branding in de widget verbergen en er je eigen merkkleur voor in de plaats zetten, de losse interfaceteksten per taal herschrijven, en eigen CSS, HTML of JavaScript rond de widget meegeven.
Daar staat ook de AI-melding: de regel die bezoekers vertelt dat ze met AI praten, zoals de AI-verordening vraagt. Je stelt hem apart in voor het invoerveld en bij het antwoord, inclusief positie en moment van tonen. Waarom die melding er hoort te staan, lees je in ons artikel over de transparantieplicht.
Live zetten
Onder Installeren staat de embedcode, klaar om te kopiëren. Gebruik je WordPress of Drupal, dan is er een plugin en een module; voor andere systemen volstaat de scripttag of een oEmbed-link. De praktische kanten van het plaatsen, stylen en beveiligen staan in De widget op je website.
Op dezelfde pagina staan ook de API-koppelingen: sleutels waarmee een extern systeem gesprekken start, documenten aanlevert of gegevens uitleest. Wat je daarmee kunt, staat in Werken met de API.
Eerst zien hoe het wordt? Met Probeer uit open je een live voorbeeld, met Delen stuur je een collega een link, en met Toon in de testomgeving zet je de integratie klaar in de testomgeving zodat je team hem kan proberen voor hij op de site staat.
Wie mag wat
Integraties bekijken en beheren kan vanaf de rol Editor; een Annotator ziet deze module niet. Meer over de rollen: Gebruikers en rollen beheren.

