Gruppenmitglieder abrufen

Dieser Service Task ruft alle Benutzer ab, die einer bestimmten Gruppe zugeordnet sind.

Nutzen: Prozesse können automatisch alle Personen in einem Team oder einer Abteilung ermitteln — Benachrichtigungen an alle Vertriebsmitarbeiter senden, Aufgaben an Supportmitarbeiter verteilen oder Teammitglieder für Kapazitätsplanung zählen.

Funktionsweise

Anhand einer Gruppen-ID werden alle Benutzerzuweisungen für diese Gruppe abgefragt und als Liste mit Benutzer-IDs und Anzeigenamen zurückgegeben.

Eingabeparameter

Parameter	Typ	Pflicht	Beschreibung
`groupId`	String	Ja	Die ID der Gruppe, deren Mitglieder abgerufen werden sollen.

Beispiel-Eingabe

{
  "groupId": "sales"
}

Ausgabe

Feld	Typ	Beschreibung
`groupId`	String	Die Gruppen-ID (zurückgegeben).
`totalCount`	Zahl	Anzahl der Mitglieder in der Gruppe.
`members`	Array	Liste der Gruppenmitglieder.

Jedes Mitglied enthält:

Feld	Typ	Beschreibung
`userSub`	String	Die Cognito User-Sub (eindeutige Benutzer-ID).
`displayName`	String / null	Der Anzeigename des Benutzers, falls vorhanden.

Beispiel-Ausgabe

{
  "groupId": "sales",
  "totalCount": 2,
  "members": [
    { "userSub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "displayName": "Max Mustermann" },
    { "userSub": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "displayName": "Erika Muster" }
  ]
}

Anwendungsfälle

Massenbenachrichtigungen: Eine Nachricht oder E-Mail an alle Mitglieder einer Gruppe senden.
Aufgabenverteilung: Aufgaben im Round-Robin-Verfahren auf Gruppenmitglieder verteilen.
Kapazitätsprüfung: Mitglieder zählen, bevor Arbeit an ein Team geroutet wird.
Eskalation: Wenn eine Gruppe keine Mitglieder hat, an eine Fallback-Gruppe oder einen Manager eskalieren.

Hinweise

Hat die Gruppe keine Mitglieder, ist totalCount 0 und members ein leeres Array.
Der displayName kann null sein, wenn bei der Zuweisung kein Anzeigename gesetzt wurde.
Mit Alle Gruppen auflisten können verfügbare Gruppen-IDs ermittelt werden.