Slack Spoke

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 8 min. de leitura

    • Use o spoke Slack para publicar mensagens e gerenciar o acesso aos canais.

    Assinatura do IntegrationHub

    Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub. Para saber mais sobre a assinatura, entre em contato com seu gerente de conta.

    Versão do spoke

    O Slack spoke v 1.6.0 é a versão mais recente.

    Requisitos da conta do Slack

    O spoke Slack requer a criação de um espaço e um app personalizado na sua conta Slack para gerar os tokens OAuth 2.0 para o spoke do Slack. Consulte Configurar app Slack.
    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.

    Subfluxos do spoke

    O spoke Slack fornece alguns subfluxos de amostra para demonstrar a automação das tarefas do espaço Slack. Para personalizar um subfluxo de amostra, copie-o para um novo escopo da aplicação. Os subfluxos de amostra disponíveis incluem:
    Subfluxo Descrição
    Inserir detalhes do usuário do Slack por ID de membro Insere detalhes do usuário necessário no módulo Cache do usuário do Slack, com base no ID do membro.
    Inserir detalhes do usuário do Slack por ID de usuário Insere detalhes do usuário necessário no módulo Cache do usuário do Slack, com base no ID do usuário.
    Publicar mensagem acionável Publica uma mensagem acionável em um canal Slack.
    Nota:
    Este subfluxo requer uma configuração de saída como entrada. Personalize as configurações de saída padrão ou crie uma configuração de saída de acordo com seus requisitos. Para obter mais informações, consulte Definir configurações de saída na instância ServiceNow.
    Publicar uma mensagem de aprovação Publica uma mensagem de aprovação em um canal Slack.
    Nota:
    Este subfluxo requer uma configuração de saída como entrada. Personalize as configurações de saída padrão ou crie uma configuração de saída de acordo com seus requisitos. Para obter mais informações, consulte Definir configurações de saída na instância ServiceNow.
    Responder à mensagem de aprovação do Slack Publica uma mensagem de confirmação em um canal Slack.
    Responder ao comando do Slack Publica uma resposta a um comando em um canal Slack.
    Responder à ação de mensagem do Slack Publica uma notificação em um canal Slack.

    Ao personalizar os subfluxos, certifique-se de que eles estejam configurados para evitar loops infinitos.

    Ações do spoke

    O spoke Slack fornece ações para automatizar as tarefas do espaço Slack quando ocorrem eventos na instância ServiceNow. As ações disponíveis incluem:

    Categoria Ação Descrição
    Gestão de conversas Adicionar usuário ao canal Adiciona um usuário existente ao canal especificado no espaço do Slack.
    Canal de arquivo Arquiva um canal em um espaço Slack.
    Renomear conversa Renomeia uma conversa.
    Pesquisar informações da conversa Recupera informações sobre uma conversa.
    Criar Canal Cria um canal em um espaço do Slack.
    Pesquisar fluxo de anexos por conversa ou ID de membro Recupera anexos relacionados ao canal, membro ou usuário de bot relevante.
    Pesquisar fluxo do histórico do canal Recupera o histórico de um canal. Você deve fornecer o ID do canal e as datas de início e término como entradas.
    Pesquisar conversa Recupera as mensagens de conversa de um thread do canal especificado.
    Abrir conversa Abre ou retoma uma mensagem direta ou uma mensagem direta para várias pessoas.
    Pesquisar fluxo de IDs de conversa por ID de membro Recupera detalhes dos IDs de conversa relacionados ao membro especificado no Slack.
    Definir tópico para o canal Define o tópico de um canal do Slack.
    Remover usuário do canal Remove um usuário de um canal no espaço Slack.
    Gestão de notificações Publicar mensagem acionável Publica uma mensagem acionável em um canal do Slack.
    Nota:
    Esta ação requer uma configuração de saída como entrada. Personalize as configurações de saída padrão ou crie uma configuração de saída de acordo com seus requisitos. Para obter mais informações, consulte Definir configurações de saída na instância ServiceNow.
    Publicar uma mensagem de aprovação Publica uma mensagem de aprovação em um canal Slack.
    Nota:
    Esta ação requer uma configuração de saída como entrada. Personalize as configurações de saída padrão ou crie uma configuração de saída de acordo com seus requisitos. Para obter mais informações, consulte Definir configurações de saída na instância ServiceNow.
    Publicar detalhes da mudança Publica detalhes do registro de mudança em um canal.
    Publicar detalhes do incidente Publica detalhes do registro do incidente em um canal.
    Publicar mensagem Publica uma mensagem em um canal Slack.
    Publicar resposta no Slack Publica uma resposta no Slack.
    Atualizar registro de aprovação Atualiza um registro de aprovação.
    Publicar detalhes do problema Publica um detalhe de registro de problema em um canal.
    Gestão de usuários Criar Usuário Cria um usuário no espaço do Slack.
    Nota:
    Esta ação requer um token de usuário da conta do Slack. Se você tiver tokens de usuário de bot, não poderá usar esta ação.
    Desativar usuário Desativa o usuário especificado do espaço Slack.
    Nota:

    Esta ação requer um token de usuário da conta Slack. Se você tiver tokens de usuário de bot, não poderá usar esta ação.
    Pesquisar usuário Retorna informações sobre o usuário ou bot especificado. As informações podem ser nome, fuso horário, direitos de administrador do espaço e propriedade da equipe de um usuário ou bot.
    Desativar assinatura Desativa uma assinatura de usuário no Slack. Para usar esta ação, execute as etapas descritas na seção Criar uma aplicação Slack Enterprise Grid e Criar uma conexão Slack Enterprise em Integração com o Slack.
    Pesquisar fluxo de logs de acesso Recupera os logs de acesso de todos os usuários desde a data mais antiga fornecida. Para usar esta ação, execute as etapas descritas na seção Criar uma aplicação de espaço do Slack e Criar uma conexão de espaço do Slack em Integração com o Slack.
    Pesquisar fluxos de usuários Recupera todos os usuários na grade do Slack Enterprise. Para usar esta ação, execute as etapas descritas na seção Criar uma aplicação Slack Enterprise Grid e Criar uma conexão Slack Enterprise em Integração com o Slack.
    Nota:
    • As ações Criar usuário e Desativar usuário exigem o escopo de administrador. 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.
    • O escopo de administrador está disponível somente para proprietários do espaço do Slack.

    Módulos do spoke

    O spoke do Slack adiciona a aplicação Slack à sua instância ServiceNow. A aplicação Slack inclui estes módulos:
    Módulo Descrição
    Configurações do modal do Slack Crie modais e especifique os campos que devem ser exibidos no seu modal Slack.
    Cache de usuário do Slack Acesse informações sobre usuários que executaram ações no canal Slack que precisaram de atualizações na instância ServiceNow ou de uma resposta da instância ServiceNow.
    Cache do canal do Slack Acesse informações sobre os canais nos quais as ações são realizadas que precisam de atualizações na instância ServiceNow ou na resposta da instância ServiceNow.
    Decisões de entrada Especifique eventos na aplicação Slack para os quais as ações devem ser realizadas na instância ServiceNow.

    Por exemplo, você pode especificar decisões de entrada para atualizar os detalhes da tarefa em sua instância ServiceNow quando um aprovador aprova a tarefa no canal Slack relevante. Cinco exemplos de decisões de entrada estão disponíveis para sua referência. Personalize essas decisões ou crie decisões de entrada de acordo com seus requisitos.

    Quando as condições mencionadas nas decisões de entrada são atendidas, o subfluxo associado é acionado e um registro é criado no módulo Cache do usuário do Slack para o usuário do Slack que iniciou a ação de entrada.
    Decisões de entrada para modais Especifique subfluxos que devem ser acionados quando as decisões de entrada necessárias forem atendidas.

    Quando as condições mencionadas nas decisões de entrada são atendidas, o subfluxo associado é acionado e um registro é criado no módulo Cache do usuário do Slack para o usuário do Slack que iniciou a ação de entrada.
    Opções de saída do Slack Opções que devem ser exibidas como uma lista nos canais do Slack.
    Mensagem de entrada do Slack Acesse informações sobre as mensagens de entrada para sua instância ServiceNow da aplicação Slack.
    Configurações de saída Especifique eventos na instância ServiceNow para os quais as ações devem ser executadas na aplicação Slack.

    Por exemplo, você pode especificar configurações de saída para enviar uma mensagem no canal Slack solicitando aprovação quando uma tarefa for criada em sua instância ServiceNow. Três configurações de saída de amostra estão disponíveis para sua referência. Personalize essas configurações ou crie configurações de saída de acordo com seus requisitos.

    As configurações de saída também fornecem um modelo para as ações Publicar mensagem acionável e Publicar mensagem de aprovação. Por exemplo, você pode definir as configurações de saída para exibir os botões Aprovar e Rejeitar na mensagem de aprovação enviada no canal Slack relevante.

    Quando as configurações mencionadas nas configurações de saída são atendidas, o subfluxo relevante é acionado para executar ações na aplicação Slack.
    Configurações do Slack Forneça informações sobre o app Slack e a chave de assinatura.
    Os dados nesses módulos são preenchidos a partir dessas tabelas de spoke:
    Tabela Campos
    Cache do canal do Slack [sn_slack_ah_v2_slack_channel_cache]
    • ID do Canal
    • Link do canal
    • Nome do Canal
    • Criador
    • ID do documento
    • Está arquivado
    • É privado
    • Tabela de origem
    Configurações do Slack [sn_slack_ah_v2_slack_configurations]
    • Segredo do cliente
    • Alias de Conexão
    • Nome da Propriedade
    • Aplicativo Slack
    Credencial do Slack [sn_slack_ah_v2_slack_credential]
    • Chave de autenticação
    • Ativo
    • Nome do contexto
    • Nome do domínio
    • Chave de privacidade
    Opções de saída do Slack [sn_slack_ah_v2_slack_outbound_choices]
    • Nome
    • Ativo
    • Idioma
    • Sequência
    • Domínio
    • Valor
    Cache do usuário do Slack [sn_slack_ah_v2_slack_user_details]
    • Nome de exibição
    • ID do membro do Slack
    • ID da Equipe
    • Usuário
    Tokens do espaço do Slack [sn_slack_ah_v2_slack_workspace_tokens]
    • Alias de Conexão
    • Aplicativo Slack
    • Nome do espaço
    Configuração modal do Slack [sn_slack_ah_v2_slack_modal_configuration]
    • Título do modal
    • Nome
    • Validação do script
    • Modal personalizado

    Requisitos de aliases de conexão e credencial

    IntegrationHub O usa aliases para gerenciar informações de conexão e de credencial e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.

    Para obter informações sobre como configurar o spoke, consulte Configurar Slack spoke..