Slack Spoke

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 7 Minuten Lesedauer
  • Verwenden Sie die Spoke Slack, um Nachrichten zu senden und den Zugriff auf Kanäle zu verwalten.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht. Um mehr über das Abonnement zu erfahren, wenden Sie sich an Ihren Account Manager.

    Spoke-Version

    Die Slack -Spoke v1.6.0 ist die neueste Version.

    Slack-Account-Anforderungen

    Die Slack -Spoke erfordert die Erstellung eines Arbeitsbereichs und einer anwenderdefinierten App in Ihrem Slack -Konto, um die OAuth 2.0-Token für die Slack-Spoke zu generieren. Weitere Informationen finden Sie unter Konfigurieren Sie die App Slack.
    Hinweis:
    Das hier beschriebene Verfahren zum Einrichten der Spoke erfordert nur Bot-Benutzertoken. Sie können die Aktionen „Anwender erstellen“ und „Anwender deaktivieren“ nicht verwenden, während Sie die Bot-Token-Bereiche verwenden. Um diese Aktionen verwenden zu können, müssen Sie ein Benutzertoken von Ihrem Slack-Kontoabrufen.

    Spoke-Unterabläufe

    Die Slack -Spoke bietet einige Beispiel-Subflows, um die Automatisierung der Aufgaben des Slack -Arbeitsbereichs zu demonstrieren. Um einen Beispiel-Unterablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Unterabläufe umfassen Folgendes:
    Subflow Beschreibung
    Fügen Sie Slack-Anwenderdetails nach Mitglieds-ID ein Fügt Details des erforderlichen Anwenders basierend auf der Mitglieds-ID in das Slack-Anwendercache-Modul ein.
    Fügen Sie Slack-Anwenderdetails nach Anwender-ID ein Fügt Details des erforderlichen Anwenders basierend auf der Anwender-ID in das Slack-Anwendercache-Modul ein.
    Umsetzbare Nachricht posten Postet eine umsetzbare Nachricht an einen Slack -Kanal.
    Hinweis:
    Dieser Subflow erfordert eine ausgehende Konfiguration als Eingabe. Passen Sie die standardmäßigen ausgehenden Konfigurationen an, oder erstellen Sie eine ausgehende Konfiguration gemäß Ihren Anforderungen. Weitere Informationen finden Sie unter Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow ..
    Genehmigungsnachricht posten Postet eine Genehmigungsnachricht an einen Slack -Kanal.
    Hinweis:
    Dieser Subflow erfordert eine ausgehende Konfiguration als Eingabe. Passen Sie die standardmäßigen ausgehenden Konfigurationen an, oder erstellen Sie eine ausgehende Konfiguration gemäß Ihren Anforderungen. Weitere Informationen finden Sie unter Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow ..
    Antworten Sie auf die Slack-Genehmigungsnachricht Postet eine Bestätigungsnachricht auf einem Slack -Kanal.
    Antworten Sie auf den Slack-Befehl Postet eine Antwort auf einen Befehl in einem Slack -Kanal.
    Auf Slack-Nachrichtenaktion antworten Postet eine Benachrichtigung auf einem Slack -Kanal.

    Stellen Sie beim Anpassen der Subflows sicher, dass die Subflows so konfiguriert sind, dass Endlosschleifen vermieden werden.

    Spoke-Aktionen

    Die Slack -Spoke bietet Aktionen zur Automatisierung der Aufgaben des Slack -Arbeitsbereichs, wenn in der Instanz ServiceNow Ereignisse eintreten. Folgende Aktionen sind verfügbar:

    Kategorie Aktion Beschreibung
    Konversationsmanagement Anwender zu Kanal hinzufügen Fügt dem angegebenen Kanal im Slack-Arbeitsbereich einen vorhandenen Anwender hinzu.
    Kanal archivieren Archiviert einen Kanal in einem Slack -Arbeitsbereich.
    Konversation umbenennen Benennt eine Konversation um.
    Konversationsinfo suchen Ruft Informationen zu einer Konversation ab.
    Kanal erstellen Erstellt einen Kanal in einem Slack-Arbeitsbereich.
    Stream mit Anhängen anhand Konversations- oder Mitglieds-ID suchen Ruft Anhänge ab, die sich auf den entsprechenden Kanal, das Mitglied oder den Bot-Anwender beziehen.
    Kanalverlauf-Stream suchen Ruft den Verlauf eines Kanals ab. Sie müssen die Kanal-ID sowie das Start- und das Enddatum als Eingaben angeben.
    Konversation suchen Ruft die Konversationsnachrichten für einen Thread aus dem angegebenen Kanal ab.
    Konversation öffnen Öffnet eine Direktnachricht oder eine Direktnachricht für mehrere Personen oder setzt sie fort.
    Konversations-IDs-Stream nach Mitglieds-ID suchen Ruft Details der Konversations-IDs ab, die mit dem angegebenen Mitglied in Slack verknüpft sind.
    Thema für Kanal festlegen Legt das Thema für einen Slack-Kanal fest.
    Anwender aus Kanal entfernen Entfernt einen Anwender aus einem Kanal im Arbeitsbereich Slack.
    Benachrichtigungsverwaltung Umsetzbare Nachricht posten Postet eine umsetzbare Nachricht in einem Slack-Kanal.
    Hinweis:
    Diese Aktion erfordert eine ausgehende Konfiguration als Eingabe. Passen Sie die standardmäßigen ausgehenden Konfigurationen an, oder erstellen Sie eine ausgehende Konfiguration gemäß Ihren Anforderungen. Weitere Informationen finden Sie unter Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow ..
    Genehmigungsnachricht posten Postet eine Genehmigungsnachricht an einen Slack -Kanal.
    Hinweis:
    Diese Aktion erfordert eine ausgehende Konfiguration als Eingabe. Passen Sie die standardmäßigen ausgehenden Konfigurationen an, oder erstellen Sie eine ausgehende Konfiguration gemäß Ihren Anforderungen. Weitere Informationen finden Sie unter Konfigurieren Sie ausgehende Konfigurationen in der Instanz ServiceNow ..
    Change-Details posten Postet Change-Datensatzdetails in einen Kanal.
    Incident-Details posten Postet Details des Incident-Datensatzes in einen Kanal.
    Nachricht posten Postet eine Nachricht in einem Slack -Kanal.
    Antwort in Slack posten Postet eine Antwort in Slack.
    Genehmigungsdatensatz aktualisieren Aktualisiert einen Genehmigungsdatensatz.
    Problemdetails posten Postet ein Problemdatensatzdetail in einem Kanal.
    Anwenderverwaltung Anwender erstellen Erstellt einen Anwender im Slack-Arbeitsbereich.
    Hinweis:
    Diese Aktion erfordert ein Benutzertoken aus dem Slack-Account. Wenn Sie über Bot-Anwendertoken verfügen, können Sie diese Aktion nicht verwenden.
    Anwender deaktivieren Deaktiviert den angegebenen Anwender im Arbeitsbereich Slack.
    Hinweis:

    Diese Aktion erfordert ein Anwendertoken aus dem Account Slack. Wenn Sie über Bot-Anwendertoken verfügen, können Sie diese Aktion nicht verwenden.

    Anwender suchen Gibt Informationen zum angegebenen Anwender oder Bot zurück. Die Informationen können Name, Zeitzone, Administratorrechte für den Arbeitsbereich und Teambesitz eines Anwenders oder Bots sein.
    Abonnement deaktivieren Deaktiviert ein Anwenderabonnement in Slack. Um diese Aktion zu verwenden, führen Sie die im Abschnitt „Eine Slack-Enterprise-Grid-Anwendung erstellen“ und „Eine Slack-Enterprise-Verbindung erstellen“ in Integration mit Slackbeschriebenen Schritte aus.
    Stream mit Zugriffsprotokollen suchen Ruft die Zugriffsprotokolle für alle Anwender ab dem angegebenen ältesten Datum ab. Um diese Aktion zu verwenden, führen Sie die im Abschnitt Slack-Arbeitsbereichsanwendung erstellen und Slack-Arbeitsbereichsverbindung erstellen in Integration mit Slackbeschriebenen Schritte aus.
    Stream mit Anwendern suchen Ruft alle Anwender im Slack Enterprise-Raster ab. Um diese Aktion zu verwenden, führen Sie die im Abschnitt „Eine Slack-Enterprise-Grid-Anwendung erstellen“ und „Eine Slack-Enterprise-Verbindung erstellen“ in Integration mit Slackbeschriebenen Schritte aus.
    Hinweis:
    • Die Aktionen „Anwender erstellen“ und „Anwender deaktivieren“ erfordern den Administratorbereich. Das hier beschriebene Verfahren zum Einrichten der Spoke erfordert nur Bot-Benutzertoken. Sie können die Aktionen „Anwender erstellen“ und „Anwender deaktivieren“ nicht verwenden, während Sie die Bot-Token-Bereiche verwenden. Um diese Aktionen verwenden zu können, müssen Sie ein Benutzertoken von Ihrem Slack-Kontoabrufen.
    • Der Administratorbereich ist nur für Slack-Arbeitsbereichsbesitzer verfügbar.

    Spoke-Module

    Die Slack-Spoke fügt die Anwendung Slack zu Ihrer Instanz ServiceNow hinzu. Die Anwendung Slack enthält diese Module:
    Modul Beschreibung
    Konfiguration des modalen Slack-Elements Erstellen Sie modale Fenster, und geben Sie Felder an, die im modalen Fenster Slack angezeigt werden sollen.
    Slack-Anwender-Cache Greifen Sie auf Informationen zu Anwendern zu, die Aktionen im Kanal Slack ausgeführt haben, für die eine Aktualisierung in der Instanz ServiceNow oder eine Antwort von der Instanz ServiceNow ] erforderlich war.
    Slack-Kanal-Cache Greifen Sie auf Informationen zu den Kanälen zu, auf denen Aktionen ausgeführt werden, für die Aktualisierungen in der Instanz ServiceNow oder eine Antwort von der Instanz ServiceNow ] erforderlich waren.
    Eingehende Entscheidungen Geben Sie Ereignisse in der Anwendung Slack an, für die Aktionen in der Instanz ServiceNow ausgeführt werden müssen.

    Sie können beispielsweise eingehende Entscheidungen angeben, um die Aufgabendetails in Ihrer Instanz ServiceNow zu aktualisieren, wenn ein Genehmiger die Aufgabe im relevanten Kanal Slack genehmigt. Als Referenz stehen fünf Beispiele für eingehende Entscheidungen zur Verfügung. Passen Sie diese Entscheidungen an, oder erstellen Sie eingehende Entscheidungen gemäß Ihren Anforderungen.

    Wenn die in den eingehenden Entscheidungen genannten Bedingungen erfüllt sind, wird der zugehörige Subflow ausgelöst und im Modul Slack-Anwendercache ein Datensatz für den Slack-Benutzer erstellt, der die eingehende Aktion initiiert hat.

    Eingehende Entscheidungen für modale Elemente Geben Sie Subflows an, die ausgelöst werden müssen, wenn die erforderlichen eingehenden Entscheidungen erfüllt sind.

    Wenn die in den eingehenden Entscheidungen genannten Bedingungen erfüllt sind, wird der zugehörige Subflow ausgelöst und im Modul Slack-Anwendercache ein Datensatz für den Slack-Benutzer erstellt, der die eingehende Aktion initiiert hat.

    Slack Ausgehende Auswahlmöglichkeiten Auswahlmöglichkeiten, die als Liste in den Slack-Kanälen angezeigt werden sollen.
    Eingehende Slack-Nachricht Greifen Sie auf Informationen zu den eingehenden Nachrichten zu, die Sie in der Anwendung Slack an Ihre Instanz ServiceNow erhalten.
    Ausgehende Konfigurationen Geben Sie Ereignisse in der Instanz ServiceNow an, für die Aktionen in der Anwendung Slack ausgeführt werden müssen.

    Sie können beispielsweise ausgehende Konfigurationen so festlegen, dass im Kanal Slack eine Nachricht gesendet wird, in der Sie um Genehmigung gebeten werden, wenn in Ihrer Instanz ServiceNow eine Aufgabe erstellt wird. Als Referenz sind drei Beispiele für ausgehende Konfigurationen verfügbar. Passen Sie diese Konfigurationen an, oder erstellen Sie ausgehende Konfigurationen gemäß Ihren Anforderungen.

    Die ausgehenden Konfigurationen stellen auch eine Vorlage für die Aktionen „Umsetzbare Nachricht veröffentlichen“ und „Nachricht nach Genehmigung“ bereit. Beispielsweise können Sie die ausgehenden Konfigurationen so konfigurieren, dass die Schaltflächen Genehmigen und Ablehnen in der Genehmigungsnachricht angezeigt werden, die über den relevanten Kanal Slack gesendet wird.

    Wenn die in den ausgehenden Konfigurationen genannten Konfigurationen erfüllt sind, wird der entsprechende Subflow ausgelöst, um Aktionen in der Anwendung Slack auszuführen.

    Slack-Konfigurationen Geben Sie Informationen zur Slack-App und zum Signierschlüssel an.
    Daten in diesen Modulen werden aus diesen Spoke-Tabellen gefüllt:
    Tabelle Felder
    Slack-Kanal-Cache [sn_slack_ah_v2_slack_channel_cache]
    • Kanal-ID
    • Kanallink
    • Kanalname
    • Ersteller
    • Dokument-ID
    • Ist archiviert
    • Ist privat
    • Quelltabelle
    Slack-Konfigurationen [sn_slack_ah_v2_slack_configurations]
    • Geheimer Clientschlüssel
    • Verbindungsalias
    • Eigenschaftsname
    • Slack-App
    Slack-Anmeldeinformationen [sn_slack_ah_v2_slack_credential]
    • Authentifizierungsschlüssel
    • Aktiv
    • Kontextname
    • Domänenname
    • Datenschutzschlüssel
    Ausgehende Auswahlmöglichkeiten für Slack [sn_slack_ah_v2_slack_outbound_choices]
    • Name
    • Aktiv
    • Sprache
    • Sequenz
    • Domäne
    • Wert
    Slack-Anwendercache [sn_slack_ah_v2_slack_user_details]
    • Anzeigename
    • Slack-Mitglieds-ID
    • Team-ID
    • Anwender
    Slack-Arbeitsbereichstoken [sn_slack_ah_v2_slack_workspace_tokens]
    • Verbindungsalias
    • Slack-App
    • Arbeitsbereichsname
    Modale Konfiguration von Slack [sn_slack_ah_v2_slack_modal_configuration]
    • Modal-Titel
    • Name
    • Skriptvalidierung
    • Anwenderdefiniertes modales Element

    Alias-Anforderungen für Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

    Informationen zum Einrichten der Spoke finden Sie unter Slack-Spoke einrichten.