Documentatie

Installeer de widget en koppel met de API.

1. Installeer de widget

Voeg deze scripttag toe aan elke pagina waar de widget moet verschijnen. Je persoonlijke sleutel vind je onder Dashboard → Widget.

<script src="https://voicetask.nl/widget/voicetask.js" data-key="pk_YOUR_KEY" data-lang="nl" defer></script>

data-lang="nl" of "en" bepaalt de taal. Zonder dit attribuut volgt de widget de <html lang> van de pagina, met de standaardtaal uit je dashboard als terugval.

2. Ingesloten modus (optioneel)

Kies "Ingesloten" als positie en plaats dit element waar de widget moet verschijnen:

<voicetask-widget></voicetask-widget>

3. Aanwezigheid als operator (optioneel)

Gebruik je de widget zelf? Voeg dan je persoonlijke operatortoken toe, zodat we je niet mailen terwijl de widget open staat:

<script src="https://voicetask.nl/widget/voicetask.js" data-key="pk_YOUR_KEY" data-lang="nl" data-operator-token="op_YOUR_TOKEN" defer></script>

API-referentie

De widget gebruikt deze publieke endpoints. Alle endpoints werken met JSON en ondersteunen CORS.

GET	/api/widget/config?key=pk_…	Widget appearance & feature settings
POST	/api/widget/chat	{ key, messages: [{ role, content }], locale } → { answer, sources }
POST	/api/widget/request	{ key, title, notes?, email? } → creates a task in your task list
POST	/api/widget/heartbeat	{ key, sessionId, operatorToken? } → presence tracking