Configure gatilhos para o spoke DocuSign eSignature

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Configure o gatilho para gerar o URL de retorno de chamada no seu ServiceNow instância.

    Antes de Iniciar

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

    Habilite a propriedade do sistema para o 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 do cliente OAuth do DocuSign para ServiceNow instância.

    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 glide.oauth.inbound.client.credential.grant_type.enabled propriedade do sistema.
    3. Abra o registro.
    4. Para Valor insira verdadeiro .
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Crie um registro de aplicações para autenticar as chamadas de entrada

    Crie um registro de aplicações no ServiceNow instância 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 Crie um endpoint da 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 do token OAuth é mapeado.
      Importante:
      Por padrão, este campo não é exibido no formulário Registros de aplicações. Configure o layout do formulário para ver o campo no formulário. Para obter informações sobre como configurar o layout do formulário, consulte Configuring the form layout.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      O registro de registro da aplicação é criado e o valor de Segredo do cliente gerado.

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

    Ative a definição do gatilho em ServiceNow instância

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

    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 com segurança a carga para ServiceNow instância.

    Procedimento

    1. Navegar até Tudo > Automação de Processo > Workflow Studio.
    2. Selecione a guia Integrações.
    3. Alterne e habilite Entrada guia.
    4. Localize Spoke do DocuSign eSignature e selecione Exibir detalhes .
      Localize Spoke do DocuSign eSignature cartão.
    5. Selecione Configurar.
      Configure o endpoint.
    6. No formulário, preencha estes valores.
      Campo Descrição
      Funções necessárias Funções que usam 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 é ativado e o valor de URL gerado.

      Copie e registre o valor de URL para uso posterior.

      Copie o. URL para uso posterior.

    Adicione a 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 ServiceNow instância.

    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 > Conecte-se.
    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 o URL gerado 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 Ative a definição do gatilho em ServiceNow instância.

      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 Expandir 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 respondeu automaticamente
      • Destinatário entregue
      • Destinatário assinado/concluído
      • Destinatário recusado

      Aciona eventos a serem selecionados.

      Em Incluir dados . selecione Destinatários opção. Selecione outras opções de acordo com sua necessidade.

      Selecione Destinatários opção.

    6. Em Integração e configurações de segurança . selecione Incluir OAuth (recomendado) caixa de seleção.
    7. Clique em Adicionar configuração .
      O registro de configuração personalizada é criado.
    8. Clique em Ações para o registro de configuração personalizada que você criou e seleciona Editar .
      Edite a configuração personalizada.
    9. Em Integração e configurações de segurança clique em Gerenciar OAuth .
      . OAuth 2,0 é exibida.
    10. Insira os valores de ID do cliente e Segredo do cliente.
      Esses valores são criados quando você cria o registro de registro da aplicação em ServiceNow instância. Para obter mais informações, consulte Crie um registro de aplicações para autenticar as chamadas de entrada.
    11. Insira 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 seu requisito. Para obter mais informações, consulte Create a flow with an external trigger.