Diese Seite wurde von der Cloud Translation API übersetzt.

Slack

Integrationsversion: 23.0

Slack für die Verwendung mit Google Security Operations konfigurieren

Um Slack für die Verwendung mit Google SecOps zu konfigurieren, müssen Sie zuerst eine neue App erstellen:

Rufen Sie https://api.slack.com/ auf und klicken Sie auf Start Building (Mit dem Entwickeln beginnen).
Geben Sie die Parameter App Name (App-Name) und Development Slack Workspace (Slack-Entwicklerarbeitsbereich) ein. Klicken Sie auf App erstellen.
Rufen Sie den Tab OAuth & Berechtigungen auf und scrollen Sie nach unten zu den Abschnitten Bereiche.
Fügen Sie die folgenden Bereiche/Berechtigungen hinzu. Slack empfiehlt, OAuth-Token-Bereiche für einen Bot hinzuzufügen, nicht Nutzerberechtigungen:
- channels:history
- channels:manage
- channels:read
- chat:write
- files:write
- groups:history
- groups:write
- groups:read
- im:read
- im:write
- im:history
- mpim:read
- mpim:history
- mpim:write
- users:read
- users:read.email
Hinweis :Wenn Sie Bereiche hinzufügen oder entfernen, müssen OAuth-Tokens neu generiert werden.
Wenn Sie die Interaktivität von Apps für Aktionen wie „Interaktive Nachricht senden“ und „Mit Webhook auf Antwort warten“ zulassen möchten, fügen Sie eine Anfrage-URL für Ihre App hinzu. Weitere Informationen finden Sie in der Slack-Dokumentation im Dokument Handling user interaction in your Slack apps.
Scrollen Sie nach oben und klicken Sie auf App im Workspace installieren.
Klicken Sie auf Zulassen.
Kopieren Sie eines der erstellten Tokens, je nachdem, ob Sie einen Bot oder einen Nutzer verwenden möchten.
Konfigurieren Sie die Integration mit einem dieser Tokens.

Netzwerk

Funktion	Standardport	Richtung	Protokoll
API	Mehrfachwerte	Ausgehend	apitoken

Slack-Integration in Google SecOps konfigurieren

Eine detaillierte Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
Instanzname	String	–	Nein	Name der Instanz, für die Sie die Integration konfigurieren möchten.
Beschreibung	String	–	Nein	Beschreibung der Instanz.
API-Token	String	–	Ja	In der Slack-Konsole generiertes API-Token.
SSL überprüfen	Kästchen	Deaktiviert	Nein	Aktivieren Sie dieses Kästchen, wenn für Ihre Slack-Verbindung eine SSL-Überprüfung erforderlich ist (standardmäßig deaktiviert).
Remote ausführen	Kästchen	Deaktiviert	Nein	Aktivieren Sie das Feld, um die konfigurierte Integration remote auszuführen. Nachdem Sie das Kästchen angekreuzt haben, wird die Option zum Auswählen des Remote-Nutzers (Kundenservicemitarbeiters) angezeigt.

Aktionen

Frage stellen

Beschreibung

Frage in Slack stellen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanal	String	–	Ja	Zielkanal
Frage	String	–	Ja	Inhalt der Frage.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Build-Block

Beschreibung

Erstelle einen Slack-Nachrichtenblock basierend auf den bereitgestellten Eingabekriterien. Durch diese Aktion wird ein Block mit einem Webhook erstellt, der später an die Aktion „Interaktive Nachricht senden“ übergeben werden kann, um eine Nachricht zu senden.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Frage	String	–	Ja	Geben Sie den Fragetext an, der dem Block hinzugefügt werden soll.
Schaltflächen für Antworten	String	–	Ja	Geben Sie die Antwortschaltflächen an, die dem Block hinzugefügt werden sollen.
Siemplify-Basis-URL	String	–	Ja	Geben Sie die Basis-URL des Google SecOps-Servers an, die dem Block hinzugefügt werden soll.
Fall-ID	String	–	Ja	Geben Sie die Google SecOps-Fall-ID an, die dem Block hinzugefügt werden soll.
Webhook-Token-UUID	String	–	Ja	Geben Sie die UUID des Webhook-Tokens an, um die Antwort des Nutzers zu überwachen.

Beispiele für Anwendungsfälle von Playbooks

Erstellen Sie einen Block, der später an die Aktion „Erweiterte Nachricht senden“ übergeben werden kann, um eine Nachricht mit einem Block zu senden.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

{
  "result": "[{\"type\": \"section\", \"block_id\": \"f99958f1-c1f1-4fdb-bb8b-a382d952d5bd\", \"text\": {\"type\": \"mrkdwn\", \"text\": \"yes?\", \"verbatim\": false}},{\"type\": \"actions\", \"block_id\": \"2850e684-472a-472f-9a32-96294cbe9046\", \"elements\": [{\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"y\"}, \"action_id\": \"y\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"n\"}, \"action_id\": \"n\", \"url\": \"...\"}, {\"type\": \"button\", \"text\": {\"type\": \"plain_text\", \"text\": \"View Case in Siemplify\"}, \"action_id\": \"View Case in Siemplify\", \"url\": \"...\"}]}]"
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn ein Build-Block erfolgreich erstellt wurde (is_succeed=True): „Slack block was created successfully.“ (Slack-Block wurde erstellt.) Wenn ein Slack-Block aufgrund eines allgemeinen Fehlers nicht erstellt werden konnte (is_succeed=False): „Failed to create a block because of the occurred error: {0}“.format(error text) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn in der Integrationskonfiguration keine Webhook-basierte URL angegeben ist: „Die Ausführung der Aktion ist fehlgeschlagen. Geben Sie den Integrationsparameter ‚Webhook Base URL‘ an.“ Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn ein Build-Block erfolgreich erstellt wurde (is_succeed=True): „Slack block was created successfully.“ (Slack-Block wurde erstellt.)

Wenn ein Slack-Block aufgrund eines allgemeinen Fehlers nicht erstellt werden konnte (is_succeed=False): „Failed to create a block because of the occurred error: {0}“.format(error text)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn in der Integrationskonfiguration keine Webhook-basierte URL angegeben ist: „Die Ausführung der Aktion ist fehlgeschlagen. Geben Sie den Integrationsparameter ‚Webhook Base URL‘ an.“

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)

