Configurar Slack spoke.

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. 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 IntegrationHub.
    • Ativar Slack spoke.
    • Conta do Slack.
    • Adicione usuários do Slack à tabela Usuário [sys_user] da sua instância ServiceNow, sendo o e- mail 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 de 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 app 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 os contornos de configuração aqui.

    Procedimento

    1. Crie um espaço Slack.
      Para saber como criar um espaço, consulte Criar um espaço do 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 uma aplicação.
    4. Na janela Criar uma aplicação, selecione o método mais apropriado para criar a aplicação.Crie uma aplicação no Slack.
    5. Na página Credenciais do app na página de Informações básicas, copie e registre os valores de ID do cliente, Segredo do cliente e Segredo de assinatura do app Slack.Credenciais do app Slack.
      Para obter mais informações, consulte a etapa Obter ID e segredo do cliente para mais tarde.
    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 escopos de token bot:
        • canais:histórico
        • canais: gerenciar
        • canais: ler
        • chat:write
        • bate-papo: write.customize
        • grupos: ler
        • im: ler
        • mpim: ler
        • grupos:histórico
        • grupos: gravar
        • im:histórico
        • im:write
        • mpim:histórico
        • mpim:write
        • 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 de 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 do comando.
      Dica de uso Lista de parâmetros que podem ser passados. Por exemplo, [operation] [table].

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

    8. Na página Interatividade e Atalhos:
      1. Habilite a interatividade e especifique a URL da instância ServiceNow na URL de solicitação 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 Preparar seu app para interações do usuário.
      2. Crie um atalho que apareça nas mensagens e insira o valor post_message_now para o 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 Flow Designer 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 de 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 app Slack.
      Segredo do cliente OAuth Segredo do cliente do app Slack.
      URL de redirecionamento do OAuth URL de redirecionamento fornecido na aplicação 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 os detalhes do app Slack e a chave de assinatura na 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 Configuração do Slack
      Campo Descrição
      Slack App Nome da sua aplicação Slack.
      Nota:
      Este nome deve ser igual ao nome da aplicação fornecido ao criar a aplicação 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 da sua aplicação 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 na 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 esses 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, Aprovar ou Rejeitar 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 na sua instância ServiceNow.
    4. Clique em Enviar.

    Configurar decisões de entrada na instância ServiceNow

    Especifique eventos na aplicação Slack spoke para os quais as ações devem ser realizadas 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 de decisão, preencha esses 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 forem 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 na aplicação Slack para as quais as ações devem ser realizadas na instância ServiceNow.
      Para atualizar o registro relevante na 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 na 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 nessas tabelas.
      Se você quiser exibir modais no Slack, consulte Configurar modais ServiceNowSlack na instância [].