Ação Conectar no package Slack

Faça a autenticação no Slack usando uma conexão OAuth2 da Control Room e crie uma sessão reutilizável do Slack para ações posteriores na automação.

Pré-requisito

Antes de usar a ação Conectar, você deve primeiro criar e configurar um aplicativo Slack, gerar o token de Bot necessário e configurar uma conexão OAuth na Control Room, concluindo o seguinte pré-requisito:

Crie um aplicativo Slack
  • Acesse o Portal do Desenvolvedor do Slack: https://api.slack.com/apps
  • Navegue para Seus aplicativos > Criar novo aplicativo
  • Escolha Do zero.

    Criar um aplicativo

  • Digite o seguinte:
    • Nome do aplicativo: Por exemplo, Integração do AA com o Slack
    • Escolha um espaço de trabalho para desenvolver seu aplicativo: selecione o espaço de trabalho do Slack onde o aplicativo será usado

    Escolher espaço de trabalho

  • Clique em Criar aplicativo.
Configurar OAuth e permissões
  • Depois que o aplicativo for criado, no painel à esquerda, navegue até OAuth e permissões.
  • Navegue até a seção Redirecionar URLs. No campo Redirecionar URLs, insira o URL de callback das configurações de conexão da Control Room.
  • Navegue até a seção Escopos.

Adicionar escopos de token do Bot: na seção Escopos, adicione as permissões necessárias dependendo do seu caso de uso. Para adicionar, clique em Adicionar um escopo OAuth.

Alguns exemplos estão listados abaixo:
  • chat:write → Enviar mensagens como @AA Slack integration
  • channels:read → Visualizar informações básicas sobre canais públicos em um espaço de trabalho
  • channels:history → Visualizar mensagens e outros conteúdos em canais públicos aos quais a Integração da AA com o Slack foi adicionada
  • groups:read → Visualizar informações básicas sobre canais privados aos quais a Integração da AA com o Slack foi adicionada
  • im:read → Visualizar informações básicas sobre mensagens diretas às quais a Integração da AA com o Slack foi adicionada.
Nota:
  • Certifique-se de escolher seus escopos com cuidado, pois escopos insuficientes podem fazer com que as ações falhem posteriormente.
  • Atualmente, somente a autenticação por Token de Bot é compatível.

Configurar a conexão OAuth 2.0: Para obter informações sobre como criar um provedor personalizado, consulte Configure a conexão do OAuth 2.0 na Control Room.

Configurações

  • No campo Conexão OAuth, clique em Escolher para escolher entre as credenciais OAuth2 gerenciadas pela Control Room disponíveis.
    Nota: Certifique-se de que a conexão OAuth2 esteja válida e ativa na Control Room.
  • Clique no menu suspenso Tipo de provedor para selecionar um provedor disponível ou personalizável.
  • No campo Nome da conexão, selecione o objeto de conexão OAuth específico.

    Esse campo ficará desabilitado até que um Tipo de provedor seja selecionado.

  • No campo Tipo de token, selecione uma das seguintes opções dependendo do token que será usado em tempo de execução.
    • Compartilhado: para um token global.

      Um token de acesso do tipo compartilhado é criado quando uma conexão com a Control Room for estabelecida. Esse token de acesso é armazenado como uma credencial. Quando você executa a automação, o token de acesso é referenciado na automação usando o tipo de provedor de aplicativo empresarial configurado no arquivo de Control Room.

    • Específico do usuário: para um token específico de um usuário.
  • No campo Sessão do Slack, use uma das seguintes guias para criar uma sessão:
    • No campo Sessão local, especifique um nome de sessão que possa ser usado apenas no bot atual.
    • Sessão global: para especificar um nome de sessão que possa ser usado em vários bots, como bots principais, bots secundários e todos os outros bots secundários do bot principal.

      Recomendação: os bots principais e secundários devem ter a mesma versão do pacote.

    • Variável: para especificar uma variável de sessão do Slack.

      Clique no ícone à direita para criar uma variável e, em seguida, escolha Sessão do Slack como o Tipo de sessão na janela que aparecer. Consulte Criar uma variável.