Allgemein

Kanal erstellen

Beschreibung

Slack-Kanal erstellen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanalname	String	–	Ja	Geben Sie den Namen des Channels an. Hinweis:Kanalnamen dürfen nur Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten und dürfen maximal 80 Zeichen lang sein.
Nutzer-IDs	String	–	Ja	Geben Sie die IDs der Nutzer an, die in den neu erstellten Channel eingeladen werden sollen. Beispiel: U014JDHLW87, U08544ABC85.
Ist privat	Kästchen	Deaktiviert	Nein	Wenn diese Option aktiviert ist, wird durch die Aktion ein privater Channel erstellt.

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Kanalname

String

–

Geben Sie den Namen des Channels an.

Hinweis:Kanalnamen dürfen nur Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten und dürfen maximal 80 Zeichen lang sein.

Nutzer-IDs

String

–

Geben Sie die IDs der Nutzer an, die in den neu erstellten Channel eingeladen werden sollen.

Beispiel: U014JDHLW87, U08544ABC85.

Ist privat

Kästchen

Deaktiviert

Nein

Wenn diese Option aktiviert ist, wird durch die Aktion ein privater Channel erstellt.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

{
    "is_general": "False",
    "name_normalized": "12asd1237712318",
    "is_channel": "True",
    "creator": "U014J4NFQQG",
    "is_member": "True",
    "is_archived": "False",
    "topic": {
        "last_set": "0",
        "value": " ",
        "creator": " "
    },
    "parent_conversation": "None",
    "is_im": "False",
    "is_ext_shared": "False",
    "previous_names": [],
    "last_read": "0000000000.000000",
    "id": "C014S1G6DB4",
    "is_org_shared": "False",
    "pending_connected_team_ids": [],
    "is_pending_ext_shared": "False",
    "is_mpim": "False",
    "is_group": "False",
    "shared_team_ids": ["T013MJHSNCT"],
    "purpose": {
        "last_set": 0,
        "value": " ",
        "creator": " "
    },
    "is_private": "False",
    "is_shared": "False",
    "name": "12asd1237712318",
    "created": "1591194197",
    "pending_shared": [],
    "unlinked": 0,
    "priority": 0
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn „ok“ == „true“ und der Aktionsparameter „Private“ „false“ ist und der Parameter „User IDs“ leer ist (is_success=true): „Successfully created channel {0}“.format(name) Wenn „ok“ == true und der Aktionsparameter „Private“ auf „true“ gesetzt ist und der Parameter „User IDs“ leer ist (is_success=true): „Successfully created private channel {0}“.format(name) Wenn „ok“ == „true“ und der Aktionsparameter „Private“ auf „false“ gesetzt ist und Nutzer-IDs verfügbar sind („is_success“ = „true“): „Successfully created channel {0} and added {1} users“.format(name, user_ids) Wenn „ok“ == „true“ und der Aktionsparameter „Private“ auf „true“ gesetzt ist und Nutzer-IDs verfügbar sind („is_success“ = „true“): „Privater Kanal {0} wurde erstellt und {1} Nutzer wurden hinzugefügt.“format(name, user_ids) Wenn „ok“ == „false“. In der ersten Anfrage (is_success=false): „Kanal {0} konnte nicht erstellt werden. Grund: {1}".format(name, value of error parameter from response) Wenn „ok“ == false in der zweiten Anfrage (is_success=false): „Der Channel {0} wurde erstellt, aber Nutzer wurden nicht eingeladen. Grund: „.format(name, value of error parameter from response)“ Wenn „ok“ == false und error == „user_not_found“ (is_success=false): „Nutzer konnten dem Kanal {0} nicht hinzugefügt werden. Grund: {1} der angegebenen Nutzer-IDs ist in Slack nicht vorhanden“.format(name, len(errors) from the response) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein schwerwiegender Fehler (falsche Anmeldedaten, Verbindungsfehler, Absturz der Aktion) gemeldet wird: „Fehler beim Ausführen der Aktion ‚Kanal erstellen‘. Grund: {0}''.format(error.Stacktrace)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn „ok“ == „true“ und der Aktionsparameter „Private“ „false“ ist und der Parameter „User IDs“ leer ist (is_success=true):

„Successfully created channel {0}“.format(name)

Wenn „ok“ == true und der Aktionsparameter „Private“ auf „true“ gesetzt ist und der Parameter „User IDs“ leer ist (is_success=true): „Successfully created private channel {0}“.format(name)

Wenn „ok“ == „true“ und der Aktionsparameter „Private“ auf „false“ gesetzt ist und Nutzer-IDs verfügbar sind („is_success“ = „true“): „Successfully created channel {0} and added {1} users“.format(name, user_ids)

Wenn „ok“ == „true“ und der Aktionsparameter „Private“ auf „true“ gesetzt ist und Nutzer-IDs verfügbar sind („is_success“ = „true“):

„Privater Kanal {0} wurde erstellt und {1} Nutzer wurden hinzugefügt.“format(name, user_ids)

Wenn „ok“ == „false“. In der ersten Anfrage (is_success=false):

„Kanal {0} konnte nicht erstellt werden. Grund: {1}".format(name, value of error parameter from response)

Wenn „ok“ == false in der zweiten Anfrage (is_success=false):

„Der Channel {0} wurde erstellt, aber Nutzer wurden nicht eingeladen. Grund: „.format(name, value of error parameter from response)“

Wenn „ok“ == false und error == „user_not_found“ (is_success=false):

„Nutzer konnten dem Kanal {0} nicht hinzugefügt werden. Grund: {1} der angegebenen Nutzer-IDs ist in Slack nicht vorhanden“.format(name, len(errors) from the response)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler (falsche Anmeldedaten, Verbindungsfehler, Absturz der Aktion) gemeldet wird: „Fehler beim Ausführen der Aktion ‚Kanal erstellen‘. Grund: {0}''.format(error.Stacktrace)

Allgemein

Unterhaltungsverlauf für Kanal oder Nutzer abrufen

Beschreibung

Chatverlauf für einen Nutzer oder einen Channel basierend auf den angegebenen Eingabekriterien abrufen. Diese Aktion funktioniert entweder mit der Kanal- oder der Nutzer-ID, die mit den Aktionen „Kanäle auflisten“ oder „Nutzer auflisten“ gesucht werden kann.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanal- oder Nutzer-ID	String	–	Ja	Geben Sie die Kanal- oder Nutzer-ID an, für die der Chatverlauf abgerufen werden soll.
Zeitraum	DDL	Letzte Stunde Mögliche Werte: Letzte Stunde Letzte 6 Stunden Letzte 24 Stunden Letzte Woche Letzter Monat Benutzerdefiniert	Nein	Geben Sie einen Zeitraum für die Ergebnisse an. Wenn „Benutzerdefiniert“ ausgewählt ist, müssen Sie auch den Parameter „Startzeit“ angeben.
Beginn	String	–	Nein	Geben Sie die Startzeit für die Ergebnisse an. Dieser Parameter ist erforderlich, wenn für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist. Format: ISO 8601. Beispiel: 2021-08-05T05:18:42Z
Ende	String	–	Nein	Geben Sie die Endzeit für die Ergebnisse an. Wenn nichts angegeben ist und für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist, wird für diesen Parameter die aktuelle Zeit verwendet. Format: ISO 8601. Beispiel: 2021-08-05T05:18:42Z.
Maximale Anzahl zurückzugebender Datensätze	Ganzzahl	20	Nein	Geben Sie die Anzahl der zurückzugebenden Datensätze an. Wenn nichts angegeben wird, werden 20 Datensätze zurückgegeben.

Beispiele für Anwendungsfälle von Playbooks

Unterhaltungsverlauf abrufen, um Benachrichtigungen zu untersuchen

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

[
  {
    "bot_id": "B02D9QYM7P0",
    "type": "message",
    "text": "test",
    "user": "U02D1RPLVST",
    "ts": "1665988448.627219",
    "app_id": "A02DDGD942Z",
    "team": "T02CX3N6B0B",
    "bot_profile": {
      "id": "B02D9QYM7P0",
      "deleted": false,
      "name": "Siemplify-test",
      "updated": 1630908872,
      "app_id": "A02DDGD942Z",
      "icons": {
        "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
        "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
        "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
      },
      "team_id": "T02CX3N6B0B"
    },
    "blocks": [
      {
        "type": "rich_text",
        "block_id": "JbVUf",
        "elements": [
          {
            "type": "rich_text_section",
            "elements": [
              {
                "type": "text",
                "text": "test"
              }
            ]
          }
        ]
      }
    ]
  }
]

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn der Unterhaltungsverlauf gefunden wurde (is_succeed=True): „Conversation history was fetched successfully.“ (Der Unterhaltungsverlauf wurde abgerufen.) Wenn die Unterhaltung mit der angegebenen ID nicht gefunden wird (is_succeed=False): „Failed to find conversation for provided id {0}“.format(channel_or_user_id) Wenn die Unterhaltung mit der angegebenen ID gefunden wird und keine Nachrichten für den angegebenen Zeitraum gefunden werden (is_succeed=False): „Conversation with id {0} was found, but no messages were found for the provided time frame.“ (Unterhaltung mit der ID {0} wurde gefunden, aber für den angegebenen Zeitraum wurden keine Nachrichten gefunden.).format(channel_or_user_id) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace) Wenn ein ungültiger Wert für den Parameter „Max. zurückzugebende Datensätze“ angegeben wird: „Fehler beim Ausführen der Aktion {action name}. Grund: Für „Max. zurückzugebende Datensätze“ wurde ein ungültiger Wert angegeben: . Es muss eine positive Zahl angegeben werden.“ Wenn für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist und der Parameter „Startzeit“ nicht angegeben ist: „Fehler beim Ausführen der Aktion ‚{action name}‘. Grund: „Für den benutzerdefinierten Zeitraum wurde keine Startzeit angegeben.“	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn der Unterhaltungsverlauf gefunden wurde (is_succeed=True): „Conversation history was fetched successfully.“ (Der Unterhaltungsverlauf wurde abgerufen.)

