TOPdesk en AI: zo koppelt u AI-agents aan uw ITSM-platform
AI-agents koppelen aan TOPdesk voegt automatische ticketclassificatie, kennisbank-gestuurde conceptantwoorden en zelf-opbouwende kennisartikelen toe bovenop de bewezen ITSM-capaciteiten van TOPdesk. Met meer dan 4.500 klanten in de Benelux is TOPdesk het populairste ITSM-platform in Nederland. Deze guide laat zien hoe u ITSM Autopilot koppelt aan TOPdesk zonder uw bestaande setup te verstoren.
Wat bereikt u met AI-agents op TOPdesk?
Een AI-agent bovenop TOPdesk voegt drie capaciteiten toe zonder dat u TOPdesk zelf hoeft te vervangen. TOPdesk blijft uw kern ITSM-platform; AI versterkt het.
- 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 of aanpast.
- Automatische kennisopbouw. Opgeloste tickets met waardevolle uitkomst worden automatisch tot kennisbank-artikel verwerkt (draft voor redactie), zodat uw kennisbank meegroeit.
Technische architectuur
De integratie werkt via de TOPdesk REST API plus TOPdesk Event Actions. Er is geen 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
itsm-autopilot - Ken de rol toe die minimum nodig is: tickets lezen, antwoorden toevoegen, categorie/behandelaar muteren. Geen user-management of instellingen-rechten.
- Bewaar het wachtwoord veilig (u ziet het maar een keer)
Tip: gebruik geen bestaand operator-account. Een apart account maakt audit trails schoon en u kunt het altijd revoken zonder uw medewerkers te raken.
Stap 2: Webhook-endpoint registreren
In ITSM Autopilot: configureer een nieuw TOPdesk-environment en plak het applicatiewachtwoord in. Het platform geeft u 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. U ziet in het dashboard wat de agent zou hebben gedaan.
Minimaal 2 weken shadow draaien voordat u per agent-regel autonoom-mode aanzet. Zo ontdekt u:
- Welke ticket-categorieën AI goed classificeert (meestal boven 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: Graduele 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 suggereren (toont aan medewerker, niet aan user)
- Conceptantwoord draften (medewerker keurt goed)
- Autonoom antwoord sturen (alleen voor categorieën waar u 99%+ vertrouwen hebt)
- Autonome tool-acties (account unlock, group membership). Alleen na maanden bewezen track record
Veelgemaakte fouten en hoe ze te vermijden
| 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 om te volgen
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 uw webhook-endpoint vanaf TOPdesk bereikbaar zijn (publieke URL of reverse proxy via uw 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)? Voor 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 kiest u een plan of stopt u. Data wordt binnen 7 dagen verwijderd.
Hoe snel kunt u aan de slag?
U kunt ITSM Autopilot in 15 minuten koppelen aan TOPdesk (account + webhook-setup). Shadow mode start automatisch diezelfde dag. Na 2 weken shadow hebt u genoeg data om te beslissen welke categorieën u als eerste live zet. Het volledige traject van verbinding naar autonome classificatie op uw eerste categorie duurt typisch 4-6 weken, met waarde uit shadow-inzichten vanaf dag een.