Crie um gatilho externo salvo

Salve um conjunto de definições de gatilho como um gatilho reutilizável que responde a um evento externo por meio de webhooks. Quando ocorre um evento na aplicação de terceiros configurada que atende às condições especificadas, o gatilho é ativado.

Por Que e Quando Desempenhar Esta Tarefa

Crie um gatilho salvo que responda a eventos que ocorrem em um spoke de terceiro compatível que já esteja configurado em Workflow Studio. O spoke de terceiros envia a carga do evento para Workflow Studiosempre que ocorrer um evento. Na definição do gatilho, especifique a carga do evento no formato JSON e as condições para iniciar o gatilho. Obtenha a carga do evento JSON do spoke de terceiros que você configurou.

Antes de Iniciar

Função necessária: Trigger_designer, flow_designer ou admin

Assinatura necessária: Esta etapa requer uma assinatura do Hub de integração.

Plug-ins necessários: Instale os seguintes plug-ins do Hub de integração:

• Gatilho externo do hub de integração da ServiceNow [com.glide.ih.external_trigger]: Para usar gatilhos externos prontos para uso.

• Construtor de gatilhos externos [sn_ext_trg_bldr]: Para criar um gatilho externo salvo.

Nota:

Para obter informações sobre o que está incluído em diferentes  assinaturas do Hub de integração, consulte Cronogramas jurídicos - Visão geral da Central de integração

Certifique-se de ter configurado os endpoints do gatilho externo para o spoke da aplicação de terceiros. Os spokes compatíveis são:

• Jira Spoke
• GitHub Spoke
• Spoke de assinatura eletrônica do DocuSign

Para obter mais informações sobre como configurar o spoke de terceiros, consulte Set up external trigger endpoints.

Importante:

Mantenha a carga de evento JSON da aplicação de terceiros à mão. Consulte a documentação do webhook de terceiros para saber mais sobre onde você pode copiar o JSON da carga. Por exemplo, consulte o link a seguir que mostra diferentes formas de carga para eventos do JIRA: Executando um webhook .

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Na página inicial do Workflow Studio, selecione Novo > Gatilho.
3. No formulário, preencha os campos.

   Tabela 1. Novo formulário de gatilho

   Campo	Descrição
   Nome do gatilho	Nome para identificar o gatilho.
   Tipo de gatilho	O tipo de gatilho para iniciar seu fluxo. Em Externo, selecione Evento (webhook) .
   Descrição	Descrição do gatilho.
   Aplicação	Escopo da aplicação para criar o gatilho. Workflow Studioexibe os spokes configurados compatíveis.

4. Selecione Mostrar propriedades adicionais e preencha os campos.

   Tabela 2. Formulário de propriedades adicionais

   Campo	Descrição
   Acessível de	Os dados do gatilho podem ser acessados em todos os escopos da aplicação.
   Categoria	A categoria em que o gatilho é exibido.
   Anotação do gatilho	Anotação para o gatilho que o usuário pode ver antes de selecionar o gatilho.

5. Selecione Gatilho de criação .
   Workflow Studio Exibe a página Definição do gatilho. Na área de visualização da origem do evento, você pode exibir informações sobre como o endpoint do gatilho externo está configurado.
6. Em Analisador , preencha os campos.

   Tabela 3. Formulário do analisador

   Campo	Descrição
   Nome da saída do gatilho	Rótulo para identificar a saída do gatilho.
   Cabeçalhos da solicitação	Campo opcional para especificar um ou mais cabeçalhos a serem incluídos na solicitação de entrada.
   Parâmetros de consulta	Campo opcional para especificar um ou mais parâmetros a serem incluídos na solicitação de entrada.

7. Em Corpo , em Editor JSON , Cole a carga JSON da aplicação de terceiros.
   Consulte a documentação do webhook de terceiros para saber mais sobre onde você pode copiar o JSON da carga.
8. Selecione Visualizar objetos .
   O editor exibe os objetos que estão na carga JSON. Você pode reordenar ou remover os objetos. Os objetos estão disponíveis como cápsulas de dados para uso em condições.
9. Em Editor de condições , arraste e solte as cápsulas de dados para criar um conjunto de condições.
   Use os operadores [OR] ou [AND] para adicionar mais condições ao conjunto de condições.
10. Selecione Novo conjunto de condições para adicionar conjuntos de condições adicionais de acordo com sua necessidade.
11. Selecione Publicar para disponibilizar o gatilho para que outras pessoas usem.
    Nota:

    Você não pode editar um gatilho externo salvo depois de publicar.