Wenn die Unterhaltung mit der angegebenen ID nicht gefunden wird (is_succeed=False): „Failed to find conversation for provided id {0}“.format(channel_or_user_id)

Wenn die Unterhaltung mit der angegebenen ID gefunden wird und keine Nachrichten für den angegebenen Zeitraum gefunden werden (is_succeed=False): „Conversation with id {0} was found, but no messages were found for the provided time frame.“ (Unterhaltung mit der ID {0} wurde gefunden, aber für den angegebenen Zeitraum wurden keine Nachrichten gefunden.).format(channel_or_user_id)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)

Wenn ein ungültiger Wert für den Parameter „Max. zurückzugebende Datensätze“ angegeben wird: „Fehler beim Ausführen der Aktion {action name}. Grund: Für „Max. zurückzugebende Datensätze“ wurde ein ungültiger Wert angegeben: . Es muss eine positive Zahl angegeben werden.“

Wenn für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist und der Parameter „Startzeit“ nicht angegeben ist: „Fehler beim Ausführen der Aktion ‚{action name}‘. Grund: „Für den benutzerdefinierten Zeitraum wurde keine Startzeit angegeben.“

Allgemein

Nutzerdetails abrufen

Beschreibung

Slack-Nutzerdetails basierend auf den angegebenen Eingabekriterien abrufen.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Suchen nach	DDL	E-Mail Mögliche Werte: E-Mail Name ID	Ja	Geben Sie den Parameter an, nach dem Sie nach Nutzerdetails suchen möchten.
Nutzerwert	String	–	Ja	Geben Sie den Nutzerwert an, nach dem gesucht werden soll.

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Suchen nach

DDL

E-Mail

Mögliche Werte:

E-Mail
Name
ID

Geben Sie den Parameter an, nach dem Sie nach Nutzerdetails suchen möchten.

Nutzerwert

String

–

Geben Sie den Nutzerwert an, nach dem gesucht werden soll.

