Verbinden eines Bots mit SlackConnect a bot to Slack

gilt für: SDK v4APPLIES TO: SDK v4

In diesem Artikel erfahren Sie, wie Sie einem Bot einen Slack-Kanal hinzufügen.This article shows how to add a Slack channel to a bot. Wählen Sie eine der folgenden Möglichkeiten aus, um die Slack-App zu konfigurieren:Select one of the following ways to configure the Slack app:

  • Verwenden des Azure Bot Service-Portals zum Verbinden Ihres BotsUse Azure Bot Service portal to connect your bot
  • Verwenden des Slack-AdaptersUse the Slack adapter

Erstellen einer Slack-Anwendung für Ihren BotCreate a Slack application for your bot

  1. Melden Sie sich in Ihrem Browser bei Slackan.In your browser, sign in Slack.

  2. Navigieren Sie zum Bereich Ihre Apps.Navigate to Your Apps panel.

    Einrichten des Bots

  3. Klicken Sie auf Create New App.Click Create New App.

  4. Geben Sie im Feld App-Name den Namen Ihrer Slack-Anwendung ein.In the App Name box, enter the name of your Slack application.

  5. Geben Sie im Feld Development Slack Team (Entwicklungs-Slack-Team) den Namen Ihres Entwicklungsteams ein.In the Development Slack Team box, enter the name of your development team. Wenn Sie noch kein Mitglied eines Slack-Entwicklungsteams sind, erstellen Sie eines, oder treten Sie einem bei.If you are not already a member of a Development Slack Team, create or join one.

    Erstellen einer App

  6. Klicken Sie auf Create app (App erstellen).Click Create App.

Hinzufügen einer neuen Umleitungs-URLAdd a new redirect URL

  1. Wählen Sie im linken Bereich das Menüelement OAuth & Berechtigungen aus.In the left panel, select the OAuth & Permissions menu item.

  2. Klicken Sie im rechten Bereich auf Neue Umleitungs-URL hinzufügen.In the right panel, click Add a new Redirect URL.

  3. Geben Sie in das Feld https://slack.botframework.com/ ein.In the box, enter https://slack.botframework.com/.

  4. Klicken Sie auf Hinzufügen.Click Add.

  5. Klicken Sie auf Save URLs (URLs speichern).Click Save URLs.

    Hinzufügen einer Umleitungs-URL

Abonnieren von Bot-EreignissenSubscribe to Bot Events

Abonnieren Sie anhand der folgenden Schritte sechs spezielle Bot-Ereignisse.Follow these steps to subscribe to six particular bot events. Durch das Abonnieren von Bot-Ereignissen wird Ihre App über Benutzeraktivitäten unter der URL, die Sie angeben, benachrichtigt.By subscribing to bot events, your app will be notified of user activities at the URL you specify.

Tipp

Ihr Bot-Handle ist der Name Ihres Bots.Your bot handle is the name of your bot. Um das Handle eines Bots zu finden, besuchen Sie https://dev.botframework.com/bots , wählen Sie einen Bot aus, und noten Sie sich den Namen des Bots.To find a bot's handle, visit https://dev.botframework.com/bots, choose a bot, and record the name of the bot.

  1. Wählen Sie im linken Bereich das Element Ereignisabonnements aus.In the left panel, select the Event Subscriptions item.

  2. Legen Sie im rechten Bereich Ereignisse aktivieren auf Ein fest.In the right panel, set Enable Events to On.

  3. Geben Sie unter Anforderungs-URL die URL https://slack.botframework.com/api/Events/{YourBotHandle} ein. Dabei steht {YourBotHandle} (ohne Klammern) für das Bot-Handle.In Request URL, enter https://slack.botframework.com/api/Events/{YourBotHandle}, where {YourBotHandle} is your bot handle, without the braces.

    Abonnieren von Ereignissen

  4. Klicken Sie unter Subscribe to Bot Events (Bot-Ereignisse abonnieren) auf Add Bot User Event (Bot-Benutzerereignis hinzufügen).In Subscribe to Bot Events, click Add Bot User Event.

  5. Wählen Sie in der Liste mit den Ereignissen diese sechs Ereignistypen aus:In the list of events, select these six event types:

    • member_joined_channel
    • member_left_channel
    • message.channels
    • message.groups
    • message.im
    • message.mpim

    Liste der abonnierten Ereignisse

  6. Klicken Sie unten auf dem Bildschirm auf Änderungen speichern.At the bottom of the screen, click Save Changes.

