Conectar um bot ao Slack

APLICA-SE A: SDK v4

Você pode configurar seu bot para se comunicar com as pessoas por meio do aplicativo Slack. Este artigo descreve como criar um aplicativo do Slack usando o Slack, conectar seu bot ao seu aplicativo do Slack no Azure e testar seu bot no Slack.

Este artigo mostra como adicionar um canal do Slack ao seu bot no portal do Azure. Para obter informações sobre como usar um adaptador de canal personalizado, confira Informações adicionais.

Pré-requisitos

• Uma assinatura do Azure. Se ainda não tiver uma, crie uma conta gratuita antes de começar.
• Um bot publicado no Azure que você deseja conectar ao Slack.
• Acesso a um workspace do Slack com permissões suficientes para criar e gerenciar aplicativos em https://api.slack.com/apps. Se você não tiver acesso a um ambiente do Slack, poderá criar um espaço de trabalho gratuitamente.

Criar um aplicativo no Slack

Primeiro, você cria um aplicativo no Slack, que gera as informações necessárias para configurar o canal do Slack para seu bot no Azure.

1. Acesse o painel Aplicativos e inicie sessão na sua conta do Slack.
2. Selecione Criar novo aplicativo ou Criar um aplicativo se este for seu primeiro aplicativo.
   1. Na página Criar um aplicativo, selecione Do zero.
   2. Na página Nome do aplicativo e escolha o espaço de trabalho , em Nome do aplicativo, insira o nome do aplicativo Slack.
   3. Em Escolha um espaço de trabalho para desenvolver seu aplicativo em, selecione um espaço de trabalho para seu aplicativo.
   4. Revise os termos de serviço da API do Slack e concorde com eles.
   5. Selecione Criar Aplicativo.

Adicionar uma nova URL de redirecionamento

Depois que o aplicativo for criado, adicione uma URL de redirecionamento ao seu aplicativo.

1. Selecione OAuth e Permissões.

2. No painel resultante, em URLs de redirecionamento, selecione Adicionar uma nova URL de redirecionamento.

3. Na caixa de entrada, insira uma das seguintes URLs de redirecionamento e selecione Adicionar.

   • Em um bot global, insira https://slack.botframework.com.
   • Para um bot regional, insira o seguinte url de acordo com a região selecionada:

   Region	URL de Redirecionamento
   Europa	https://europe.slack.botframework.com
   Índia	https://india.slack.botframework.com

4. Selecione Salvar URLs.

Assinar eventos de Bot

Depois de adicionar a URL de redirecionamento, inscreva seu aplicativo em eventos de bot para que o Slack notifique seu bot sobre as atividades do usuário na URL especificada. Assine eventos com base nos recursos que seu bot usará no Slack.

1. Selecione Assinaturas de evento.

2. No painel resultante, alterne Habilitar eventos para Ativado.

3. Para URL de Solicitação, insira uma das seguintes URLs de solicitação, onde {bot-name} é o nome de exibição do recurso Bot do Azure, sem as chaves.

   • Em um bot global, insira https://slack.botframework.com/api/Events/{bot-name}.
   • Para um bot regional, insira o seguinte url de acordo com a região selecionada:

   Region	URL de solicitação
   Europa	https://europe.slack.botframework.com/api/Events/{bot-name}
   Índia	https://india.slack.botframework.com/api/Events/{bot-name}

4. Em Assinar em eventos de bot, selecione Adicionar evento de usuário de bot e inscreva-se em eventos. Por exemplo:

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

5. Selecione Salvar alterações.

Habilitar o envio de mensagens ao bot pelos usuários

Depois de assinar eventos de bot, habilite os usuários a enviar mensagens para seu bot.

1. Selecione Início do aplicativo.
2. No painel resultante, na seção Mostrar guias na Guia de Mensagens, habilite Permitir que os usuários enviem comandos de barra e mensagens da guia mensagens.

Adicionar e configurar mensagens interativas

Opcionalmente, habilite mensagens interativas.

1. Selecione Interatividade e atalhos.

2. Para URL de solicitação:

   • Em um bot global, insira https://slack.botframework.com/api/Actions.
   • Para um bot regional, insira o seguinte url de acordo com a região selecionada:

   Region	URL de solicitação
   Europa	https://europe.slack.botframework.com/Actions
   Índia	https://india.slack.botframework.com/Actions

3. Selecione Salvar alterações.

Copiar as informações do seu aplicativo

Você precisará das seguintes informações para adicionar o canal do Slack ao seu bot. Sempre copie e armazene as credenciais do aplicativo em um local seguro.

1. Selecione Informações básicas.
2. No painel resultante, em Credenciais do Aplicativos, localize ID do Cliente, Segredo do Cliente e Segredo da Assinatura.
3. Agora, selecione OAuth e Permissões.
4. No painel resultante, localize a seção Escopos. Registre os escopos de token de bot para seu aplicativo.

Configure seu bot no Azure

Para concluir esta etapa, você precisará das credenciais do aplicativo Slack da etapa anterior.

1. Abra o Portal do Azure.

2. Kudu a folha do recurso de Bot do Azure para o seu bot.

3. Abra Canais e selecione Slack.

4. Em Configuração do canal do Slack, insira as informações copiadas nas etapas anteriores.

   1. Insira as credenciais necessárias do Slack para o aplicativo que você criou no Slack.
   2. Opcionalmente, forneça uma URL da página de aterrissagem para a qual os usuários do Slack serão redirecionados depois que adicionarem seu bot.
   3. Os valores do URL de redirecionamento de OAuth e permissões e do URL de solicitação de assinatura de evento devem corresponder aos valores inseridos no Slack para adicionar o URL de redirecionamento e se inscrever em eventos de bot.

   

5. Escolha Aplicar.

6. Você será redirecionado para o Slack para concluir a instalação do aplicativo Slack.

   • Se as permissões solicitadas parecerem corretas, selecione Permitir.

Agora, seu bot está configurado para se comunicar com os usuários no Slack. Os usuários no espaço de trabalho agora podem interagir com seu bot por meio do aplicativo Slack.

Testar seu aplicativo no Slack

1. Inicie sessão no espaço de trabalho do Slack onde você instalou seu aplicativo.
2. Em Aplicativos, selecione seu aplicativo.
3. No painel resultante, envie mensagens para o aplicativo.

Informações adicionais

Observação

A partir de junho de 2020, o canal do Slack oferece suporte a escopos de permissão do Slack V2, que permitem que o bot especifique seus recursos e permissões de forma mais granular. Todos os canais do Slack recém-configurados usarão os escopos V2. Para alternar seu bot para os escopos V2, exclua e recrie a configuração do canal do Slack na folha Canais do portal do Azure.

Para obter mais informações sobre o suporte do Slack para bots, confira a documentação da API do Slack:

• Docs e guias do desenvolvedor
• Escopos de permissão
• Reconhecimento dos escopos OAuth para Bots

Conectar um bot ao Slack usando o adaptador do Slack

Além do canal disponível no Serviço de Bot de IA do Azure para conectar seu bot ao Slack, os repositórios da Comunidade do Bot Builder definem um adaptador de canal personalizado para o Slack.

• Para obter informações sobre o adaptador C#, confira a seção Adaptadores no repositório da comunidade .NET.
• Para obter informações sobre o adaptador JavaScript, confira a seção Adaptadores no repositório da comunidade JavaScript.