Připojení robota do Slacku

  • Článek

PLATÍ PRO: SDK v4

Robota můžete nakonfigurovat tak, aby komunikovali s lidmi prostřednictvím aplikace Slack. Tento článek popisuje, jak vytvořit aplikaci Slack pomocí Slacku, připojit robota k aplikaci Slack v Azure a otestovat robota ve Slacku.

Tento článek ukazuje, jak přidat kanál Slack do robota na webu Azure Portal. Informace o použití vlastního adaptéru kanálu najdete v tématu Další informace.

Požadavky

  • Předplatné Azure. Pokud ho ještě nemáte, vytvořte si před zahájením bezplatný účet .
  • Robot publikovaný v Azure, ke kterému se chcete připojit ke Slacku.
  • Přístup k pracovnímu prostoru Slack s dostatečnými oprávněními k vytváření a správě aplikací na adrese https://api.slack.com/apps. Pokud nemáte přístup k prostředí Slack, můžete vytvořit pracovní prostor.

Vytvoření aplikace ve Slacku

Nejprve vytvoříte aplikaci ve Slacku, která vygeneruje informace, které potřebujete ke konfiguraci kanálu Slack pro robota v Azure.

  1. Přejděte na panel Vaše aplikace a přihlaste se ke svému účtu Slack.
  2. Pokud je to vaše první aplikace, vyberte Vytvořit novou aplikaci nebo Vytvořte aplikaci .
    1. Na stránce Vytvořit aplikaci vyberte Od začátku.
    2. Na stránce Název aplikace a zvolte pracovní prostor jako Název aplikace zadejte název vaší aplikace Slack.
    3. V části Vyberte pracovní prostor, ve které chcete aplikaci vyvíjet, vyberte pracovní prostor pro vaši aplikaci.
    4. Přečtěte si podmínky služby Slack API a odsouhlaste je.
    5. Vyberte položku Vytvořit aplikaci.

Přidání nové adresy URL pro přesměrování

Po vytvoření aplikace přidejte do aplikace adresu URL pro přesměrování.

  1. Vyberte OAuth a oprávnění.

  2. Ve výsledném podokně v části Adresy URL pro přesměrování vyberte Přidat novou adresu URL pro přesměrování.

  3. Do vstupního pole zadejte jednu z následujících adres URL přesměrování a vyberte Přidat.

    • V případě globálního robota zadejte https://slack.botframework.com.
    • V případě místního robota zadejte následující adresu URL podle vybrané oblasti:
    Oblast URL pro přesměrování
    Evropě https://europe.slack.botframework.com
    Indie https://india.slack.botframework.com

  4. Vyberte Uložit adresy URL.

Přihlášení k odběru událostí robota

Po přidání adresy URL pro přesměrování se přihlaste k odběru událostí robota a požádejte robota o aktivitách uživatelů na zadaná adresa URL. Přihlaste se k odběru událostí na základě funkcí, které robot bude používat ve Slacku.

  1. Vyberte Odběry událostí.

  2. Ve výsledném podokně přepněte povolit události na Zapnuto.

  3. Jako adresu URL požadavku zadejte jednu z následujících adres URL požadavku, kde {bot-name} je zobrazovaný název prostředku robota Azure bez závorek.

    • V případě globálního robota zadejte https://slack.botframework.com/api/Events/{bot-name}.
    • V případě místního robota zadejte následující adresu URL podle vybrané oblasti:
    Oblast Adresa URL požadavku
    Evropě https://europe.slack.botframework.com/api/Events/{bot-name}
    Indie https://india.slack.botframework.com/api/Events/{bot-name}

  4. V části Přihlášení k odběru událostí robota vyberte Přidat událost uživatele robota a pak se přihlaste k odběru událostí. Příklad:

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

  5. Vyberte volbu Uložit změny.

Povolení odesílání zpráv robotovi uživateli