Beim Hinzufügen von Ereignissen in Slack werden die Bereiche aufgelistet, die Sie anfordern müssen.As you add events in Slack, it lists the scopes you need to request. Welche Bereiche Sie benötigen, hängt von den Ereignissen ab, die Sie abonnieren, und davon, wie Sie darauf reagieren möchten.The scopes you need will depend on the events you subscribe to and how you intend to respond to them. Informationen zu von Slack unterstützten Bereichen finden Sie unter Bereiche und Berechtigungen.For Slack supported scopes, refer to Scopes and permissions. Siehe auch Grundlegendes zu OAuth-Bereichen für Bots.See also Understanding OAuth scopes for Bots.

Hinweis

Ab Juni 2020 unterstützt der Slack-Kanal Slack V2-Berechtigungsbereiche, mit denen der Bot seine Funktionen und Berechtigungen präziser angeben kann.As of June 2020 Slack channel supports Slack V2 permission scopes which allow the bot to specify its capabilities and permissions in a more granular way. Alle neu konfigurierten Slack-Kanäle verwenden die V2-Bereiche.All newly configured Slack channels will use the V2 scopes. Um Ihren Bot auf die V2-Bereiche umzustellen, löschen Sie die Slack-Kanalkonfiguration auf dem Blatt Azure-Portal Kanäle, und erstellen Sie sie neu.To switch your bot to the V2 scopes, delete and recreate the Slack channel configuration in the Azure portal Channels blade.

Hinzufügen und Konfigurieren von interaktiven Nachrichten (optional)Add and Configure Interactive Messages (optional)

Wenn Ihr Bot Slack-spezifische Funktionen wie Schaltflächen verwendet, gehen Sie wie folgt vor:If your bot will use Slack-specific functionality such as buttons, follow these steps:

  1. Wählen Sie die Registerkarte Interaktivität & Verknüpfungen aus, und aktivieren Sie Interaktivität.Select the Interactivity & Shortcuts tab and enable Interactivity.

  2. Geben Sie https://slack.botframework.com/api/Actions als Request URL (Anforderungs-URL) ein.Enter https://slack.botframework.com/api/Actions as the Request URL.

  3. Klicken Sie auf die Schaltfläche Änderungen speichern.Click the Save changes button.

    Aktivieren von Nachrichten

Hinzufügen des Slack-Kanals zum BotAdd the Slack channel to the bot

  1. Wählen Sie im linken Bereich das Element Grundlegende Informationen aus.In the left panel, select the Basic Information item.

  2. Scrollen Sie im rechten Bereich zum Abschnitt App-Anmeldeinformationen.In the right panel, scroll to the App Credentials section. Die Client-ID, der geheime Clientschlüssel und der Signaturschlüssel, die zum Konfigurieren Ihres Slack-Botkanals erforderlich sind, werden angezeigt.The Client ID, Client Secret, and Signing Secret required for configuring your Slack bot channel are displayed. Kopieren und speichern Sie diese Anmeldeinformationen an einem sicheren Ort.Copy and store these credentials in safe place.

    Erfassen von Anmeldeinformationen

  3. Öffnen Sie Ihren Bot im Azure-Portal.Open your bot in the Azure portal.

  4. Wählen Sie im linken Bereich Kanäle aus.In the left panel, select Channels,

  5. Wählen Sie im rechten Bereich das Slack-Symbol aus.In the right panel, select the Slack icon.

  6. Fügen Sie die Anmeldeinformationen der Slack-App, die Sie in den vorherigen Schritten gespeichert haben, in die entsprechenden Felder ein.Paste the Slack app credentials you saved in the previous steps into the appropriate fields.

  7. Die Angabe von Landing Page URL (URL der Landing Page) ist optional.The Landing Page URL is optional. Sie können diese auslassen oder ändern.You may omit or change it.

    Senden von Anmeldeinformationen

  8. Klicken Sie auf Speichern.Click Save. Befolgen Sie die Anweisungen, um Ihr Slack-Entwicklungsteam für den Zugriff auf Ihre Slack-App zu autorisieren.Follow the instructions to authorize your Slack app's access to your Development Slack Team.

  9. Vergewissern Sie sich auf der Seite Slack konfigurieren, dass der Schieberegler über die Schaltfläche Speichern auf Aktiviert festgelegt ist.On the Configure Slack page, confirm that the slider by the Save button is set to Enabled. Ihr Bot ist jetzt für die Kommunikation mit den Benutzern in Slack konfiguriert.Your bot is now configured to communicate with the users in Slack.