Beispiele für Anwendungsfälle von Playbooks

Nutzerdetails abrufen, um die Verarbeitung von Benachrichtigungen in Google SecOps zu optimieren.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

{
  "id": "U043FPEMATG",
  "team_id": "T02CX3N6B0B",
  "name": "example.user",
  "deleted": false,
  "color": "3c989f",
  "real_name": "Example User",
  "tz": "Europe/Europe",
  "tz_label": "Central European Summer Time",
  "tz_offset": 7200,
  "profile": {
    "title": "",
    "phone": "",
    "skype": "",
    "real_name": "Example User",
    "real_name_normalized": "Example User",
    "display_name": "Example User",
    "display_name_normalized": "Example User",
    "fields": null,
    "status_text": "",
    "status_emoji": "",
    "status_emoji_display_info": [],
    "status_expiration": 0,
    "avatar_hash": "gc297456197c",
    "email": "example.user@example.com",
    "first_name": "Example",
    "last_name": "User",
    "image_24": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-24.png",
    "image_32": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-32.png",
    "image_48": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-48.png",
    "image_72": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-72.png",
    "image_192": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-192.png",
    "image_512": "https://secure.gravatar.com/avatar/c297456197c0de7baa8c4b9a2398ecd1.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0011-512.png",
    "status_text_canonical": "",
    "team": "T02CX3N6B0B"
  },
  "is_admin": false,
  "is_owner": false,
  "is_primary_owner": false,
  "is_restricted": false,
  "is_ultra_restricted": false,
  "is_bot": false,
  "is_app_user": false,
  "updated": 1663939355,
  "is_email_confirmed": true,
  "who_can_share_contact_card": "EVERYONE"
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung\*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn Nutzerdetails gefunden wurden (is_succeed=True): „Nutzerdetails wurden abgerufen.“ Wenn anhand der angegebenen Kriterien keine Nutzerdetails gefunden werden (is_succeed=False): „Failed to find user details based on the provided criteria: Search by: <0> User value: <1>“.format(search_by, user_value) Wenn Nutzerdetails anhand des Namens gefunden werden und mehr als eine Übereinstimmung gefunden wird (is_succeed=True): „Für die angegebenen Suchkriterien wurden mehrere Übereinstimmungen gefunden: Suche nach: <0> Nutzerwert: <1>“.format(search_by, user_value) Wenn der Nutzer aufgrund eines allgemeinen Fehlers nicht gefunden wird (is_succeed=False): „Failed to fetch user details because of occurred error: (0}“ (Fehlertext) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)	Allgemein
Tabelle „Fall-Repository“	Tabellenname:Slack-Nutzerdetails Tabellenspalten: ID Team-ID Name Richtiger Name Anzeigename Vorname Nachname Aktualisiert am Zeitzone Titel Telefon Ist Administrator Ist Inhaber Ist primärer Inhaber Eingeschränkt Ist Ultra-eingeschränkt Is Bot Ist App-Nutzer E-Mail-Adresse bestätigt	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung\*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn Nutzerdetails gefunden wurden (is_succeed=True): „Nutzerdetails wurden abgerufen.“

Wenn anhand der angegebenen Kriterien keine Nutzerdetails gefunden werden (is_succeed=False): „Failed to find user details based on the provided criteria: Search by: <0> User value: <1>“.format(search_by, user_value)

Wenn Nutzerdetails anhand des Namens gefunden werden und mehr als eine Übereinstimmung gefunden wird (is_succeed=True): „Für die angegebenen Suchkriterien wurden mehrere Übereinstimmungen gefunden: Suche nach: <0> Nutzerwert: <1>“.format(search_by, user_value)

Wenn der Nutzer aufgrund eines allgemeinen Fehlers nicht gefunden wird (is_succeed=False): „Failed to fetch user details because of occurred error: (0}“ (Fehlertext)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Allgemein

Tabelle „Fall-Repository“

Tabellenname:Slack-Nutzerdetails

Tabellenspalten:

ID
Team-ID
Name
Richtiger Name
Anzeigename
Vorname
Nachname
Aktualisiert am
Zeitzone
Titel
Telefon
Ist Administrator
Ist Inhaber
Ist primärer Inhaber
Eingeschränkt
Ist Ultra-eingeschränkt
Is Bot
Ist App-Nutzer
E-Mail-Adresse bestätigt

Allgemein

Nutzerdetails nach ID abrufen

Beschreibung

Nutzerdetails anhand der ID abrufen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Nutzer-ID	String	–	Ja	Die ID des Nutzers.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Kanäle auflisten

Beschreibung

Rufen Sie eine Liste von Slack-Kanälen ab.

Parameter

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

[
    {
        "is_org_shared": false,
        "is_general": true,
        "name_normalized": "general",
        "name": "general",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Company-wide announcements and work-based matters",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "This channel is for workspace-wide communication and announcements. All members are in this channel.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRB4ZHGNR",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "random",
        "name": "random",
        "is_channel": true,
        "created": 1575550599,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 1575550599,
            "value": "Non-work banter and water cooler conversation",
            "creator": "URALP6WRJ"
        },
        "num_members": 1,
        "purpose": {
            "last_set": 1575550599,
            "value": "A place for non-work-related flimflam, faffing, hodge-podge or jibber-jabber you'd prefer to keep out of more focused work-related channels.",
            "creator": "URALP6WRJ"
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRD0KF9T9",
        "is_private": false,
        "previous_names": []
    }, {
        "is_org_shared": false,
        "is_general": false,
        "name_normalized": "website",
        "name": "website",
        "is_channel": true,
        "created": 1575550600,
        "is_member": true,
        "is_mpim": false,
        "is_archived": false,
        "creator": "URALP6WRJ",
        "topic": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "num_members": 1,
        "purpose": {
            "last_set": 0,
            "value": " ",
            "creator": " "
        },
        "members": ["URALP6WRJ"],
        "unlinked": 0,
        "is_shared": false,
        "id": "CRDAUBZP0",
        "is_private": false,
        "previous_names": []
    }
]

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn „ok“ == false (is_success=false): „Failed to list channels. Grund: {0}".format(value of error parameter from response)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn „ok“ == false (is_success=false): „Failed to list channels. Grund: {0}".format(value of error parameter from response)

