Zum Hauptinhalt springen

Wie du Sally-Aufgaben mit deinem System synchronisierst

Sally leitet Aufgaben aus deinen Gesprächen ab. Diese Anleitung zeigt, wie du sie in das System bringst, mit dem dein Team wirklich arbeitet, und wie du zurückmeldest, wenn eine Aufgabe erledigt ist.

Vorher lesen

Lies zuerst den Schnellstart.

Schnellnavigation

  1. Aufgaben lesen
  2. Aufgaben anlegen und ändern
  3. Erledigt ist nicht abgebrochen

1. Aufgaben lesen​

Der Listen-Endpunkt nimmt eine filter-Voreinstellung, die Umfang und Zustand kombiniert: my… umfasst deine eigenen Aufgaben, all… alle Aufgaben des Unternehmenskontos, die du sehen darfst. Der Zustand ist Tasks (alle), Open, Overdue, Completed oder Forwarded, zum Beispiel myOpen oder allOverdue. Die all…-Varianten sind Admins und Ownern vorbehalten.

GET /v1.0/directories/{directoryId}/tasks?filter=myOpen

Der Such-Endpunkt durchsucht Betreff und Beschreibung und filtert nach status (open, completed, overdue, canceled) und verantwortlicher Person:

POST /v1.0/directories/{directoryId}/tasks/search

{ "search": "Angebot", "status": "overdue" }

Eine Aufgabe weiß, woher sie kommt: recordingSummaryId und appointmentId zeigen zurück auf das Meeting. Damit kannst du in deinem Tool den Meeting-Zusammenhang neben die Aufgabe stellen.

2. Aufgaben anlegen und ändern​

  • Anlegen mit einem subject und optional description, responsibleUserId und dueDate.
  • Ändern per PATCH. Geändert werden nur die Felder, die du mitschickst.
  • Erledigen oder wieder öffnen über einen eigenen Aufruf mit { "isDone": true } oder { "isDone": false }, damit ein Abschluss immer eindeutig ist.
POST /v1.0/directories/{directoryId}/tasks/{taskId}/done

{ "isDone": true }

3. Erledigt ist nicht abgebrochen​

Das heißt

isDone mit doneOn heißt erledigt, isCanceled mit canceledOn heißt verworfen. Eine Aufgabe, die keines von beidem ist, ist noch offen. Wenn du beides in deinem System auf einen gemeinsamen Zustand „geschlossen" abbildest, geht dieser Unterschied verloren.