Erstellen einer Schaltfläche namens „Add to Slack“ (Zu Slack hinzufügen)Create an Add to Slack button

Im Abschnitt Add the Slack button (Slack-Schaltfläche hinzufügen) auf dieser Seite stellt Slack einen HTML-Code bereit, um Slack-Benutzern die Suche nach Ihrem Bot zu vereinfachen.Slack provides HTML you can use to help Slack users find your bot in the Add the Slack button section of this page. Um diesen HTML-Code mit Ihrem Bot zu verwenden, ersetzen Sie den href-Wert (beginnt mit https://) durch die URL in den Slack-Kanaleinstellungen Ihres Bots.To use this HTML with your bot, replace the href value (begins with https://) with the URL found in your bot's Slack channel settings. Um die Ersatz-URL abzurufen, gehen Sie wie folgt vor:Follow these steps to get the replacement URL.

  1. https://dev.botframework.com/botsKlicken Sie in auf Ihren Bot.On https://dev.botframework.com/bots, click your bot.
  2. Klicken Sie auf Channels (Kanäle), klicken Sie mit der rechten Maustaste auf den Eintrag Slack, und klicken Sie dann auf Copy link (Link kopieren).Click Channels, right-click the entry named Slack, and click Copy link. Diese URL ist jetzt in der Zwischenablage gespeichert.This URL is now in your clipboard.
  3. Fügen Sie diese URL aus der Zwischenablage in den HTML-Code ein, der für die Slack-Schaltfläche bereitgestellt wird.Paste this URL from your clipboard into the HTML provided for the Slack button. Diese URL ersetzt den href-Wert, der von Slack für diesen Bot bereitgestellt wird.This URL replaces the href value provided by Slack for this bot.

Autorisierte Benutzer können auf die Schaltfläche Add to Slack (Zu Slack hinzufügen) klicken, die von diesem geänderten HTML-Code bereitgestellt wird, um eine Verbindung mit Ihrem Bot in Slack herzustellen.Authorized users can click the Add to Slack button provided by this modified HTML to reach your bot on Slack.

Hinweis

Der Link, den Sie in den href-Wert des HTML-Codes eingefügt haben, enthält Bereiche, die bei Bedarf optimiert werden können.The link you pasted into the href value of the HTML contains scopes that can be refined as needed. Die vollständige Liste der verfügbaren Bereiche finden Sie unter Bereiche und Berechtigungen.See Scopes and permissions for the full list of available scopes.

Testen Ihrer Anwendung in SlackTest your application in Slack

  1. Melden Sie sich beim Slack-Arbeitsbereich an, in dem Sie Ihre App installiert haben ( http://<your work space>-group.slack.com/ ).Log in the Slack work space where you installed your app (http://<your work space>-group.slack.com/). Sie wird im linken Bereich im Abschnitt Apps aufgeführt.You will see it listed under the Apps section in the left panel.

  2. Wählen Sie im linken Bereich Ihre App aus.In the left panel, select your app.

  3. Schreiben Sie im rechten Bereich eine E-Mail, und senden Sie sie an die Anwendung.In the right panel, write e message and send it to the application. Wenn Sie einen Echobot verwendet haben, gibt die Anwendung die Nachricht zurück, wie in der folgenden Abbildung dargestellt.If you used an echo bot, the application echoes back the message as shown in the figure below.

    App-Tests

Sie können diese Funktion auch mit dem Beispielbot für den Slack-Adapter testen, indem Sie die Datei „appSettings.json“ mit den gleichen Werten auffüllen, die in den obigen Schritten beschrieben werden.You can also test this feature using the sample bot for the Slack adapter by populating the appSettings.json file with the same values described in the steps above. Dieses Beispiel enthält zusätzliche, in der Infodatei beschriebene Schritte, um Beispiele für Linkfreigabe, Empfangen von Anlagen und Senden interaktiver Nachrichten zu zeigen.This sample has additional steps described in the README file to show examples of link sharing, receiving attachments, and sending interactive messages.