Conectar um bot ao SlackConnect a bot to Slack

Configure seu bot para se comunicar com as pessoas que usam o aplicativo de mensagens Slack.You can configure your bot to communicate with people using the Slack messaging app.

Criar um aplicativo Slack para o seu botCreate a Slack Application for your bot

Faça logon no Slack e crie um canal do aplicativo Slack.Log into Slack and then go to create a Slack application channel.

Configurar o bot

Criar um aplicativo e atribuir uma equipe de Desenvolvimento do SlackCreate an app and assign a Development Slack team

Insira um Nome de Aplicativo e selecione uma equipe de Desenvolvimento do Slack.Enter an App Name and select a Development Slack Team. Se você ainda não for membro de uma equipe de Desenvolvimento do Slack, crie ou ingresse em uma.If you are not already a member of a Development Slack Team, create or join one.

Criar aplicativo

Clique em Criar Aplicativo.Click Create App. O Slack criará seu aplicativo e gerará uma ID de Cliente e Segredo do Cliente.Slack will create your app and generate a Client ID and Client Secret.

Adicionar uma nova URL de RedirecionamentoAdd a new Redirect URL

Em seguida, você adicionará uma nova URL de Redirecionamento.Next you will add a new Redirect URL.

  1. Selecione a guia OAuth e Permissões.Select the OAuth & Permissions tab.
  2. Clique em Adicionar uma nova URL de Redirecionamento.Click Add a new Redirect URL.
  3. Digite https://slack.botframework.com.Enter https://slack.botframework.com.
  4. Clique em Adicionar.Click Add.
  5. Clique em Salvar URLs.Click Save URLs.

Adicionar URL de redirecionamento

Criar um Usuário de Bot do SlackCreate a Slack Bot User

Ao adicionar um Usuário de Bot, você pode atribuir um nome de usuário para o seu bot e escolher se ele sempre será mostrado como online.Adding a Bot User allows you to assign a username for your bot and choose whether it is always shown as online.

  1. Selecione a guia Usuários de Bot.Select the Bot Users tab.
  2. Clique em Adicionar um Usuário de Bot.Click Add a Bot User.

Criar bot

Clique em Adicionar Usuário de Bot para validar suas configurações, defina Sempre Mostrar meu Bot Online como Ligado e, em seguida, clique em Salvar Alterações.Click Add Bot User to validate your settings, click Always Show My Bot as Online to On, and then click Save Changes.

Criar bot

Assinar eventos de BotSubscribe to Bot Events

Execute estas etapas para assinar seis eventos de bot específicos.Follow these steps to subscribe to six particular bot events. Ao assinar eventos de bot, seu aplicativo receberá uma notificação das atividades do usuário na URL que você especificar.By subscribing to bot events, your app will be notified of user activities at the URL you specify.

Dica

Seu identificador de bot é o nome do seu bot.Your bot handle is the name of your bot. Para localizar o identificador de um bot, visite https://dev.botframework.com/bots, escolha um bot e registre o nome do bot.To find a bot's handle, visit https://dev.botframework.com/bots, choose a bot, and record the name of the bot.

  1. Selecione a guia Assinaturas de Evento.Select the Event Subscriptions tab.

  2. Defina Habilitar Eventos como Ligado.Click Enable Events to On.

  3. Na URL de solicitação, insira https://slack.botframework.com/api/Events/{YourBotHandle}, no qual {YourBotHandle} é seu identificador de bot, sem os colchetes.In Request URL, enter https://slack.botframework.com/api/Events/{YourBotHandle}, where {YourBotHandle} is your bot handle, without the braces. O identificador de bot usado neste exemplo é ContosoBot.The bot handle used in this example is ContosoBot.

    Assinar eventos: superior

  4. Em Assinar Eventos de Bot, clique em Adicionar Evento de Usuário do Bot.In Subscribe to Bot Events, click Add Bot User Event.

  5. Na lista de eventos, selecione esses seis tipos de evento:In the list of events, select these six event types:

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

    Assinar eventos: meio

  6. Clique em Salvar Alterações.Click Save Changes.

    Assinar eventos: inferior

Adicionar e configurar mensagens interativas (opcional)Add and Configure Interactive Messages (optional)

Se o seu bot usar funcionalidades específicas do Slack, como botões, execute estas etapas:If your bot will use Slack-specific functionality such as buttons, follow these steps:

  1. Selecione a guia Componentes Interativos e clique em Habilitar Componentes Interativos.Select the Interactive Components tab and click Enable Interactive Components.
  2. Insira https://slack.botframework.com/api/Actions como a URL da Solicitação.Enter https://slack.botframework.com/api/Actions as the Request URL.
  3. Clique no botão Salvar alterações.Click the Save changes button.

Habilitar mensagens

Obter credenciaisGather credentials

Selecione a guia Informações Básicas e role até a seção Credenciais de Aplicativo.Select the Basic Information tab and scroll to the App Credentials section. A ID do Cliente, o Segredo do Cliente e o Token de Verificação, necessários para a configuração do seu bot do Slack, são exibidos.The Client ID, Client Secret, and Verification Token required for configuration of your Slack bot are displayed.

Obter credenciais

Enviar credenciaisSubmit credentials

Em uma janela separada do navegador, volte para o site do Bot Framework em https://dev.botframework.com/.In a separate browser window, return to the Bot Framework site at https://dev.botframework.com/.

  1. Selecione Meus bots e escolha o Bot que você deseja conectar ao Slack.Select My bots and choose the Bot that you want to connect to Slack.
  2. Na seção Canais, clique no ícone do Slack.In the Channels section, click the Slack icon.
  3. Na seção Inserir suas credenciais do Slack, cole as Credenciais de Aplicativo do site do Slack nos campos apropriados.In the Enter your Slack credentials section, paste the App Credentials from the Slack website into the appropriate fields.
  4. A URL da Página de Aterrissagem é opcional.The Landing Page URL is optional. Você pode omitir ou alterá-la.You may omit or change it.
  5. Clique em Save (Salvar).Click Save.

Enviar credenciais

Siga as instruções para autorizar o acesso ao seu aplicativo Slack para sua equipe de Desenvolvimento do Slack.Follow the instructions to authorize your Slack app's access to your Development Slack Team.

Habilitar o botEnable the bot

Na página Configurar Slack, confirme se o controle deslizante ao lado do botão Salvar é definido como Habilitado.On the Configure Slack page, confirm the slider by the Save button is set to Enabled. Seu bot está configurado para se comunicar com os usuários no Slack.Your bot is configured to communicate with users in Slack.

Criar um botão Adicionar ao SlackCreate an Add to Slack button

O Slack fornece HTML que pode ser usado para ajudar os usuários do Slack a localizar seu bot na seção Adicionar o botão Slack desta página.Slack provides HTML you can use to help Slack users find your bot in the Add the Slack button section of this page. Para usar este HTML com o bot, substitua o valor de href (começa com https://) pela URL encontrada nas configurações do canal do Slack do seu bot.To use this HTML with your bot, replace the href value (begins with https://) with the URL found in your bot's Slack channel settings. Execute estas etapas para obter a URL de substituição.Follow these steps to get the replacement URL.

  1. Em https://dev.botframework.com/bots, clique em seu bot.On https://dev.botframework.com/bots, click your bot.
  2. Clique em Canais, clique com o botão direito na entrada Slack e clique em Copiar link.Click Channels, right-click the entry named Slack, and click Copy link. Agora, essa URL está em sua área de transferência.This URL is now in your clipboard.
  3. Copie essa URL da área de transferência e cole-a no HTML fornecido para o botão do Slack.Paste this URL from your clipboard into the HTML provided for the Slack button. Essa URL substitui o valor de href fornecido pelo Slack para este bot.This URL replaces the href value provided by Slack for this bot.

Os usuários autorizados podem clicar no botão Adicionar ao Slack fornecido por esse HTML modificado para acessar seu bot no Slack.Authorized users can click the Add to Slack button provided by this modified HTML to reach your bot on Slack.

Também disponível como um adaptadorAlso available as an adapter

Esse canal também está disponível como um adaptador.This channel is also available as an adapter. Para ajudá-lo a escolher entre um adaptador e um canal, confira Adaptadores disponíveis no momento.To help you choose between an adapter and a channel, see Currently available adapters.