Wie Termine, Aufnahmen und Zusammenfassungen zusammenhängen

Wenn du nur eine Grundlagen-Seite liest, dann diese. Termine, Aufnahmen und Zusammenfassungen sehen austauschbar aus, sind aber unterschiedlich geschnitten, und genau an diesem Unterschied gehen die meisten Anbindungen schief.

Schnellnavigation

1. Einen Termin gibt es je Person
2. Eine Aufnahme gibt es einmal
3. Eine Zusammenfassung gibt es je Sprache
4. Was das in der Praxis heißt
5. Alle Entitäten im Überblick

1. Einen Termin gibt es je Person

Jeder Teilnehmer desselben echten Meetings hat seinen eigenen Termin-Datensatz. Ein Meeting mit sechs Personen kann innerhalb eines Unternehmenskontos also bis zu sechsmal auftauchen, mit gleichem Betreff und gleicher Zeit.

Wichtig

Betreff plus Zeit ist keine Identität. Wer Termine zählt, zählt keine Meetings, und wer nach Betreff gruppiert, wirft zusammen, was nicht zusammengehört. Wenn du das Meeting brauchst, geh über die Aufnahme.

2. Eine Aufnahme gibt es einmal

Je aufgezeichnetem Meeting gibt es innerhalb eines Unternehmenskontos genau eine Aufnahme, egal wie viele Personen dabei waren. Damit ist die Aufnahme der stabile Anker: Sie speicherst du, auf ihr entdoppelst du, über sie verknüpfst du.

3. Eine Zusammenfassung gibt es je Sprache

Eine Zusammenfassung gehört zu genau einer Aufnahme, und eine Aufnahme kann mehrere Zusammenfassungen haben, je Sprache eine. Eindeutig ist eine Zusammenfassung erst über Aufnahme und languageCode. Wenn du eine bestimmte willst, nutze beides.

4. Was das in der Praxis heißt

• Speichere die recordingId als Fremdschlüssel, nicht den Termin.
• Wenn du einem Nutzer ein Meeting zeigst, nimm den Termin dieses Nutzers, denn er trägt dessen Sicht auf das Meeting.
• Wenn du Zusammenfassungen importierst, lauf über Aufnahmen und wähle die gewünschte Sprache, statt über Termine zu laufen und dasselbe Meeting mehrfach zu importieren.

Beispiel

Sechs Kollegen sitzen im selben Wochenmeeting. Im Unternehmenskonto liegen sechs Termine, eine Aufnahme und, wenn es Zusammenfassungen auf Deutsch und Englisch gibt, zwei Zusammenfassungen. Ein Import, der auf den Termin schlüsselt, legt für ein Meeting sechs Einträge an.

5. Alle Entitäten im Überblick

Die meisten Ressourcen liegen unter einem Unternehmenskonto: /v1.0/directories/{directoryId}/….

Entität	Was sie ist
Directory	Ein Sally-Unternehmenskonto und die oberste Ebene. Jede andere Ressource gehört zu genau einem Directory.
User / Membership	Eine Person und die Verbindung eines Nutzers mit einem Unternehmenskonto, samt Rolle und Lizenz.
Role / License	Nachschlagelisten, auf die eine Mitgliedschaft verweist.
Team	Eine benannte Gruppe von Nutzern in einem Unternehmenskonto.
Appointment	Ein Kalendertermin mit seinen Teilnehmern, einmal je Nutzer gespeichert.
Recording	Eine Audio- oder Videoaufnahme eines Meetings samt Transkript.
Recording summary	Die KI-Zusammenfassung einer Aufnahme, eine je Sprache, aufgebaut aus Abschnittseinträgen.
Meeting template	Legt die Abschnitte fest, in die eine Zusammenfassung gegliedert wird (nur lesend).
Folder / Tag	Ordnen Aufnahmen in einem Baum und kennzeichnen Termine und Aufnahmen.
Task	Eine Aufgabe, oft aus einem Meeting abgeleitet.
Vocabulary	Begriffe, die die Transkription verbessern.
Webhook	Ein ausgehendes Abonnement, das Ereignisse an deine URL schickt.
File	Ein binärer Inhalt wie ein Profilbild, per Id abrufbar.