Zum Hauptinhalt springen

Wie du Ereignisse per Webhook empfängst

Statt alle paar Minuten nachzufragen, ob ein Meeting fertig ist, lässt du es dir von Sally sagen. Ein Webhook schickt einen POST-Request an deine URL, sobald eine Zusammenfassung fertig ist. Das ist der Unterschied zwischen einer Anbindung, die sofort wirkt, und einer, die sich wie ein nächtlicher Lauf anfühlt.

Vorher lesen

Lies zuerst den Schnellstart und Zusammenfassungen abrufen.

Schnellnavigation

  1. Webhook registrieren
  2. Die Ereignisse
  3. Persönlich oder unternehmensweit
  4. Auf deiner Seite

1. Webhook registrieren​

POST /v1.0/directories/{directoryId}/webhooks

{ "url": "https://example.com/hooks/sally", "event": "summary.ready", "name": "CRM-Sync" }

Referenz: POST/v1.0/directories/{directoryId}/webhooks

2. Die Ereignisse​

  • summary.ready feuert nach jeder Zusammenfassung. Das ist der Standard und meist genau das, was du willst.
  • manual feuert nie von selbst. Eine Person startet es aus einem Meeting oder einer Aufnahme heraus. Das lohnt sich, wenn jemand entscheiden soll, was verschickt wird.

Webhooks aus der Zeit vor dem heutigen Modell melden möglicherweise noch die älteren Ereignisse recording.summarized oder meeting.summarized. Sie bleiben lesbar, lassen sich aber nicht mehr neu setzen.

3. Persönlich oder unternehmensweit​

Standardmäßig ist ein Webhook persönlich und feuert nur für deine eigenen Aufnahmen. Mit "directoryWide": true feuert er für die Aufnahmen aller Nutzer des Unternehmenskontos. Unternehmensweite Webhooks dürfen nur Admins und Owner anlegen.

4. Auf deiner Seite​

  • Antworte schnell mit 2xx und erledige die eigentliche Arbeit danach, damit eine langsame Verarbeitung die Zustellung nicht blockiert.
  • Bau deinen Empfänger idempotent, mit der Id der Zusammenfassung als Schlüssel, damit eine wiederholte Zustellung keinen Schaden anrichtet.
  • Die Nutzlast enthält die Zusammenfassung mit ihren Abschnittseinträgen, in derselben Form wie in Zusammenfassungen abrufen. Ein Parser reicht also für beide Wege.
Empfehlung

Während du deinen Endpunkt umbaust, deaktiviere den Webhook, statt ihn zu löschen, und aktiviere ihn danach wieder.

Wie du Webhooks ohne Code direkt in der Sally-App einrichtest, zeigt die Anleitung zur Webhook-Integration.