Configurar gatilhos para o spoke Docusign eSignature

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 3 min. de leitura

    • Configure o gatilho para gerar o URL de retorno de chamada em sua instância ServiceNow.

    Antes de Iniciar

    • Solicite uma assinatura do Integration Hub.
    • Ative e configure o spoke Docusign eSignature.
    • Função necessária: administrador

    Habilitar propriedade do sistema para tipo de concessão de credenciais do cliente

    Crie ou habilite a propriedade do sistema glide.oauth.inbound.client.credential.grant_type.enabled para usar o tipo de concessão de credenciais do cliente OAuth para integrações de entrada da instância do cliente Docusign OAuth para ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter mais informações sobre o tipo de concessão de credenciais do cliente, consulte Client Credentials.

    Procedimento

    1. Navegar até Tudo > Propriedades do sistema > Todas as Propriedades.
    2. Pesquise a propriedade do sistema glide.oauth.inbound.client.credential.grant_type.enabled.
    3. Abra o registro.
    4. Em Valor, insira verdadeiro.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Criar um registro de aplicação para autenticar as chamadas de entrada

    Crie um registro de aplicação na instância ServiceNow para autenticar as chamadas de entrada.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
    3. Selecione Criar um endpoint de API OAuth para clientes externos.
    4. No formulário, preencha os campos.
      Tabela 1. Formulário de registros de aplicações
      Campo Descrição
      Nome Nome para identificar o registro da aplicação. Por exemplo, Gatilho externo do Docusign.
      Usuário da aplicação OAuth Função do usuário para a qual o fluxo de token OAuth está mapeado.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      O registro da aplicação foi criado e o valor de segredo do cliente foi gerado.

      Copie e registre os valores de ID do cliente e segredo do cliente para uso posterior.

    Ativar a definição do gatilho na instância ServiceNow

    Ative a definição do gatilho para gerar o URL de retorno de chamada em sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: flow_designer e connection_admin.

    Por Que e Quando Desempenhar Esta Tarefa

    O Docusign usa o URL de retorno de chamada para enviar a carga com segurança para a instância ServiceNow.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Workflow Studio.
    2. Selecione a guia Integrações.
    3. Alternar e habilitar a guia Entrada.
    4. Localize o cartão Docusign eSignature Spoke e selecione Exibir detalhes.
      Localize o cartão Docusign eSignature Spoke.
    5. Selecione Configurar.
      Configure o endpoint.
    6. No formulário, preencha estes valores.
      Campo Descrição
      Funções necessárias Funções usando as quais o fluxo será acionado. Por exemplo, selecione administrador.
      Registro de aplicações Selecione o registro da aplicação que você criou para autenticar chamadas de entrada. Por exemplo, selecione Gatilho externo do Docusign.

      Ative o endpoint.

    7. Clique em Ativar.
      O endpoint está ativado e o valor de URL é gerado.

      Copie e registre o valor da URL para uso posterior.

      Copie o URL para uso posterior.

    Adicionar configuração na conta do Docusign

    Adicione uma configuração personalizada na conta do Docusign para enviar atualizações de dados em tempo real para a instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Faça login na conta do Docusign como administrador.
    2. Clique em Administrador.
    3. Navegar até Integrações > Conectar.
    4. Em Configurações, clique em Adicionar configuração e selecione Personalizado.
    5. No formulário, preencha os valores.
      Campo Descrição
      Nome Nome para identificar o registro de configuração personalizada.
      URL para publicar Insira a URL gerada quando você ativou a definição do gatilho neste formato: https://<ServiceNow-instance-name> .service-now.com/api/sn_docusign_spoke/docusign_esignature_external_trigger .

      Para obter mais informações, consulte Ativar a definição do gatilho na instância ServiceNow.
      Formato de dados Certifique-se de selecionar REST v2.1.
      Modo de entrega de mensagem de evento Selecione Enviar mensagens individuais (SIM).
      Eventos do gatilho Expanda Envelope e Destinatários e selecione estes eventos:
      • Envelope enviado
      • Envelope entregue
      • Envelope assinado/concluído
      • Envelope recusado
      • Envelope anulado
      • Envelope excluído
      • Destinatário enviado
      • Destinatário entregue
      • Destinatário Assinado/Concluído
      • Destinatário recusado

      Aciona eventos a serem selecionados.
    6. Em Configurações de integração e segurança, marque a caixa de seleção Incluir OAuth (Recomendado).
    7. Clique em Adicionar configuração.
      O registro de configuração personalizada foi criado.
    8. Clique em Ações para o registro de configuração personalizado que você criou e selecione Editar.
      Edite a configuração personalizada.
    9. Em Configurações de integração e segurança, clique em Gerenciar OAuth.
      A guia OAuth 2.0 é exibida.
    10. Insira os valores de ID de cliente e segredo do cliente.
      Esses valores são criados quando você cria o registro de registro da aplicação na instância ServiceNow. Para obter mais informações, consulte Criar um registro de aplicação para autenticar as chamadas de entrada.
    11. Insira a URL do servidor de autorização neste formato: https://<ServiceNow-instance-name> .service-now.com/oauth_token.do .
    12. Clique em Salvar.

    O que Fazer Depois

    Crie fluxos em Workflow Studio usando esses gatilhos de acordo com seus requisitos. Para obter mais informações, consulte Create a flow with an external trigger.