Zum Hauptinhalt springen

Sally API

Alles, was Sally von einem Meeting mitbekommt, steht über die Sally Public API bereit: die Aufnahme und ihr Transkript, die KI-Zusammenfassung aufgeteilt in die Abschnitte deines Meetingtemplates, die Aufgaben aus dem Gespräch und die Personen, die dabei waren.

Diese Seite zeigt, was du damit bauen kannst, wie jede Anfrage aussieht und welche Seite du als Nächstes liest. Wenn du schon ein Token hast, bringt dich der Schnellstart in vier Aufrufen zur ersten Zusammenfassung.

Schnellnavigation

  1. Was du bauen kannst
  2. Wie eine Anfrage aussieht
  3. Wie es weitergeht

1. Was du bauen kannst​

  • Zusammenfassungen dort, wo gearbeitet wird. Hol jede neue Zusammenfassung in dein CRM, dein Wiki oder dein Ticketsystem, damit niemand Sally öffnen muss, um zu erfahren, was entschieden wurde.
  • Eine Reaktion, sobald ein Meeting durch ist. Ein Webhook meldet sich, wenn eine Zusammenfassung fertig ist, und dein System startet, was danach passieren soll.
  • Aufnahmen aus anderen Systemen. Gib Sally eine Audio- oder Videodatei und bekomme Transkript und Zusammenfassung zurück.
  • Aufgaben in deinem eigenen Tool. Gleiche die Aufgaben, die Sally erkannt hat, mit deinem Aufgabensystem ab.

2. Wie eine Anfrage aussieht​

Die Basis-URL ist https://api.sally.io, und jeder Pfad beginnt mit dem Versions-Präfix /v1.0. Anfragen und Antworten sind JSON. Ids sind kleingeschriebene UUIDs, Feldnamen sind camelCase, und ein Feld, das leer sein kann, kommt als null zurück, statt zu verschwinden.

Fast alles gehört zu einem Directory, dem Sally-Unternehmenskonto, dem die Daten gehören: /v1.0/directories/{directoryId}/…. Deshalb fragt dein erster Aufruf meist, welche Unternehmenskonten dein Token ansprechen darf:

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

Alles in dieser Dokumentation bezieht sich auf Version 1.0. Sie wird noch aktiv weiterentwickelt und ist noch nicht eingefroren, siehe Versionierung.

3. Wie es weitergeht​

Schnellstart

Token anlegen und die Zusammenfassung eines echten Meetings in vier Aufrufen abrufen.

Authentifizierung

Persönliche Zugangstokens, OAuth und was ein Token sehen darf.

Anleitungen

Schritt für Schritt zu Zusammenfassungen, Transkripten, Uploads, Aufgaben, Webhooks und Ordnern.

Grundlagen

Wie Termine, Aufnahmen und Zusammenfassungen zusammenhängen, dazu Paginierung, Felder, Datum und Fehler.

Referenz

Jeder Endpunkt mit Parametern, Feldern und Anfragebeispielen.

Release Notes

Was sich an der API geändert hat, neueste zuerst, und was du tun musst.