Gruppen und Mitglieder über die API verwalten
Die Demodesk API v2 kann jetzt Ihre Unternehmensgruppen auflisten, anlegen, umbenennen, anpassen und löschen sowie Teammitglieder zu eingeschränkten Gruppen hinzufügen oder daraus entfernen.
Gruppen in der API
Ihre Gruppen sind jetzt Teil der Demodesk API v2. Sie können sie auflisten, eine einzelne Gruppe abrufen, eine Gruppe anlegen, umbenennen, ihre Sichtbarkeit und den Zugriff auf Aufzeichnungen ändern und sie löschen. Listen kommen nach Namen sortiert zurück, in Seiten mit bis zu 100 Einträgen, und Sie können nach dem Namen suchen. Jede Gruppe nennt ihre Sichtbarkeit, ob es sich um die Standardgruppe Allgemein handelt, ihre Einstellung unter Zugriff auf Aufzeichnungen und die Gruppen, deren Aufzeichnungen ihre Mitglieder sehen.
Teammitglieder hinzufügen und entfernen
Eingeschränkte Gruppen können über die API Mitglieder erhalten und verlieren. Wenn Sie jemanden hinzufügen, der bereits Mitglied ist, oder jemanden entfernen, der es nicht ist, ändert sich nichts und die Anfrage ist trotzdem erfolgreich. So können Sie denselben Abgleich beliebig oft laufen lassen. Geteilte Gruppen enthalten bereits jedes Teammitglied Ihres Unternehmens, deshalb werden Mitgliedschaftsanfragen für sie mit einem Fehler beantwortet. Wenn Sie ein Teammitglied aus einer Gruppe entfernen, wird es auch aus den Meetingtypen dieser Gruppe entfernt, genau wie unter Einstellungen > Unternehmen > Gruppen.
Wer was darf
Anfragen nutzen den API-Schlüssel einer Person und richten sich danach, was diese Person in Demodesk darf. Die API zeigt also nur die Gruppen, die diese Person ohnehin sieht. Unternehmens-Admins sehen jede Gruppe des Unternehmens und können alle verwalten, und das Anlegen einer neuen Gruppe ist Admins vorbehalten. Ein Manager kann mit den Gruppen arbeiten, denen er angehört, einschließlich Umbenennen, Mitgliedschaft und Löschen. Nur ein Unternehmens-Admin kann Sichtbarkeit oder Zugriff auf Aufzeichnungen ändern.
Gut zu wissen
Die Standardgruppe Allgemein lässt sich über die API weder ändern noch löschen, und Gruppennamen müssen innerhalb Ihres Unternehmens eindeutig sein. Beim Löschen einer Gruppe wandern ihre Meetingtypen und Playbooks nach Allgemein. Ihren API-Schlüssel finden Sie unter Einstellungen > Integrationen > Verknüpfungen im Abschnitt Demodesk API. Wie Gruppen den Zugriff auf Aufzeichnungen steuern, lesen Sie unter Gruppenbasierter Zugriff auf Aufzeichnungen. Die neuen Endpunkte finden Sie in der API-Referenz (Englisch).