Pré-requisitos para o conector Slack no Jitterbit Integration Studio

Introdução

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

Essas etapas incluem as seguintes instruções:

• Obtenha um token OAuth (necessário ao usar Autenticação baseada em Token na conexão).
• Configure OAuth de 3 etapas (necessário ao usar Código de Autorização na conexão).

Criar 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 App e depois clique em Do zero.

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

   

3. Vá para a página Incoming Webhooks (acessada pelo menu Features) e ative a opção Ativar Incoming Webhooks para On, em seguida, clique em Adicionar Novo Webhook ao Espaço de Trabalho:

   

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

   

   Nota

   A aprovação pode ser necessária de alguém que gerencia aplicativos em seu espaço de trabalho. Use o botão Solicitar Adição de Novo Webhook para enviar um pedido de aprovação.

Adicionar escopos

Siga estas etapas para adicionar escopos ao aplicativo criado:

1. Na página OAuth & Permissions (acessada pelo menu Features), vá para a seção Scopes 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 utilizadas:

   Atividade	Escopo
   Pesquisar	chat:write chat:write.customize chat:write.public conversations.connect:manage conversations.connect:read conversations.connect:write
   Postar	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
   Chat	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 estas etapas:

1. Acesse a página OAuth & Permissions a partir da seção Features do site da API do Slack.

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

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

   

   Nota

   O User OAuth Token é visível apenas quando os User Token Scopes foram adicionados ao aplicativo.

Configurar OAuth de 3 etapas

Esta seção cobre as etapas para autenticar a conexão para usar a autenticação OAuth 2.0 de 3 etapas (3LO) com um aplicativo privado configurado na página App Registrations do Console de Gerenciamento.

Aplicativos privados são aplicativos que você configura para a instância do Slack (descrito em Criar um Aplicativo Slack) e, em seguida, registra na página App Registrations do Console de Gerenciamento com estes valores do aplicativo Slack:

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

Redirect URL

Ao configurar seu aplicativo no Slack, certifique-se de que a URL de Redirecionamento esteja definida como uma das seguintes URLs (dependendo da região da sua organização):

Instructions

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

1. Configure 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 de 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 de OAuth & 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 a URL de Autenticação do aplicativo como https://slack.com/oauth/v2/authorize.

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

7. Defina a 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 Token request em Parameters, insira Accept-Encoding como a Key e */* como o Value. Em seguida, selecione Request Header no menu Send in.

   Nota

   A Access token URL é preenchida automaticamente com o valor fornecido na etapa 6 e não deve ser alterada.

9. Na aba Refresh request em Parameters, insira estes pares chave-valor:

   • Para o primeiro par chave-valor, insira Accept-Encoding como a Key e insira */* como o Value. Em seguida, selecione Request Header no menu Send in.

   • Para o segundo par chave-valor, insira grant_type como a Key e insira refresh_token como o Value. Em seguida, selecione Request URL no menu Send in.

     Nota

     A Refresh token URL é preenchida automaticamente com o valor fornecido na etapa 7 e não deve ser alterada.

Uma vez que a aplicação OAuth de 3 etapas esteja registrada na página App Registrations, ela estará disponível para ser selecionada no menu OAuth Application sob Private Applications na Slack connection.