Zum Hauptinhalt springen

Wie du deinen ersten Aufruf an die Sally API machst

Dieser Schnellstart bringt dich von null zur Zusammenfassung eines echten Meetings, in vier Aufrufen. Jeder Befehl funktioniert so, wie er dasteht, sobald dein eigenes Token eingesetzt ist.

Du brauchst ein Sally-Konto mit Zugang zu mindestens einem Unternehmenskonto und ein Meeting, das Sally bereits zusammengefasst hat. Eine App-Registrierung oder Freigabe ist nicht nötig.

Schnellnavigation

  1. Token anlegen
  2. Unternehmenskonto finden
  3. Aufnahmen auflisten
  4. Zusammenfassung lesen
  5. Bevor du darauf aufbaust

1. Token anlegen​

Öffne in Sally die Einstellungen, wähle unter Konfiguration die Integrationen und wechsle in den Reiter Personal Access Token. Lege ein Token an und kopiere es sofort.

Das Token beginnt mit sally_user_api_. Es gehört dir und handelt mit deinen Rechten: Es erreicht genau die Unternehmenskonten, in denen du Mitglied bist, und sieht genau das, was du auch in der App siehst. Leg es in einer Umgebungsvariable ab:

export SALLY_TOKEN="sally_user_api_…"

2. Unternehmenskonto finden​

Fast jeder Pfad braucht eine directoryId, die Id des Sally-Unternehmenskontos, zu dem die Daten gehören. Dieser Aufruf listet die Unternehmenskonten, die dein Token ansprechen darf:

curl "https://api.sally.io/v1.0/me/directories/memberships" \
  -H "Authorization: Bearer $SALLY_TOKEN"

Kopiere die directoryId, mit der du arbeiten willst:

export DIRECTORY_ID="…"

Referenz: GET/v1.0/me/directories/memberships

3. Aufnahmen auflisten​

Je aufgezeichnetem Meeting gibt es eine Aufnahme. Frag nur die Felder ab, die du brauchst, dann bleibt die Antwort klein:

curl "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/recordings?pageSize=5&fields=recordingId,name,createdOn" \
  -H "Authorization: Bearer $SALLY_TOKEN"

Kopiere die recordingId eines Meetings, das schon eine Zusammenfassung hat:

export RECORDING_ID="…"

Referenz: GET/v1.0/directories/{directoryId}/recordings

4. Zusammenfassung lesen​

Hänge includeDetails=true an, dann bekommst du auch die Abschnittseinträge deines Meetingtemplates. Ohne den Parameter kommt nur der Zusammenfassungstext.

curl "https://api.sally.io/v1.0/directories/$DIRECTORY_ID/recordings/$RECORDING_ID/summaries?includeDetails=true" \
  -H "Authorization: Bearer $SALLY_TOKEN"

Referenz: GET/v1.0/directories/{directoryId}/recordings/{recordingId}/summaries

5. Bevor du darauf aufbaust​

Wichtig

Eine Aufnahme kann mehrere Zusammenfassungen haben, je Sprache eine. Identifiziere eine Zusammenfassung deshalb immer über die Aufnahme zusammen mit ihrem languageCode, nie über die Aufnahme allein. Warum das so ist und warum dasselbe Meeting mehrfach als Termin auftauchen kann, erklärt Termine, Aufnahmen und Zusammenfassungen.

Von hier aus wählst du die Anleitung zu dem, was du baust: