Conectar um bot ao Slack

  • Artigo

APLICA-SE A: SDK v4

Você pode configurar seu bot para se comunicar com as pessoas por meio de um aplicativo Slack. Este artigo descreve como criar um aplicativo do Slack usando o Slack, conectar seu bot ao 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, consulte Informações adicionais.

Pré-requisitos

  • Uma subscrição 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 espaço de trabalho 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.

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. Aceda ao painel Aplicações 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 & escolher espaço de trabalho , em Nome do aplicativo, digite o nome do seu aplicativo Slack.
    3. Em Escolha um espaço de trabalho para desenvolver seu aplicativo, selecione um espaço de trabalho para seu aplicativo.
    4. Analise e concorde com os termos de serviço da API do Slack.
    5. Selecione Criar Aplicação.

Adicionar um novo URL de redirecionamento

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

  1. Selecione OAuth & Permissões.

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

  3. Na caixa de entrada, insira um dos seguintes URLs de redirecionamento e selecione Adicionar.

    • Para um bot global, digite https://slack.botframework.com.
    • Para um bot regional, insira o seguinte url de acordo com a região selecionada:
    País/Região URL de redirecionamento
    Europa https://europe.slack.botframework.com
    Índia https://india.slack.botframework.com

  4. Selecione Salvar URLs.

Inscrever-se em eventos de bots

Depois de adicionar o URL de redirecionamento, inscreva seu aplicativo em eventos de bot para que o Slack notifique seu bot sobre as atividades do usuário no URL especificado. Inscreva-se em eventos com base nos recursos que seu bot usará no Slack.

  1. Selecione Assinaturas de eventos.

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

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

    • Para um bot global, digite https://slack.botframework.com/api/Events/{bot-name}.
    • Para um bot regional, insira o seguinte url de acordo com a região selecionada:
    País/Região URL do Pedido
    Europa https://europe.slack.botframework.com/api/Events/{bot-name}
    Índia https://india.slack.botframework.com/api/Events/{bot-name}

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

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

  5. Selecione Guardar Alterações.

Habilitar o envio de mensagens para o bot pelos usuários

Depois de se inscrever em eventos de bot, permita que os usuários enviem mensagens para seu bot.

  1. Selecione Página inicial do aplicativo.
  2. No painel resultante, na seção Mostrar Guias , na guia 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 & Atalhos.

  2. Para URL de solicitação:

    • Para um bot global, digite https://slack.botframework.com/api/Actions.
    • Para um bot regional, insira o seguinte url de acordo com a região selecionada:
    País/Região URL do Pedido
    Europa https://europe.slack.botframework.com/Actions
    Índia https://india.slack.botframework.com/Actions

  3. Selecione Guardar alterações.

Copiar as informações do 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 Aplicativo, localize ID do Cliente, Segredo do Cliente e Segredo de Assinatura.
  3. Agora, selecione OAuth & Permissões.
  4. No painel resultante, localize a seção Escopos . Registre os escopos de token de bot para seu aplicativo.

Configurar 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. Abra a folha de recursos do Bot do Azure para 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 um URL da página de destino para o qual os usuários do Slack serão redirecionados depois de adicionarem seu bot.
    3. Os valores OAuth & Permissions Redirect URL e Event Subscription Request URL devem corresponder aos valores inseridos no Slack para adicionar a URL de redirecionamento e assinar eventos de bot.

    submit credentials

  5. Selecione 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.

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

Teste sua aplicação no Slack

  1. Entre no espaço de trabalho do Slack onde você instalou seu aplicativo.
  2. Em Aplicações, selecione a sua aplicação.
  3. No painel resultante, envie mensagens para o aplicativo.

Informações adicionais

Nota

Desde junho de 2020, o canal Slack suporta 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, consulte a documentação da API do Slack:

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 Construtor de Bot definem um adaptador de canal personalizado para o Slack.

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