Allgemein

Nutzer auflisten

Beschreibung

Diese Aktion dient dazu, eine Liste von Slack-Nutzern abzurufen.

Parameter

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

[
    {
        "profile": {
            "status_text": " ",
            "display_name": " ",
            "status_emoji": " ",
            "title": " ",
            "status_text_canonical": " ",
            "team": "TRALP6VNY",
            "real_name": "somerealname",
            "image_24": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=24&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-24.png",
            "phone": " ",
            "real_name_normalized": "somerealnamen",
            "image_512": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=512&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-512.png",
            "image_72": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=72&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-72.png",
            "image_32": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=32&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-32.png",
            "image_48": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=48&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-48.png",
            "skype": " ",
            "avatar_hash": "g2d62053d7f7",
            "display_name_normalized": " ",
            "status_expiration": 0,
            "email": "mail@seimplify.co",
            "image_192": "https://secure.gravatar.com/avatar/2d62053d7f735bc096de59639eb8f350.jpg?s=192&d=https%3A%2F%2Fa.slack-edge.com%2Fdf10d%2Fimg%2Favatars%2Fava_0022-192.png"
        },
        "updated": 1575550598,
        "tz": "Europe/Moscow",
        "name": "name",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Moscow Time",
        "real_name": "realname",
        "color": "9f69e7",
        "team_id": "TRALP6VNY",
        "is_admin": true,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": true,
        "tz_offset": 14400,
        "has_2fa": false,
        "id": "URALP6WRJ",
        "is_primary_owner": true
    }, {
        "profile": {
            "last_name": " ",
            "status_emoji": " ",
            "display_name_normalized": "Slackbot",
            "image_32": "https://a.slack-edge.com/80588/img/slackbot_32.png",
            "skype": " ",
            "image_72": "https://a.slack-edge.com/80588/img/slackbot_72.png",
            "status_expiration": 0,
            "image_192": "https://a.slack-edge.com/80588/marketing/img/avatars/slackbot/avatar-slackbot.png",
            "first_name": "slackbot",
            "display_name": "Slackbot",
            "title": " ",
            "real_name_normalized": "Slackbot",
            "always_active": true,
            "status_text_canonical": " ",
            "image_24": "https://a.slack-edge.com/80588/img/slackbot_24.png",
            "phone": " ",
            "image_48": "https://a.slack-edge.com/80588/img/slackbot_48.png",
            "fields": null,
            "real_name": "Slackbot",
            "image_512": "https://a.slack-edge.com/80588/img/slackbot_512.png",
            "team": "TRALP6VNY",
            "avatar_hash": "sv41d8cd98f0",
            "status_text": " "
        },
        "updated": 0,
        "tz": null,
        "name": "slackbot",
        "deleted": false,
        "is_app_user": false,
        "is_bot": false,
        "tz_label": "Pacific Standard Time",
        "real_name": "Slackbot",
        "color": "757575",
        "team_id": "TRALP6VNY",
        "is_admin": false,
        "is_ultra_restricted": false,
        "is_restricted": false,
        "is_owner": false,
        "tz_offset": -28800,
        "id": "USLACKBOT",
        "is_primary_owner": false
    }
]

Ping

Beschreibung

Verbindung testen

Parameter

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Kanal umbenennen

Beschreibung

Slack-Kanal umbenennen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanalname	String	–	Nein	Geben Sie den Namen des Kanals an, den Sie umbenennen möchten. Hinweis:Wenn sowohl der Parameter „Channel Name“ als auch „Channel ID“ angegeben ist, funktioniert die Aktion nur mit der ID.
Kanal-ID	String	–	Nein	Geben Sie die ID des Kanals an, den Sie umbenennen möchten. Hinweis:Wenn sowohl der Parameter „Channel Name“ als auch „Channel ID“ angegeben ist, funktioniert die Aktion nur mit der ID.
Neuer Name	String	–	Ja	Geben Sie einen neuen Namen für den Channel an. Hinweis:Kanalnamen dürfen nur Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten und dürfen maximal 80 Zeichen lang sein.

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Kanalname

String

–

Nein

Geben Sie den Namen des Kanals an, den Sie umbenennen möchten.

Hinweis:Wenn sowohl der Parameter „Channel Name“ als auch „Channel ID“ angegeben ist, funktioniert die Aktion nur mit der ID.

Kanal-ID

String

–

Nein

Geben Sie die ID des Kanals an, den Sie umbenennen möchten.

Hinweis:Wenn sowohl der Parameter „Channel Name“ als auch „Channel ID“ angegeben ist, funktioniert die Aktion nur mit der ID.

Neuer Name

String

–

Geben Sie einen neuen Namen für den Channel an.

Hinweis:Kanalnamen dürfen nur Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche enthalten und dürfen maximal 80 Zeichen lang sein.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

Wenn „ok“ == „true“:

{
    "channel": {
        "id": "C013ELA1YVC",
        "name": "project_old",
        "is_channel": true,
        "is_group": false,
        "is_im": false,
        "created": 1589444943,
        "is_archived": false,
        "is_general": false,
        "unlinked": 0,
        "name_normalized": "project_old",
        "is_shared": false,
        "parent_conversation": null,
        "creator": "U0136KZ0P5M",
        "is_ext_shared": false,
        "is_org_shared": false,
        "shared_team_ids": [
            "T013MJHSNCT"
        ],
        "pending_shared": [],
        "pending_connected_team_ids": [],
        "is_pending_ext_shared": false,
        "is_member": true,
        "is_private": false,
        "is_mpim": false,
        "last_read": "1595242486.000300",
        "topic": {
            "value": "",
            "creator": "",
            "last_set": 0
        },
        "purpose": {
            "value": "This *channel* is for working on a project. Hold meetings, share docs, and make decisions together with your team.",
            "creator": "U0136KZ0P5M",
            "last_set": 1589444943
        },
        "previous_names": [
            "project_new",
            "project"
        ]
    },
    "ok": true,
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}

Wenn „ok“ == „false“:

