Udostępnij za pośrednictwem

Łączenie bota z usługą Slack

  • Artykuł

DOTYCZY: ZESTAW SDK w wersji 4

Bot można skonfigurować tak, aby komunikował się z osobami za pośrednictwem aplikacji Slack. W tym artykule opisano sposób tworzenia aplikacji Slack przy użyciu usługi Slack, łączenia bota z aplikacją Slack na platformie Azure i testowania bota w usłudze Slack.

W tym artykule pokazano, jak dodać kanał usługi Slack do bota w witrynie Azure Portal. Aby uzyskać informacje na temat używania niestandardowej karty kanału, zobacz Dodatkowe informacje.

Wymagania wstępne

  • Subskrypcja platformy Azure. Jeśli jeszcze go nie masz, przed rozpoczęciem utwórz bezpłatne konto .
  • Bot opublikowany na platformie Azure, z którym chcesz nawiązać połączenie z usługą Slack.
  • Dostęp do obszaru roboczego usługi Slack z wystarczającymi uprawnieniami do tworzenia aplikacji i zarządzania nimi w witrynie https://api.slack.com/apps. Jeśli nie masz dostępu do środowiska usługi Slack, możesz utworzyć obszar roboczy.

Tworzenie aplikacji w usłudze Slack

Najpierw należy utworzyć aplikację w usłudze Slack, która generuje informacje potrzebne do skonfigurowania kanału usługi Slack dla bota na platformie Azure.

  1. Przejdź do panelu Aplikacje i zaloguj się do swojego konta usługi Slack.
  2. Wybierz pozycję Utwórz nową aplikację lub Utwórz aplikację , jeśli jest to twoja pierwsza aplikacja.
    1. Na stronie Tworzenie aplikacji wybierz pozycję Od podstaw.
    2. Na stronie Nazwa aplikacji i wybierz obszar roboczy w polu Nazwa aplikacji wprowadź nazwę aplikacji Slack.
    3. Aby wybrać obszar roboczy do tworzenia aplikacji, wybierz obszar roboczy dla aplikacji.
    4. Przejrzyj i zaakceptuj warunki użytkowania interfejsu API usługi Slack.
    5. Wybierz Utwórz aplikację.

Dodawanie nowego adresu URL przekierowania

Po utworzeniu aplikacji dodaj adres URL przekierowania do aplikacji.

  1. Wybierz pozycję OAuth i uprawnienia.

  2. W wynikowym okienku w obszarze Adresy URL przekierowania wybierz pozycję Dodaj nowy adres URL przekierowania.

  3. W polu wejściowym wprowadź jeden z następujących adresów URL przekierowania i wybierz pozycję Dodaj.

    • W przypadku bota globalnego wprowadź .https://slack.botframework.com
    • W przypadku bota regionalnego wprowadź następujący adres URL zgodnie z wybranym regionem:
    Region (Region) Adres URL przekierowania
    Europa https://europe.slack.botframework.com
    Indie https://india.slack.botframework.com

  4. Wybierz pozycję Zapisz adresy URL.

Subskrybowanie zdarzeń bota

Po dodaniu adresu URL przekierowania zasubskrybuj aplikację do zdarzeń bota, aby usługa Slack powiadamiała bota o działaniach użytkowników pod określonym adresem URL. Subskrybuj zdarzenia na podstawie funkcji, które bot będzie używał w usłudze Slack.

  1. Wybierz pozycję Subskrypcje zdarzeń.

  2. W wynikowym okienku przełącz opcję Włącz zdarzenia na włączone.

  3. W polu Adres URL żądania wprowadź jeden z następujących adresów URL żądania, gdzie {bot-name} jest nazwą wyświetlaną zasobu usługi Azure Bot bez nawiasów klamrowych.

    • W przypadku bota globalnego wprowadź .https://slack.botframework.com/api/Events/{bot-name}
    • W przypadku bota regionalnego wprowadź następujący adres URL zgodnie z wybranym regionem:
    Region (Region) Adres URL żądania
    Europa https://europe.slack.botframework.com/api/Events/{bot-name}
    Indie https://india.slack.botframework.com/api/Events/{bot-name}

  4. W obszarze Subskrybuj zdarzenia bota wybierz pozycję Dodaj zdarzenie użytkownika bota, a następnie zasubskrybuj zdarzenia. Na przykład:

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

  5. Wybierz Zapisz zmiany.

Włączanie wysyłania komunikatów do bota przez użytkowników

