28.05.2026 - Webhook V2.2

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.