{
    "ok": false,
    "error": "name_taken",
    "warning": "missing_charset",
    "response_metadata": {
        "warnings": [
            "missing_charset"
        ]
    }
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn „ok“ == true (is_success=true): „Successfully renamed channel {0} to {1} {0}“.format(name/ID, new name) If "ok"== false (is_success=false): "Action wasn't able to rename channel {0}. Grund: {1}".format(name,error from the response) Wenn der Kanal nicht anhand des Kanalnamens gefunden wurde (is_success=false): „Die Aktion konnte den Kanal {0} nicht umbenennen. Grund: Der Kanal wurde nicht gefunden.“format(name) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein schwerwiegender Fehler gemeldet wird (falsche Anmeldedaten, Verbindungsfehler, Absturz der Aktion): „Fehler beim Ausführen der Aktion ‚Kanal umbenennen‘. Grund: {0}''.format(error.Stacktrace) Wenn die Parameter „Channel Name“ (Kanalname) und „Channel ID“ (Kanal-ID) nicht angegeben sind: „Error executing action ‚Rename Channel‘.“ (Fehler beim Ausführen der Aktion „Rename Channel“ (Kanal umbenennen)). Grund: Sie müssen den „Kanalnamen“ oder die „Kanal-ID“ angeben.“	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn „ok“ == true (is_success=true): „Successfully renamed channel {0} to {1} {0}“.format(name/ID, new name)

If "ok"== false (is_success=false): "Action wasn't able to rename channel {0}. Grund: {1}".format(name,error from the response)

Wenn der Kanal nicht anhand des Kanalnamens gefunden wurde (is_success=false): „Die Aktion konnte den Kanal {0} nicht umbenennen. Grund: Der Kanal wurde nicht gefunden.“format(name)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein schwerwiegender Fehler gemeldet wird (falsche Anmeldedaten, Verbindungsfehler, Absturz der Aktion): „Fehler beim Ausführen der Aktion ‚Kanal umbenennen‘. Grund: {0}''.format(error.Stacktrace)

Wenn die Parameter „Channel Name“ (Kanalname) und „Channel ID“ (Kanal-ID) nicht angegeben sind: „Error executing action ‚Rename Channel‘.“ (Fehler beim Ausführen der Aktion „Rename Channel“ (Kanal umbenennen)). Grund: Sie müssen den „Kanalnamen“ oder die „Kanal-ID“ angeben.“

Allgemein

Erweiterte Nachricht senden

Beschreibung

Erweiterte Nachricht an einen Slack-Kanal oder ‑Nutzer senden Mit dieser Aktion können Sie einfache Textnachrichten und umfangreiche Slack-Blocknachrichten mit Schaltflächen, erweiterter Formatierung und mehr senden. Weitere Informationen zu Blocknachrichten finden Sie unter Slack Block Kit .

Diese Aktion kann zusammen mit der Aktion „Wait for Reply With Webhook“ verwendet werden, um zuerst eine Blocknachricht mit einem Webhook an einen Nutzer zu senden und später mit der Aktion „Wait for Reply With Webhook“ nach der Antwort des Nutzers zu suchen.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Art der Nachricht	DDL	Text Mögliche Werte: Text Blockieren	Ja	Geben Sie den Typ der zu sendenden Nachricht an.
Empfängertyp	DDL	Name Mögliche Werte: Name ID E-Mail	Ja	Geben Sie den Kanal- oder Nutzernamen (vollständiger Name) ein, an den die Nachricht gesendet werden soll. Geben Sie optional die Kanal- oder Nutzer-ID oder die E-Mail-Adresse eines Nutzers an.
Empfänger	String	–	Ja	Geben Sie den Empfänger an, an den eine Nachricht gesendet werden soll.
Nachricht	String	–	Ja	Geben Sie den Inhalt der zu sendenden Nachricht an.

Beispiele für Anwendungsfälle von Playbooks

Senden Sie eine Nachricht mit Rich Content wie Schaltflächen, Links oder Bildern.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

[
  {
    "Entity": "U043FPEMATG",
    "EntityResult": {
      "channel": "D044C3DUMB2",
      "message": {
        "bot_id": "B02D9QYM7P0",
        "type": "message",
        "text": "test msg",
        "user": "U02D1RPLVST",
        "ts": "1666008612.116169",
        "app_id": "A02DDGD942Z",
        "team": "T02CX3N6B0B",
        "bot_profile": {
          "id": "B02D9QYM7P0",
          "app_id": "A02DDGD942Z",
          "name": "test",
          "icons": {
            "image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
            "image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
            "image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png"
          },
          "deleted": false,
          "updated": 1630908872,
          "team_id": "T02CX3N6B0B"
        },
        "blocks": [
          {
            "type": "rich_text",
            "block_id": "RJvg",
            "elements": [
              {
                "type": "rich_text_section",
                "elements": [
                  {
                    "type": "text",
                    "text": "test msg"
                  }
                ]
              }
            ]
          }
        ]
      },
      "ts": "1666008612.116169",
      "ok": true
    }
  }
]

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn die Nachricht erfolgreich gesendet wurde (is_succeed=True): „Message was sent successfully“ (Nachricht wurde erfolgreich gesendet) Wenn die Nachricht nicht gesendet wird (is_succeed=False), weil der angegebene Empfänger nicht gefunden wurde: „Message was not sent as the specified recipient {0} with type {1} was not found.“ (Die Nachricht wurde nicht gesendet, da der angegebene Empfänger {0} vom Typ {1} nicht gefunden wurde.) (Empfänger, Empfängertyp) Wenn die Nachricht aufgrund eines allgemeinen Fehlers nicht gesendet werden konnte (is_succeed=False): „Message was not sent because of occurred error: (0}“ (Fehlertext) Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn die Nachricht erfolgreich gesendet wurde (is_succeed=True): „Message was sent successfully“ (Nachricht wurde erfolgreich gesendet)

Wenn die Nachricht nicht gesendet wird (is_succeed=False), weil der angegebene Empfänger nicht gefunden wurde: „Message was not sent as the specified recipient {0} with type {1} was not found.“ (Die Nachricht wurde nicht gesendet, da der angegebene Empfänger {0} vom Typ {1} nicht gefunden wurde.) (Empfänger, Empfängertyp)

Wenn die Nachricht aufgrund eines allgemeinen Fehlers nicht gesendet werden konnte (is_succeed=False): „Message was not sent because of occurred error: (0}“ (Fehlertext)

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Allgemein

Interaktive Nachricht senden

Beschreibung

Senden Sie eine interaktive Nachricht an einen Channel oder einen Nutzer und prüfen Sie die Antwort des Nutzers anhand der bereitgestellten Webhook-UUID. Diese Aktion ähnelt der Aktion „Erweiterte Nachricht senden“, ermöglicht aber nur das Senden von Blockinhalten (nicht von Nur-Text-Nachrichten) und erfordert außerdem eine Webhook-UUID, um die Antwort des Nutzers auf einen Webhook zu prüfen.

Die Aktion ist asynchron. Passen Sie das Zeitlimit für die Aktion in der IDE entsprechend an.

Konfigurieren Sie die in der Integration verwendete Slack-App so, dass interaktive Nachrichten zugelassen werden. Weitere Informationen zur Konfiguration der Slack-App finden Sie unter Anwendung für interaktive Nachrichten vorbereiten.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Empfängertyp	DDL	Name Mögliche Werte: Name ID E-Mail	Ja	Geben Sie den Kanal- oder Nutzernamen (vollständiger Name) ein, an den die Nachricht gesendet werden soll. Geben Sie optional die Kanal- oder Nutzer-ID oder die E-Mail-Adresse eines Nutzers an.
Empfänger	String	–	Ja	Geben Sie den Empfänger an, an den eine Nachricht gesendet werden soll.
Nachricht	String	–	Ja	Geben Sie den Inhalt der zu sendenden Nachricht an.
Webhook-Token-UUID	String	–	Ja	Geben Sie die UUID des Webhook-Tokens an, das auf die Antwort des Nutzers überwacht werden soll.

Beispiele für Anwendungsfälle von Playbooks

Senden Sie eine Nachricht mit Rich Content wie Schaltflächen, Links oder Bildern.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

[
  {
    "uuid": "10953f8e-7ef8-4bde-9e9b-212005e0e737",
    "type": "web",
    "token_id": "47289ba5-277e-4ab9-9238-eb31080530ca",
    "ip": "0000:a000000:ad80:000:20ea:653:fb97",
    "hostname": "webhook.site",
    "method": "GET",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15",
    "content": "",
    "query": {
      "Answer": "yes"
    },
    "headers": {
      "connection": [
        "close"
      ],
      "accept-encoding": [
        "gzip, deflate, br"
      ],
      "accept-language": [
        "en-US,en;q=0.9"
      ],
      "user-agent": [
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"
      ],
      "cookie": [
        "_ga=GA"
      ],
      "accept": [
        "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
      ],
      "host": [
        "webhook.site"
      ],
      "content-length": [
        ""
      ],
      "content-type": [
        ""
      ]
    },
    "url": "https://webhook.site/47289ba5-277e-4ab9-9238-xx0000000xx?Answer=yes",
    "size": 0,
    "files": [],
    "created_at": "2022-10-14 19:45:40",
    "updated_at": "2022-10-14 19:45:40",
    "sorting": 1665776740032262,
    "custom_action_output": []
  }
]

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn die Nachricht erfolgreich gesendet wurde (is_succeed=True): „Message was sent successfully“ (Nachricht wurde erfolgreich gesendet) Wenn die Nachricht nicht gesendet wird (is_succeed=False), weil der angegebene Empfänger nicht gefunden wurde: „Message was not sent as the specified recipient {0} with type {1} was not found.“ (Die Nachricht wurde nicht gesendet, da der angegebene Empfänger {0} vom Typ {1} nicht gefunden wurde.) (Empfänger, Empfängertyp) Wenn die Nachricht aufgrund eines allgemeinen Fehlers nicht gesendet werden konnte (is_succeed=False): „Message was not sent because of occurred error: (0}“ (Fehlertext) Case Wall-Mitteilungen für die asynchrone Funktion: Eine Fallwandnachricht für die Iterationen, während auf die Antwort gewartet wird: „Warten auf die Antwort auf die gesendete Nachricht mit einem Webhook. Webhook-URL mit UUID: {0}".format(Webhook-URL aus der Integrationskonfiguration + UUID des Web-Tokens) Wenn die Antwort erfolgreich abgerufen wurde (is_succeed=True): „Successfully fetched the user's response to a webhook! Antwortinhalt: {0}".format(payload that was sent from user to a webhook) Wenn die Antwort bis zum Zeitlimit nicht abgerufen werden konnte: „Eine Nutzerantwort auf einen Webhook wurde nicht gefunden und die Aktion wurde aufgrund des Zeitlimits beendet.“ Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn in der Integrationskonfiguration keine Webhook-basierte URL angegeben ist und ein Webhook-UUID-Token angegeben ist: „Aktion konnte nicht ausgeführt werden. Geben Sie den Integrationsparameter ‚Webhook-Basis-URL‘ an.“ " Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Interaktive Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn die Nachricht erfolgreich gesendet wurde (is_succeed=True): „Message was sent successfully“ (Nachricht wurde erfolgreich gesendet)

Wenn die Nachricht aufgrund eines allgemeinen Fehlers nicht gesendet werden konnte (is_succeed=False): „Message was not sent because of occurred error: (0}“ (Fehlertext)

Case Wall-Mitteilungen für die asynchrone Funktion:

Eine Fallwandnachricht für die Iterationen, während auf die Antwort gewartet wird: „Warten auf die Antwort auf die gesendete Nachricht mit einem Webhook. Webhook-URL mit UUID: {0}".format(Webhook-URL aus der Integrationskonfiguration + UUID des Web-Tokens)

Wenn die Antwort erfolgreich abgerufen wurde (is_succeed=True): „Successfully fetched the user's response to a webhook! Antwortinhalt: {0}".format(payload that was sent from user to a webhook)

Wenn die Antwort bis zum Zeitlimit nicht abgerufen werden konnte: „Eine Nutzerantwort auf einen Webhook wurde nicht gefunden und die Aktion wurde aufgrund des Zeitlimits beendet.“

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn in der Integrationskonfiguration keine Webhook-basierte URL angegeben ist und ein Webhook-UUID-Token angegeben ist: „Aktion konnte nicht ausgeführt werden. Geben Sie den Integrationsparameter ‚Webhook-Basis-URL‘ an.“ "

Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Interaktive Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)

