Zum Hauptinhalt springen

28.05.2026: Webhook V2.2

· 2 Minuten Lesezeit
Gianni Piruzza
Gianni Piruzza
Marketing Manager

Webhook-Payloads enthalten jetzt Sally-User-IDs. 🔗

Das neue V2.2-Schema ist der Default für alle neu angelegten Sally-Webhooks. Es ergänzt jeden Teilnehmer um eine userId und liefert ein neues users-Array auf oberster Ebene. Damit kann deine Automatisierung ein Transkript eindeutig einem Sally-Konto zuordnen, auch wenn der Termin keine Kalenderanbindung hat und die E-Mail-Adresse fehlt.

🚀 Was ist neu?​

  • attendees[].userId: jeder Teilnehmer, dessen E-Mail zu einem aktiven Sally-Konto passt, trägt jetzt die Directory-User-ID. Externe Gäste behalten nur name und email und bekommen userId: null.
  • users (Top-Level-Array): listet alle Sally-User auf, die am Termin beteiligt sind: den Uploader der Aufnahme plus die technischen Owner aller Termine mit derselben Online-Meeting-ID. Dedupliziert nach userId, gefiltert auf aktive User mit aktivem Directory-Zugriff.
  • Voll additiv: bestehende V2.1-Abos behalten ihr bisheriges Payload. Es bricht nichts.
  • Version pro Webhook: die Schema-Version wird am Webhook selbst gespeichert. Du kannst V2.1- und V2.2-Webhooks parallel auf demselben Unternehmenskonto betreiben.

Warum das wichtig ist​

Wenn du Transkripte in ein CRM, ein Data Warehouse oder eine eigene Automatisierung schiebst, musst du nicht mehr raten, wer das Meeting gehostet hat. Die User-ID ist stabil über E-Mail-Änderungen hinweg und funktioniert auch dann, wenn keine Kalendereinladung an der Aufnahme hängt.

So aktualisierst du​

Es gibt kein automatisches Upgrade. Bestehende V2.1-Webhooks bleiben auf V2.1, damit ältere Integrationen nicht plötzlich neue Felder bekommen. Zwei Wege, um umzustellen:

  1. Parallelbetrieb (empfohlen): lege einen neuen Webhook mit denselben Einstellungen wie dein bestehender an. Der neue Webhook läuft automatisch auf V2.2. Sobald dein Zielsystem die neuen Felder verarbeitet, deaktivierst du den alten V2.1-Webhook.
  2. In-Place-Upgrade: öffne den bestehenden Webhook und stelle das Dropdown HTTP-Body-Version auf V2.2. Stelle vorher sicher, dass dein Empfänger die neuen Felder verarbeiten kann.

👉 Vollständige Feldreferenz, kopierbares Beispiel und Migrationsschritte findest du im Webhook-Guide.