Po zasubskrybowaniu zdarzeń bota włącz użytkownikom wysyłanie wiadomości do bota.

  1. Wybierz pozycję Strona główna aplikacji.
  2. W wyświetlonym okienku w sekcji Pokaż karty na karcie Komunikaty włącz opcję Zezwalaj użytkownikom na wysyłanie poleceń i komunikatów ukośnika z karty wiadomości.

Dodawanie i konfigurowanie komunikatów interakcyjnych

Opcjonalnie włącz komunikaty interakcyjne.

  1. Wybierz pozycję Interactivity & Shortcuts (Interactivity i skróty).

  2. Adres URL żądania:

    • W przypadku bota globalnego wprowadź .https://slack.botframework.com/api/Actions
    • W przypadku bota regionalnego wprowadź następujący adres URL zgodnie z wybranym regionem:
    Region (Region) Adres URL żądania
    Europa https://europe.slack.botframework.com/Actions
    Indie https://india.slack.botframework.com/Actions

  3. Wybierz Zapisz zmiany.

Kopiowanie informacji o aplikacji

Do dodania kanału usługi Slack do bota będą potrzebne następujące informacje. Zawsze kopiuj i przechowuj poświadczenia aplikacji w bezpiecznym miejscu.

  1. Wybierz pozycję Podstawowe informacje.
  2. W wynikowym okienku w obszarze Poświadczenia aplikacji znajdź pozycję Identyfikator klienta, Klucz tajny klienta i Klucz tajny podpisywania.
  3. Teraz wybierz pozycję OAuth i uprawnienia.
  4. W wynikowym okienku znajdź sekcję Zakresy . Zarejestruj zakresy tokenów bota dla aplikacji.

Konfigurowanie bota na platformie Azure

Aby wykonać ten krok, musisz mieć poświadczenia aplikacji Slack z poprzedniego kroku.

  1. Otwórz portal Azure Portal.

  2. Otwórz blok zasobów usługi Azure Bot dla bota.

  3. Otwórz kanały i wybierz pozycję Slack.

  4. W obszarze Konfiguracja kanału Slack wprowadź informacje skopiowane w poprzednich krokach.

    1. Wprowadź wymagane poświadczenia usługi Slack dla aplikacji utworzonej w usłudze Slack.
    2. Opcjonalnie podaj adres URL strony docelowej, do którego użytkownicy usługi Slack zostaną przekierowani po dodaniu bota.
    3. Wartości Adres URL przekierowania i adres URL żądania subskrypcji zdarzeń protokołu OAuth & Permissions powinny być zgodne z wartościami wprowadzonymi w usłudze Slack, aby dodać adres URL przekierowania i subskrybować zdarzenia bota.

    przesyłanie poświadczeń

  5. Wybierz Zastosuj.

  6. Nastąpi przekierowanie do usługi Slack, aby zakończyć instalowanie aplikacji Slack.

    • Jeśli żądane uprawnienia wyglądają poprawnie, wybierz pozycję Zezwalaj.

Bot jest teraz skonfigurowany do komunikowania się z użytkownikami w usłudze Slack. Użytkownicy w obszarze roboczym mogą teraz korzystać z bota za pośrednictwem aplikacji Slack.

Testowanie aplikacji w usłudze Slack

  1. Zaloguj się do obszaru roboczego usługi Slack, w którym zainstalowano aplikację.
  2. W obszarze Aplikacje wybierz aplikację.
  3. W wynikowym okienku wyślij komunikaty do aplikacji.

Dodatkowe informacje

Uwaga

Od czerwca 2020 r. kanał Slack obsługuje zakresy uprawnień usługi Slack V2, które umożliwiają botowi określenie jego możliwości i uprawnień w bardziej szczegółowy sposób. Wszystkie nowo skonfigurowane kanały usługi Slack będą używać zakresów w wersji 2. Aby przełączyć bota do zakresów wersji 2, usuń i ponownie utwórz konfigurację kanału Slack w bloku Kanały witryny Azure Portal.

Aby uzyskać więcej informacji na temat obsługi botów w usłudze Slack, zobacz dokumentację interfejsu API usługi Slack:

Łączenie bota z usługą Slack przy użyciu adaptera Slack

Oprócz kanału dostępnego w usłudze Azure AI Bot Service w celu połączenia bota z usługą Slack repozytoria Społeczności bot builder definiują niestandardową kartę kanału dla usługi Slack.

  • Aby uzyskać informacje na temat karty języka C#, zobacz sekcję Adaptery w repozytorium społeczności platformy .NET.
  • Aby uzyskać informacje na temat karty JavaScript, zobacz sekcję Adaptery w repozytorium społeczności języka JavaScript.