Allgemein

Nachricht senden

Beschreibung

Nachricht an einen oder mehrere Nutzer/Channels senden

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanal	String	–	Ja	Der Name des Slack-Kanals oder die E-Mail-Adresse des Nutzers, an den die Nachricht gesendet werden soll. Eingegebene Werte müssen durch Kommas getrennt werden.
Nachricht	String	–	Ja	Nachrichteninhalt.

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Kanal

String

–

Der Name des Slack-Kanals oder die E-Mail-Adresse des Nutzers, an den die Nachricht gesendet werden soll.

Eingegebene Werte müssen durch Kommas getrennt werden.

Nachricht

String

–

Nachrichteninhalt.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Datei hochladen

Beschreibung

Fügen Sie Dateien in Slack hinzu und geben Sie sie für Ihre Teammitglieder frei, um die Zusammenarbeit zu erleichtern. Sie können Dateien auf Ihrem Gerät oder in Ihrer bevorzugten Dateiverwaltungs-App auswählen und in Slack hochladen. Hochgeladene Dateien werden in Ihrem Workspace gespeichert und können dort gesucht und geteilt werden.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Dateiname	String	–	Ja	Name der Zieldatei
Dateipfad	String	–	Ja	Zielpfad.
Kanal	String	–	Ja	Zielkanal

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Auf Antwort warten