Po přihlášení k odběru událostí robota povolte uživatelům zasílání zpráv robota.

  1. Vyberte Domovskou stránku aplikace.
  2. Ve výsledném podokně v části Zobrazit karty na kartě Zprávy povolte uživatelům odesílat příkazy lomítko a zprávy z karty zprávy.

Přidání a konfigurace interaktivních zpráv

Volitelně můžete povolit interaktivní zprávy.

  1. Vyberte interaktivitu a klávesové zkratky.

  2. Adresa URL žádosti:

    • V případě globálního robota zadejte https://slack.botframework.com/api/Actions.
    • V případě místního robota zadejte následující adresu URL podle vybrané oblasti:
    Oblast Adresa URL požadavku
    Evropě https://europe.slack.botframework.com/Actions
    Indie https://india.slack.botframework.com/Actions

  3. Vyberte volbu Uložit změny.

Kopírování informací o aplikaci

K přidání kanálu Slack do robota budete potřebovat následující informace. Přihlašovací údaje aplikace vždy kopírujte a ukládejte na bezpečném místě.

  1. Vyberte Základní informace.
  2. Ve výsledném podokně v části Přihlašovací údaje aplikace vyhledejte ID klienta, tajný klíč klienta a podpisový tajný klíč.
  3. Teď vyberte OAuth a oprávnění.
  4. Ve výsledném podokně vyhledejte oddíl Obory . Zaznamenejte obory tokenů robota pro vaši aplikaci.

Konfigurace robota v Azure

K dokončení tohoto kroku budete potřebovat přihlašovací údaje aplikace Slack z předchozího kroku.

  1. Otevřete Azure Portal.

  2. Otevřete okno prostředku robota Azure pro vašeho robota.

  3. Otevřete Kanály a vyberte Slack.

  4. V části Konfigurace kanálu Slack zadejte informace, které jste zkopírovali v předchozích krocích.

    1. Zadejte požadované přihlašovací údaje Slack pro aplikaci, kterou jste vytvořili ve Slacku.
    2. Volitelně můžete zadat adresu URL cílové stránky, na kterou budou uživatelé Slacku přesměrováni po přidání robota.
    3. Adresy URL adresy URLpro přesměrování oprávnění OAuth a žádosti o odběr událostí by se měly shodovat s hodnotami, které jste zadali ve Slacku, a přidat adresu URL pro přesměrování a přihlásit se k odběru událostí robota.

    submit credentials

  5. Vyberte Použít.

  6. Budete přesměrováni na Slack, abyste dokončili instalaci aplikace Slack.

    • Pokud požadovaná oprávnění vypadají správně, vyberte Povolit.

Robot je teď nakonfigurovaný tak, aby komunikoval s uživateli ve Slacku. Uživatelé v pracovním prostoru teď můžou s robotem pracovat prostřednictvím aplikace Slack.

Testování aplikace ve Slacku

  1. Přihlaste se k pracovnímu prostoru Slack, do kterého jste nainstalovali aplikaci.
  2. V části Aplikace vyberte aplikaci.
  3. Ve výsledném podokně odešlete zprávy do aplikace.

Další informace

Poznámka:

Od června 2020 Slack kanál podporuje obory oprávnění Slack V2, které robotovi umožňují určit své schopnosti a oprávnění podrobnějším způsobem. Všechny nově nakonfigurované kanály Slack budou používat obory V2. Pokud chcete robota přepnout na obory V2, odstraňte a znovu vytvořte konfiguraci kanálu Slack v okně Kanály webu Azure Portal.

Další informace o podpoře Slacku pro roboty najdete v dokumentaci k rozhraní SLAck API:

Připojení robota ke Slacku pomocí adaptéru Slack

Stejně jako kanál dostupný ve službě Azure AI Bot Service pro připojení robota ke Slacku definují komunitní úložiště Bot Builderu vlastní adaptér kanálu pro Slack.

  • Informace o adaptéru jazyka C# najdete v části Adaptéry v úložišti komunity .NET.
  • Informace o adaptéru JavaScriptu najdete v části Adaptéry v úložišti komunity JavaScriptu.