TOPdesk × AI: zo koppel je AI-agents aan je ITSM
TOPdesk is het populairste ITSM-platform in Nederland, met meer dan 4.500 klanten in de Benelux. Deze guide laat zien hoe je AI-agents koppelt aan TOPdesk om tickets automatisch te classificeren, kennisbank-zoekacties te versnellen en repetitieve acties uit te voeren — zonder je bestaande TOPdesk-setup te verstoren.
Wat je bereikt met AI-agents op TOPdesk
Een AI-agent bovenop TOPdesk voegt drie capaciteiten toe zonder dat je TOPdesk zelf hoeft te vervangen:
- Automatische ticketclassificatie — inkomend ticket krijgt binnen seconden de juiste categorie, urgentie, impact en behandelaarsgroep toegewezen. Bespaart 30-90 seconden per ticket voor de servicedesk-triage.
- AI-assisted antwoorddraft — op basis van ticket-inhoud en relevante kennisbank-artikelen stelt de agent een conceptantwoord op dat de behandelaar goedkeurt/aanpast.
- Automatische kennisopbouw — opgeloste tickets met waardevolle uitkomst worden automatisch tot kennisbank-artikel verwerkt (draft voor redactie), zodat je kennisbank meegroeit.
Technische architectuur
De integratie werkt via de TOPdesk REST API plus TOPdesk Event Actions. Er is géén on-premise component nodig; TOPdesk SaaS wordt volledig ondersteund.
| Component | Rol |
|---|---|
| TOPdesk Event Action | Triggert bij nieuw ticket, status-change, nieuw antwoord |
| Webhook endpoint | Ontvangt events van TOPdesk en stuurt ze naar de AI-agent |
| AI-agent runner | Classificeert, genereert draft, retrieved knowledge |
| TOPdesk REST API (PATCH/POST) | Updates het ticket met AI-suggestie of voert actie uit |
| Audit log | Legt elke AI-beslissing vast voor compliance |
Stap 1: Operator-account aanmaken
Maak in TOPdesk een dedicated operator-account voor de AI-integratie:
- Ga naar Instellingen → Functionele instellingen → Login-instellingen → Applicatie-wachtwoorden
- Maak een nieuw applicatiewachtwoord aan met de naam
ai-servicechanger - Ken de rol toe die minimum nodig is: tickets lezen, antwoorden toevoegen, categorie/behandelaar muteren. Géén user-management of instellingen-rechten.
- Bewaar het wachtwoord veilig (je ziet het maar één keer)
Tip: gebruik géén bestaand operator-account. Een apart account maakt audit trails schoon en je kunt 'm altijd revoken zonder je medewerkers te raken.
Stap 2: Webhook-endpoint registreren
In ITSM Autopilot: configureer een nieuw TOPdesk-environment en plak het applicatiewachtwoord in. Het platform geeft je een webhook-URL terug:
https://api.itsmautopilot.com/webhooks/topdesk/<your-tenant-id>Stap 3: Event Actions configureren
In TOPdesk: Instellingen → Event management → Event Actions → nieuw.
Minimum drie events om te starten:
| Event | Trigger | Doel |
|---|---|---|
incident.created | Nieuw incident aangemaakt | Classificatie + kennisbank-check |
incident.updated | Status/notitie toegevoegd | Re-evaluatie als user aanvullende info gaf |
incident.closed | Ticket gesloten | Trigger voor kennisbank-artikel-draft |
application/json.
Stap 4: Shadow mode (verplicht!)
Zet nooit direct AI-agents live op productietickets. ITSM Autopilot start standaard in shadow mode: de agent leest mee, maakt suggesties, maar muteert geen tickets. Je ziet in het dashboard wat de agent zou hebben gedaan.
Minimaal 2 weken shadow draaien voordat je per agent-regel autonoom-mode aanzet. Zo ontdek je:
- Welke ticket-categorieën AI goed classificeert (meestal >95% na een week)
- Waar de kennisbank gaten heeft (AI kan geen oplossing vinden = kennisbank onvolledig)
- Welke edge cases menselijke review blijven vragen
Stap 5: Gradueel rollout
Nadat shadow-resultaten overtuigen: zet autonoom-mode aan per categorie, niet globaal. Volgorde van laag naar hoog risico:
- Classificatie (muteert categorie/urgentie, niet de user-experience)
- Kennisbank-artikel suggeren (toont aan medewerker, niet aan user)
- Conceptantwoord draften (medewerker keurt goed)
- Autonoom antwoord sturen (alleen voor categorieën waar je 99%+ vertrouwen hebt)
- Autonome tool-acties (account unlock, group membership) — alleen na maanden bewezen track record
Valkuilen
| Probleem | Oorzaak | Fix |
|---|---|---|
| AI classificeert alles als "Overig" | Categorie-beschrijvingen onvoldoende of ontbrekend in TOPdesk | Voeg 1-2 voorbeelden per categorie toe in de category-description |
| Kennisbank-artikelen worden niet gebruikt | Artikelen staan op status concept, niet gepubliceerd | Filter op published + zorg dat metadata (tags, categorie) ingevuld is |
| Dubbele acties bij status-change | Meerdere Event Actions triggeren op dezelfde update | Voeg filter toe in TOPdesk Event Action: alleen bij specifieke status-transities |
| Webhooks falen intermittent | TOPdesk heeft geen ingebouwde retry | ITSM Autopilot doet eigen retry met exponential backoff; check de event-log |
Prestatiemetingen
Meet vanaf dag 1, ook in shadow:
- Classificatie-accuracy (AI-voorgestelde categorie vs uiteindelijke categorie)
- MTTR (mean time to resolve) per ticket-categorie, voor vs na AI
- First Contact Resolution rate voor de categorieën waar AI een antwoord draftte
- Servicedesk-medewerker-tijd per ticket (via werkbonnen in TOPdesk)
Veelgestelde vragen
Werkt dit ook met TOPdesk on-premise? Ja. De integratie is API-based, dus on-premise werkt net zo goed als SaaS. Wel moet je webhook-endpoint vanaf TOPdesk bereikbaar zijn (publieke URL of reverse proxy via je eigen firewall).
Wat gebeurt er met ticket-inhoud? Gaat die naar externe LLMs? Nee, standaard niet. ITSM Autopilot draait op EU-gehoste LLMs (Azure OpenAI EU of Mistral), ticket-inhoud verlaat de EU niet. Voor klanten met strenge eisen is een zelf-gehoste LLM ook mogelijk.
Hoe zit het met persoonsgegevens (GDPR)? Vóór de prompt wordt PII automatisch gemaskeerd (namen, emailadressen, klantnummers) tenzij de use case die expliciet nodig heeft. Zie ook ons artikel over PII-masking in de servicedesk.
Kunnen we beginnen zonder commitment? Ja, 30 dagen gratis trial zonder credit card. Na 30 dagen kies je plan of stop — data wordt binnen 7 dagen verwijderd.
Wat nu?
Een werkende TOPdesk-integratie op te zetten kost typisch 1-2 dagen (account + events + shadow-configuratie), daarna 2 weken shadow voor je comfort kunt voelen. Plan een demo of start direct de trial.