Dela via

Ansluta en robot till Slack

  • Artikel

GÄLLER FÖR: SDK v4

Du kan konfigurera roboten så att den kommunicerar med personer via en Slack-app. Den här artikeln beskriver hur du skapar en Slack-app med Slack, ansluter din robot till din Slack-app i Azure och testar din robot i Slack.

Den här artikeln visar hur du lägger till en Slack-kanal i roboten i Azure Portal. Information om hur du använder ett anpassat kanalkort finns i Ytterligare information.

Förutsättningar

  • En Azure-prenumeration. Om du inte redan har ett skapar du ett kostnadsfritt konto innan du börjar.
  • En robot publicerad i Azure som du vill ansluta till Slack.
  • Åtkomst till en Slack-arbetsyta med tillräcklig behörighet för att skapa och hantera program på https://api.slack.com/apps. Om du inte har åtkomst till en Slack-miljö kan du skapa en arbetsyta.

Skapa en app i Slack

Först skapar du ett program i Slack som genererar den information du behöver för att konfigurera Slack-kanalen för din robot i Azure.

  1. Gå till panelen Dina appar och logga in på ditt Slack-konto.
  2. Välj Skapa ny app eller Skapa en app om det här är ditt första program.
    1. På sidan Skapa en app väljer du Från början.
    2. På sidan Namnapp och välj arbetsyta anger du namnet på slack-programmet för Appnamn.
    3. Välj en arbetsyta för att utveckla din app i för att välja en arbetsyta för din app.
    4. Granska och godkänn slack-API:ets tjänstvillkor.
    5. Välj Skapa app.

Lägga till en ny omdirigerings-URL

När appen har skapats lägger du till en omdirigerings-URL till din app.

  1. Välj OAuth & Behörigheter.

  2. I det resulterande fönstret går du till Omdirigerings-URL:er och väljer Lägg till en ny omdirigerings-URL.

  3. I indatarutan anger du någon av följande omdirigerings-URL:er och väljer Lägg till.

    • För en global robot anger du https://slack.botframework.com.
    • För en regional robot anger du följande URL enligt den valda regionen:
    Region Omdirigerings-URL
    Europa https://europe.slack.botframework.com
    Indien https://india.slack.botframework.com

  4. Välj Spara URL:er.

Prenumerera på robothändelser

När du har lagt till omdirigerings-URL:en prenumererar du på robothändelser så att Slack meddelar din robot om användaraktiviteter på den URL du anger. Prenumerera på händelser baserat på de funktioner som din robot använder i Slack.

  1. Välj Händelseprenumerationer.

  2. I det resulterande fönstret växlar du Aktivera händelser till På.

  3. För Url för begäran anger du någon av följande url:er för begäran, där {bot-name} är visningsnamnet för din Azure Bot-resurs, utan klammerparenteser.

    • För en global robot anger du https://slack.botframework.com/api/Events/{bot-name}.
    • För en regional robot anger du följande URL enligt den valda regionen:
    Region Begärans-URL
    Europa https://europe.slack.botframework.com/api/Events/{bot-name}
    Indien https://india.slack.botframework.com/api/Events/{bot-name}

  4. Under Prenumerera på robothändelser väljer du Lägg till robotanvändarhändelse och prenumererar sedan på händelser. Till exempel:

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

  5. Välj Spara ändringar.

Aktivera att skicka meddelanden till roboten av användarna

När du prenumererar på robothändelser gör du det möjligt för användare att skicka meddelanden till din robot.

  1. Välj App startsida.
  2. I den resulterande rutan i avsnittet Visa flikar under fliken Meddelanden aktiverar du Tillåt användare att skicka snedstreckskommandon och meddelanden från fliken Meddelanden.

Lägga till och konfigurera interaktiva meddelanden

Du kan också aktivera interaktiva meddelanden.

  1. Välj Interaktivitet och genvägar.

  2. För begärande-URL:

    • För en global robot anger du https://slack.botframework.com/api/Actions.
    • För en regional robot anger du följande URL enligt den valda regionen:
    Region Begärans-URL
    Europa https://europe.slack.botframework.com/Actions
    Indien https://india.slack.botframework.com/Actions

  3. Välj Spara ändringar.

Kopiera din appinformation

Du behöver följande information för att lägga till Slack-kanalen i roboten. Kopiera och lagra alltid autentiseringsuppgifter för appar på en säker plats.

  1. Välj Grundläggande information.
  2. I den resulterande rutan under Appautentiseringsuppgifter letar du upp klient-ID, klienthemlighet och signeringshemlighet.
  3. Välj nu OAuth & Behörigheter.
  4. Leta upp avsnittet Omfång i det resulterande fönstret. Registrera omfången för bottoken för din app.

Konfigurera din robot i Azure

För att slutföra det här steget behöver du dina autentiseringsuppgifter för Slack-programmet från föregående steg.

  1. Öppna Azure Portal.

  2. Öppna bladet Azure Bot-resurs för din robot.

  3. Öppna Kanaler och välj Slack.

  4. I Slack Channel Configuration anger du den information som du kopierade i föregående steg.

    1. Ange de slack-autentiseringsuppgifter som krävs för det program som du skapade i Slack.
    2. Du kan också ange en URL för landningssidan som Slack-användare omdirigeras till när de har lagt till din robot.
    3. Värdena för omdirigering av OAuth och behörigheter och URL-värden för händelseprenumerationsbegäran ska matcha de värden som du angav i Slack för att lägga till omdirigerings-URL:en och prenumerera på robothändelser.

  5. Välj Använd.

  6. Du omdirigeras till Slack för att slutföra installationen av Slack-appen.

    • Om de begärda behörigheterna ser korrekta ut väljer du Tillåt.

Roboten har nu konfigurerats för att kommunicera med användare i Slack. Användare på arbetsytan kan nu interagera med din robot via Slack-appen.

Testa ditt program i Slack

  1. Logga in på Slack-arbetsytan där du installerade appen.
  2. Under Appar väljer du din app.
  3. I den resulterande rutan skickar du meddelanden till programmet.

Ytterligare information

Kommentar

Från och med juni 2020 stöder Slack-kanalen Slack V2-behörighetsomfång, vilket gör att roboten kan ange dess funktioner och behörigheter på ett mer detaljerat sätt. Alla nyligen konfigurerade Slack-kanaler använder V2-omfången. Om du vill växla roboten till V2-omfången tar du bort och återskapar Slack-kanalkonfigurationen på bladet Azure Portal Kanaler.

Mer information om Slack-stöd för robotar finns i Slack API-dokumentationen:

Ansluta en robot till Slack med hjälp av Slack-adaptern

Förutom den kanal som är tillgänglig i Azure AI Bot Service för att ansluta din robot till Slack definierar Bot Builder Community-lagringsplatserna ett anpassat kanalkort för Slack.

  • Mer information om C#-adaptern finns i avsnittet Adaptrar i .NET Community-lagringsplatsen.
  • Information om JavaScript-adaptern finns i avsnittet Adaptrar i JavaScript Community-lagringsplatsen.