Wie die Webhook-Kalendersynchronisierung funktioniert

„Webhook“ klingt technisch, aber das Konzept ist alltäglich: Es ist eine Türklingel für Software. Statt dass ein Kalender-Synchronisierungsdienst ständig an Googles oder Microsofts Tür klopft und fragt „Schon etwas Neues?“, klingelt der Anbieter an der Tür des Dienstes, sobald sich etwas ändert. Diese Umkehrung - der Anbieter benachrichtigt den Dienst, statt dass der Dienst den Anbieter befragt - ist das gesamte Fundament schneller, moderner Kalendersynchronisierung.

Diese Seite erklärt, was ein Webhook ist, wie Google und Microsoft ihn für Kalender umsetzen und wie ein Synchronisierungsdienst einen Strom von „etwas hat sich geändert“-Signalen in eine zuverlässige beidseitige Synchronisierung verwandelt.

Ein Webhook ist ein Rückruf an eine URL

Ein Webhook ist nur eine Vereinbarung: „Wenn X passiert, sende eine Nachricht an diese Webadresse.“ Der Synchronisierungsdienst registriert eine URL beim Kalenderanbieter und sagt im Grunde: Rufe diesen Endpunkt auf, wann immer sich dieser Kalender ändert. Von da an übernimmt der Anbieter das Aufrufen. Der Dienst muss nicht pollen, weil ihm Bescheid gegeben wird.

Die Benachrichtigung selbst ist meist schlank - oft kaum mehr als „Kalender A hat sich geändert“. Sie ist ein Auslöser, keine Nutzlast. Dieses Detail ist für Geschwindigkeit und Datenschutz gleichermaßen wichtig: Die eigentlichen Termindaten werden nicht im Webhook verschickt; sie werden separat über die authentifizierte API abgerufen, nur wenn nötig.

Wie die beiden Anbieter es umsetzen

Die Mechanik unterscheidet sich leicht, aber die Form ist dieselbe:

Google Kalender - Push-Benachrichtigungs-Kanäle. Der Dienst ruft Googles watch-Methode für einen Kalender auf, um einen Kanal zu öffnen. Google sendet dann eine HTTP-Benachrichtigung an den registrierten Endpunkt, sobald sich dieser Kalender ändert. Kanäle laufen ab, daher erneuert der Dienst sie nach einem Zeitplan.
Microsoft Graph - Änderungsbenachrichtigungs-Abonnements. Der Dienst erstellt ein Abonnement für den Kalender eines Nutzers. Microsoft sendet eine Änderungsbenachrichtigung an den Endpunkt, wenn Termine hinzugefügt, aktualisiert oder entfernt werden. Auch Abonnements laufen ab und werden automatisch erneuert.

In beiden Fällen ist der Anbieter die aktive Partei. Calendar Family registriert und erneuert diese Abonnements im Hintergrund für Sie - es gibt nichts zu konfigurieren.

Von „etwas hat sich geändert“ zu einem synchronisierten Termin

Ein Webhook teilt dem Dienst mit, dass sich etwas geändert hat, nicht was. Der Ablauf ist also:

Eine Benachrichtigung trifft am Endpunkt des Dienstes ein: Kalender A hat sich geändert.
Der Dienst ruft das Delta ab von Anbieter A mithilfe eines Sync-Tokens - eines Lesezeichens, mit dem er nur nach dem Neuen seit dem letzten Mal fragen kann, statt den ganzen Kalender erneut zu lesen.
Der Dienst überträgt die Änderung - Termin, Wiederholungsregel, Zeitzone - in das Format von Anbieter B.
Er schreibt die Änderung in Kalender B über die authentifizierte API von B.
Die Änderung erscheint in Kalender B, typischerweise innerhalb von etwa einer Minute.

Weil Schritt 2 ein Sync-Token verwendet, bewegt der Dienst die geringstmögliche Datenmenge und muss nie einen ganzen Kalender durchsuchen, um eine einzelne Änderung zu finden.

Gebaut, um verpasste Signale zu verkraften

Netzwerke verlieren Nachrichten; Abonnements laufen gelegentlich ab. Eine gut gebaute Webhook-Synchronisierung setzt keine Perfektion voraus. Das Sync-Token ist das Sicherheitsnetz: Der Dienst kann jederzeit den Anbieter fragen „Was hat sich seit diesem Lesezeichen geändert?“ und abgleichen. Eine verpasste Benachrichtigung führt also nicht zu stillem Auseinanderdriften - sie wird bei der nächsten Synchronisierung erkannt und korrigiert. Diese Kombination aus Push-Benachrichtigungen für Geschwindigkeit und Sync-Tokens für Korrektheit ist es, die das Ergebnis schnell und vertrauenswürdig macht.

Warum das auch für den Datenschutz gut ist

Weil der Webhook nur ein Auslöser ist und die Daten über die offizielle, authentifizierte API abgerufen werden, werden Ihre Termininhalte nicht in Benachrichtigungs-Nutzlasten verstreut. Calendar Family baut auf diesem Mechanismus auf: API-Zugriff, den Sie gewähren und widerrufen können, und es ruft nur das Geänderte ab. Siehe Ist die Kalendersynchronisierung sicher und vertraulich? für die vollständige Behandlung und Echtzeit versus Polling dafür, warum der Webhook-Ansatz gewinnt. Der Überblick über die Echtzeit-Synchronisierung führt alles zusammen.

Calendar Family ist kostenlos.

Kostenlos starten

Häufig gestellte Fragen

Was ist ein Kalender-Webhook?

Ein Webhook ist eine Nachricht, die ein Kalenderanbieter an eine vorab registrierte Webadresse sendet, sobald sich etwas ändert. Statt dass ein Synchronisierungsdienst wiederholt fragt „Gibt es etwas Neues?“, benachrichtigt der Anbieter ihn proaktiv - und genau das lässt die Synchronisierung nahezu sofort wirken.

Unterstützen sowohl Google als auch Microsoft Webhooks für Kalender?

Ja. Google Kalender verwendet Push-Benachrichtigungs-Kanäle („watch“), und Microsoft Graph verwendet Änderungsbenachrichtigungs-Abonnements. Beide rufen einen registrierten Endpunkt auf, wenn sich ein Kalender ändert, und beide erfordern, dass das Abonnement regelmäßig erneuert wird, was ein Synchronisierungsdienst automatisch erledigt.

Enthält der Webhook meine Termindetails?

In der Regel nein. Die Benachrichtigung sagt meist nur „dieser Kalender hat sich geändert“ - sie ist ein Auslöser, nicht die Daten. Der Synchronisierungsdienst stellt dann eine separate authentifizierte Anfrage, um nur das Geänderte abzurufen, sodass der Termininhalt über die sichere API reist statt im Webhook selbst.

Was passiert, wenn ein Webhook verloren geht?

Die Synchronisierung verlässt sich nicht darauf, nie einen zu verpassen. Mithilfe von Sync-Tokens kann der Dienst den Anbieter fragen „Was hat sich seit meiner letzten Prüfung geändert?“ und abgleichen, sodass eine verlorene Benachrichtigung sich bei der nächsten Synchronisierung von selbst heilt, statt dauerhaft zu einem Auseinanderdriften zu führen.