Configurar Slack spoke.

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura

    • Integre a instância ServiceNow e sua conta do Slack criando uma aplicação OAuth personalizada no Slack para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar assinatura do Integration Hub.
    • Ativar Slack spoke.
    • Conta do Slack.
    • Adicione usuários do Slack à tabela Usuário [sys_user] da sua instância ServiceNow, com E- mail sendo o identificador exclusivo.
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O procedimento de configuração do spoke descrito aqui requer somente tokens de usuário bot. Você não pode usar as ações Criar usuário e Desativar usuário enquanto estiver usando os escopos de token de bot. Para usar essas ações, você deve obter o token do usuário da sua conta do Slack.

    Configurar aplicativo Slack

    Crie uma aplicação OAuth personalizada no espaço do Slack para habilitar a autenticação OAuth 2.0 com o Slack spoke.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Conclua essas etapas na sua conta do Slack. Você pode criar um app ou configurar um app existente de acordo com as configurações descritas aqui.

    Procedimento

    1. Crie um espaço Slack.
      Para saber como criar um espaço, consulte Criação de um espaçodo Slack.A imagem a seguir mostra um espaço típico do Slack.Espaço do Slack.
    2. Navegue até o console da API do Slack.
    3. Clique em Criar um app.
    4. Na janela Criar um app, selecione o método mais apropriado para criar o app.Crie um app no Slack.
    5. Na página Credenciais do aplicativo na página Informações básicas, copie e registre os valores de ID do cliente, Segredo do cliente e Segredo de assinatura do seu aplicativo Slack.Credenciais do aplicativo Slack.
      Para obter mais informações, consulte a etapa Obter ID e segredo do cliente para posterior.
    6. Na página OAuth e Permissões:
      1. Especifique a URL da instância ServiceNow em URLs de redirecionamento neste formato: https://<instance-name> .service-now.com/oauth_redirect.do .
      2. Adicione estes bot escopos de token:
        • canais:histórico
        • canais: gerenciar
        • canais: ler
        • chat:write
        • bate-papo:write.customize
        • grupos: ler
        • im:lido
        • mpim: ler
        • grupos:histórico
        • grupos:gravação
        • im:histórico
        • im:write
        • mpim: histórico
        • mpim:gravação
        • users:read
        • users:read.email
        • files:read

        Para obter mais informações, consulte Escopos e permissões.

        Nota:
        O procedimento de configuração do spoke descrito aqui requer somente tokens de usuário bot. Você não pode usar as ações Criar usuário e Desativar usuário enquanto estiver usando os escopos de token de bot. Para usar essas ações, você deve obter o token do usuário da sua conta do Slack.
    7. Na página Comandos de barra, crie um comando e especifique estes valores:
      Campo Valor
      Comando /agora
      Solicitar URL https://<instance-name> .service-now.com/api/sn_slack_ah_v2/command_service/<slack-app-name>
      Descrição resumida Descrição sobre o comando.
      Dica de uso Lista de parâmetros que podem ser passados. Por exemplo, [operation] [table].

      Para obter mais informações, consulte a etapa Criação de um comando de barra.

    8. Na página Interatividade e Atalhos:
      1. Habilite a Interatividade e especifique a URL da instância ServiceNow em Solicitar URL neste formato: https:// <instance-name> .service-now.com/api/sn_slack_ah_v2/slack/<slack-app-name>/interactivepayload .
        Para obter mais informações, consulte a seção Como preparar seu app para interações com o usuário.
      2. Crie um atalho que aparece em mensagens e insira o valor post_message_now para IDde retorno de chamada .
        Para obter mais informações, consulte a seção Como criar um atalho.
    9. Crie um bot do Slack e adicione-o ao aplicativo Slack e aos canais necessários.
      Para obter mais informações, consulte Criar um bot para o seu espaço.

    Adicionar conexão do Slack na instância ServiceNow

    Adicione a conexão do Slack em Workflow Studio para configurar o spoke do Slack.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Flow Designer > Designer.
    2. Clique em Conexões.
      Nota:
      Você pode adicionar várias conexões ao spoke do Slack; um para cada espaço do Slack.
      Conexão do spoke do Slack.
    3. No bloco Spoke do Slack, clique em Exibir detalhes.
    4. Na página Conexões, clique em Configurar.
      A janela pop-up exibe um formulário em branco Configurar conexão.
    5. No formulário, preencha estes valores.
      Tabela 1. Formulário "Configurar conexão"
      Campo Descrição
      URL de Conexão URL para se conectar ao Slack. Insira https://slack.com.
      Nome da Credencial Nome para identificar o registro de credencial. Por exemplo, Slack Cred.
      Nome do OAuth Nome para identificar o registro OAuth. Por exemplo, Slack OAuth.
      ID do cliente OAuth ID de cliente do aplicativo Slack.
      Segredo do cliente OAuth Segredo do cliente do seu aplicativo Slack.
      URL de redirecionamento do OAuth URL de redirecionamento fornecido no aplicativo Slack. Este valor é preenchido automaticamente.
    6. Clique em Configurar e obter token do OAuth.
    7. Na janela pop-up, clique em Permitir.
      O token de acesso do OAuth é gerado para o spoke do Slack.

    Fornecer chave de assinatura na instância ServiceNow

    Forneça Slack detalhes do app e a chave de assinatura em sua instância ServiceNow para autenticar solicitações de ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Slack > Configurações do Slack.
    2. Abra o registro padrão.
      Você também pode criar um novo registro para fornecer outras chaves de assinatura.
    3. No formulário, preencha estes valores.
      Tabela 2. Formulário de configuração do Slack
      Campo Descrição
      Slack Aplicação Nome do seu app Slack.
      Nota:
      Este nome deve ser igual ao nome do app fornecido ao criar o app Slack.
      Alias de conexão Alias de conexão associado ao app selecionado na guia Conexões.
      Nome da Propriedade Nome da configuração Slack. Insira o segredo da assinatura.
      Assinando segredo Segredo de assinatura do seu app Slack.
    4. Clique em Atualizar.

    Definir configurações de saída na instância ServiceNow

    Especifique eventos na instância ServiceNow para os quais as ações devem ser executadas em sua aplicação Slack spoke.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    As configurações de saída fornecem um modelo para as ações Publicar mensagem acionável e Publicar mensagem de aprovação e subfluxos. Você pode personalizar as configurações de saída padrão ou criar uma configuração de saída de acordo com seus requisitos.

    Procedimento

    1. Navegar até Todos > Slack > Configurações de saída.
    2. Clique em Novo para criar um modelo de configuração de saída ou clique na configuração de saída padrão para configurá-la.
    3. No formulário Configuração de saída, preencha estes valores.
      Tabela 3. Formulário Configuração de saída
      Campo Descrição
      Nome Nome para identificar o registro de configuração de saída.
      Título da mensagem Título da mensagem publicada no canal Slack spoke. Por exemplo, Aprovações pendentes para {0}.
      Tabela de destino ServiceNow tabela da qual os detalhes do registro são recuperados.
      Campos Campos da tabela ServiceNow cujos valores devem ser exibidos na mensagem publicada no canal Slack spoke.
      Botões Botões para os usuários relevantes realizarem ações no canal Slack spoke. Por exemplo, Aprove ou Rejeite uma solicitação. Para obter mais informações sobre botões e seu estilo, consulte Elemento de botão.
      Nota:
      Os usuários devem ter as permissões necessárias para executar as ações necessárias. Por exemplo, o usuário deve ter as permissões necessárias para aprovar ou rejeitar uma solicitação. Essas permissões são baseadas em funções de usuário atribuídas a usuários em sua instância ServiceNow.
      Lista de Seleção Opções de saída do Slack, como Rejeitar. Essas opções são exibidas como uma lista no canal do Slack.
      ID de ação Identificador exclusivo da configuração de saída.
      Nota:
      O ID da ação da configuração de saída deve ser usado na decisão de entrada relevante para concluir o fluxo. Por exemplo, o ID da ação da configuração de saída da Mensagem de aprovação é fornecido na decisão de entrada da Decisão de aprovação. Isso garante que, após a aprovação ou rejeição da solicitação, a atualização seja feita no registro relevante em sua instância ServiceNow.
    4. Clique em Enviar.

    Configurar decisões de entrada na instância ServiceNow

    Especifique eventos em sua aplicação Slack spoke para os quais as ações devem ser executadas na instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Slack > Decisões de entrada.
    2. Clique em Nova.
    3. No formulário Decisão, preencha estes valores.
      Tabela 4. Formulário de decisão
      Campo Descrição
      Rótulo Nome para identificar a decisão de entrada.
      Resposta Subfluxo que deve ser acionado quando as condições especificadas são atendidas.
      Resposta padrão Opção para especificar se esta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas.
      1. Clique no ícone de pesquisa ( ícone de pesquisa).
      2. Selecione o subfluxo necessário na lista Documento.
        Nota:
        Certifique-se de que o nome da tabela seja Fluxo [sys_hub_flow].
      Condição Condições a serem atendidas em sua aplicação Slack, para a qual as ações devem ser executadas na instância ServiceNow.
      Para atualizar o registro relevante em sua instância ServiceNow, especifique o valor do ID da ação que você forneceu ao definir as configurações de saída na condição.
      Nota:
      O ID da ação da configuração de saída deve ser usado na decisão de entrada relevante para concluir o fluxo. Por exemplo, o ID da ação da configuração de saída da Mensagem de aprovação é fornecido na decisão de entrada da Decisão de aprovação. Isso garante que, após a aprovação ou rejeição da solicitação, a atualização seja feita no registro relevante em sua instância ServiceNow.
    4. Clique em Enviar.
      Quando os eventos atendem às condições especificadas na política, o subfluxo associado é acionado.
      Nota:
      Essas decisões de entrada são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados dessas tabelas.
      Se você quiser exibir modais no Slack, consulte Configurar modais ServiceNowSlack na instância [].