Beschreibung

Warten Sie auf eine Thread-Antwort auf eine Nachricht in einem Channel.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Kanal	String	–	Ja	Zielkanal
Zeitstempel der Nachricht	String	–	Ja	Der Zeitstempel der Nachricht, von der die Antworten abgerufen werden sollen (in Millisekunden).
Kanal-ID	String	–	Nein	Die ID des Ziel-Slack-Kanals.

Anwendungsfälle für Playbooks

Playbook mit der Aktion „Nachricht senden“ und anschließend „Auf Antwort warten“ (mit dem Channel als Platzhalter aus der vorherigen Aktion – Channel-ID)

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

N/A

Mit Webhook auf Antwort warten

Beschreibung

Warten Sie, bis ein Nutzer auf eine Nachricht antwortet, die mit einem Webhook gesendet wurde. Bei dieser Aktion wird der angegebene Webhook regelmäßig geprüft, um festzustellen, ob der Nutzer darauf geantwortet hat. Die Aktion kann mit der Aktion „Erweiterte Nachricht senden“ verwendet werden, wenn die Blocknachricht mit Webhook gesendet wurde, um zu prüfen, ob die Antwort des Nutzers an den Webhook gesendet wurde.

Diese Aktion ist asynchron. Passen Sie den Script-Timeout-Wert in der IDE entsprechend an.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Webhook-Token-UUID	String	–	Ja	Geben Sie die UUID des Webhook-Tokens an, das auf die Antwort des Nutzers überwacht werden soll.

Beispiele für Anwendungsfälle von Playbooks

Auf eine Antwort auf eine Nachricht mit einem Webhook warten.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_succeed	Wahr/falsch	is_succeed:False

JSON-Ergebnis

{
  "client_msg_id": "00000000-0000-0000-0000-000000000000",
  "type": "message",
  "text": "Yes",
  "user": "U0000000",
  "ts": "1578390603.001200",
  "team": "T0000000",
  "blocks": [
    {
      "type": "rich_text",
      "block_id": "2Bb=",
      "elements": [
        {
          "type": "rich_text_section",
          "elements": [
            {
              "type": "text",
              "text": "Example"
            }
          ]
        }
      ]
    }
  ],
  "thread_ts": "1578390492.001100",
  "parent_user_id": "U0000000"
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Eine Fallwandnachricht für die Iterationen, während auf die Antwort gewartet wird: „Warten auf die Antwort auf die gesendete Nachricht mit einem Webhook. Webhook-URL mit UUID: {0}".format(Webhook-URL aus der Integrationskonfiguration + UUID des Web-Tokens) Wenn die Antwort erfolgreich abgerufen wurde (is_succeed=True): „Die Antwort des Nutzers auf einen Webhook wurde erfolgreich abgerufen. Antwortinhalt: {0}".format(payload that was sent from user to a webhook) Wenn die Antwort bis zum Zeitlimit nicht abgerufen werden konnte: „Eine Nutzerantwort auf einen Webhook wurde nicht gefunden und die Aktion wurde aufgrund des Zeitlimits beendet.“ Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn die Webhook-basierte URL nicht in der Integrationskonfiguration angegeben ist und das Webhook-UUID-Token angegeben ist: „Aktion konnte nicht ausgeführt werden. Geben Sie den Integrationsparameter ‚Webhook-Basis-URL‘ an.“ " Wenn ein schwerwiegender Fehler gemeldet wird, z. B. falsche Anmeldedaten, keine Verbindung zum Server oder ein anderer Fehler: „Fehler beim Ausführen der Aktion ‚Erweiterte Nachricht senden‘! Fehler: {0}".format(exception.stacktrace)	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn die Antwort erfolgreich abgerufen wurde (is_succeed=True): „Die Antwort des Nutzers auf einen Webhook wurde erfolgreich abgerufen. Antwortinhalt: {0}".format(payload that was sent from user to a webhook)

Wenn die Antwort bis zum Zeitlimit nicht abgerufen werden konnte: „Eine Nutzerantwort auf einen Webhook wurde nicht gefunden und die Aktion wurde aufgrund des Zeitlimits beendet.“

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn die Webhook-basierte URL nicht in der Integrationskonfiguration angegeben ist und das Webhook-UUID-Token angegeben ist: „Aktion konnte nicht ausgeführt werden. Geben Sie den Integrationsparameter ‚Webhook-Basis-URL‘ an.“ "

Allgemein

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten