Pré-requisitos do Slack

Introdução

Estes são os pré-requisitos para usar o conector Slack. Primeiro você cria um aplicativo Slack no espaço de trabalho selecionado e, em seguida, adicionar escopos para o aplicativo criado.

Estas etapas incluem estas instruções:

• Obter um token OAuth (necessário ao usar Autenticação baseada em token na conexão).
• Configurar OAuth de 3 pernas (obrigatório ao usar Authorization Code Grant na conexão).

Crie um aplicativo Slack

Siga estas etapas para criar um aplicativo Slack no espaço de trabalho selecionado:

1. No site da API do Slack, clique em Criar um aplicativo e depois em Do zero.

2. Forneça um nome para seu aplicativo, selecione um espaço de trabalho e clique em Criar aplicativo:

   

3. Vá para a página Webhooks de entrada (acessada no menu Recursos) e alterne a opção Ativar Webhooks de entrada para Ativado e clique em Adicionar novo webhook ao espaço de trabalho:

   

4. No menu, selecione o canal do Slack onde você deseja postar mensagens e clique em Permitir:

   

   Nota

   Pode ser necessária aprovação de alguém que gerencia aplicativos no seu espaço de trabalho. Use o botão Solicitar para adicionar novo webhook para enviar uma solicitação de aprovação.

Adicionar escopos

Siga estas etapas para adicionar escopos ao aplicativo criado:

1. Na página OAuth e Permissões (acessada no menu Recursos), vá para a seção Escopos e clique em Adicionar um escopo OAuth na seção Escopos de token de bot ou Escopos de token de usuário (dependendo do tipo de token que você está usando):

   

2. Adicione esses escopos dependendo das atividades a serem usadas:

   Atividade	Escopo
   Pesquisar	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Postagem	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write
   Bate-papo	conversations.connect:manage conversations.connect:read
   Obter	calls:read calls:write chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write dnd:read files:read files:write remote_files:read remote_files:share remote_files:write pins:read pins:write reactions:read reactions:write reminders:read reminders:write usergroups:read usergroups:write users.profile:read users:read users:read.email users:write team.billing:read team.preferences:read team:read workflow.steps:execute
   Arquivos	files:read files:write remote_files:read remote_files:share remote_files:write
   Conversas	conversations.connect:manage conversations.connect:read conversations.connect:write
   Usuários	users.profile:read users:read users:read.email users:write

Obter um token OAuth

Se você estiver autenticando a conexão com um token de bot ou token de usuário, siga estes passos:

1. Acesse a página OAuth e Permissões acessada no site da API do Slack Seção Recursos.

2. Para obter um token de bot, copie o Bot User OAuth Token (prefixado com xoxb) em Tokens OAuth.

   Para obter um token de usuário, copie o User OAuth Token (prefixado com xoxp) em Tokens OAuth:

   

   Nota

   O User OAuth Token fica visível somente quando User Token Scopes foram adicionados ao aplicativo.

Configurar OAuth de 3 pernas

Esta seção abrange as etapas para autenticar a conexão para usar a autenticação OAuth 2.0 de três pernas (3LO) com um aplicativo privado configurado no Management Console Registros de aplicativos página.

Os aplicativos privados são aplicativos que você configura para a instância do Slack (descritos em Criar um aplicativo Slack) e então registre-se no Management Console Registros de Aplicativos página com esses valores do aplicativo Slack:

• ID do cliente e segredo do cliente
• Escopos
• URL de autorização
• URL do token de acesso
• Atualizar URL do token

URL de redirecionamento

Ao configurar seu aplicativo no Slack, certifique-se de que o URL de redirecionamento esteja definido como um dos seguintes URLs (dependendo da região da sua organização):

Instruções

Estas são as instruções para obter os valores necessários para o registro do aplicativo:

1. Configurar um aplicativo OAuth para a instância do Slack.

2. Navegue até seu aplicativo no site da API do Slack.

3. Para obter o ID do cliente e o segredo do cliente para o registro do aplicativo, vá para a página Informações básicas do seu aplicativo Slack. Os valores estão localizados na seção Credenciais do aplicativo:

   

4. Para obter os Escopos para o registro do aplicativo, vá para a página OAuth e Permissões do seu aplicativo Slack, navegue até a seção Escopos e obtenha os escopos usados para o aplicativo. Na configuração do registro do aplicativo, insira cada um dos escopos do aplicativo em seu formato de código, por exemplo, read:me.

5. Defina o URL de autenticação do aplicativo como https://slack.com/oauth/v2/authorize.

6. Defina o URL do token de acesso do aplicativo como https://slack.com/api/oauth.v2.access.

7. Defina o URL do token de atualização do aplicativo como https://slack.com/api/oauth.v2.access.

8. Vá para Opções avançadas.

   Na aba Solicitação de token em Parâmetros, insira Accept-Encoding como a Chave e */* como o Valor. Em seguida, selecione Cabeçalho de solicitação no menu Enviar para.

   Nota

   O URL do token de acesso é preenchido previamente com o valor fornecido na etapa 6 e não deve ser alterado.

9. Na abaSolicitação de atualização em Parâmetros, insira estes pares de chave-valor:

   • Para o primeiro par chave-valor, insira Accept-Encoding como a Chave e digite */* como o Valor. Em seguida, selecione Cabeçalho da Solicitação no menu Enviar.

   • Para o segundo par chave-valor, insira grant_type como a Chave e digite refresh_token como o Valor. Em seguida, selecione Solicitar URL no menu Enviar.

     Nota

     O URL do token de atualização é preenchido previamente com o valor fornecido na etapa 7 e não deve ser alterado.

Depois que o aplicativo OAuth de 3 etapas for registrado em Registros de aplicativos página está disponível para ser selecionada no menu Aplicativo OAuth em Aplicativos Privados na conexão Slack.