Support-Portal: Terminbuchung über Microsoft Bookings, obwohl Microsoft verzögert synchronisiert
Für ein Support-Portal habe ich das Backend als Directus-Plugin in Node.js entwickelt: Kunden wählen im Kalender einen freien Zeitslot, ein Supporter wird zugeteilt, ein Teams-Link und ein Redmine-Ticket entstehen automatisch, und Stornos sind möglich. Die größte Hürde war, dass Microsoft Bookings gebuchte Slots erst Minuten später blockiert. Diese Lücke habe ich mit einer eigenen Zwischenspeicherung im Browser und auf dem Server geschlossen.
- Kategorie
- API-Integration
- Kontext
- Kunden-Supportportal eines IT-Dienstleisters
- Rolle
- Backend-Entwickler (ito consult), zusammen mit einem Frontend-Entwickler
- Zeitraum
- November 2024
- Tech-Stack
- Node.jsJavaScriptDirectusMicrosoft Graph APIMicrosoft BookingsMicrosoft TeamsRedmine API
- Verzögerung bei Microsoft abgefangen
- ~5 min
- Systeme orchestriert: Bookings, Teams, Redmine
- 3
Ausgangslage
Kunden sollten über ein Support-Portal selbst einen Termin mit dem Support buchen können: freie Zeitslots sehen, einen auswählen, und alles Weitere passiert automatisch, vom Ticket in Redmine bis zum Teams-Meeting.
Ich habe das Backend übernommen, ein Kollege das Frontend. Da das Portal auf Directus lief, musste das Backend als Directus-Plugin in Node.js entstehen.
Analyse & Vorgehen
Bookings deckt nur 80 % ab. Die Microsoft-Bookings-API über die Graph API erfüllte die Grundanforderungen, war aber an mehreren Stellen eingeschränkt. Die restlichen 20 % musste ich selbst bauen: freie Slots aus den Verfügbarkeiten der einzelnen Supporter zusammensetzen, die API-Antworten mit eigener Logik aufbereiten und in ein Format bringen, mit dem das Frontend arbeiten kann.
Das eigentliche Problem: Microsoft ist nicht sofort konsistent. Eine Buchung lief über die API erfolgreich durch, der Slot wurde aber erst rund fünf Minuten später tatsächlich blockiert. In dieser Zeit wurde er weiterhin als frei angezeigt und hätte ein zweites Mal gebucht werden können. Auf eine Erfolgsmeldung der API allein war also kein Verlass.
Lösung
- Slot-Logik: Das Plugin liest die Verfügbarkeiten der Supporter über die Graph API, baut daraus buchbare Zeitslots und liefert sie aufbereitet an den Kalender im Frontend.
- Automatischer Ablauf bei einer Buchung: Ein Supporter wird zufällig zugeteilt, ein Microsoft-Teams-Link wird erzeugt und ein Ticket in Redmine angelegt.
- Stornierung: Eigene Endpunkte, über die Termine wieder freigegeben werden.
- Gegen die Verzögerung bei Microsoft: Gebuchte Slots werden sofort an zwei Stellen festgehalten, im Browser des Nutzers und in einem Zwischenspeicher auf dem Server, und erst danach an Microsoft weitergegeben. So gilt ein Slot ab dem Moment der Buchung als belegt, auch wenn Microsoft ihn noch als frei meldet.
- Automatisierte Tests: Das Zusammenspiel aus Bookings, Teams, Redmine und Zwischenspeicher manuell zu testen, wäre kaum machbar gewesen. Deshalb habe ich die Abläufe mit Tests abgesichert.
- Dokumentation der gesamten Integration.
Ergebnis
Kunden buchen ihren Support-Termin selbst über einen Kalender, und Ticket, Teams-Meeting und Zuteilung entstehen ohne manuellen Aufwand. Doppelbuchungen durch die verzögerte Synchronisation bei Microsoft sind abgefangen.
Die Dokumentation wurde nach meinem Weggang intensiv genutzt, sodass das Team die Integration ohne mich weiterführen konnte. Das ganze Projekt entstand ohne generative KI.
Erkenntnisse
- Eine erfolgreiche API-Antwort heißt nicht, dass der Zustand schon stimmt. Bei externen Systemen muss man mit verzögerter Konsistenz rechnen und den eigenen Zustand selbst absichern.
- Je mehr Systeme zusammenspielen, desto wichtiger sind automatisierte Tests.
- Gute Dokumentation ist das, was bleibt, wenn man selbst nicht mehr da ist.