Criar 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 terceiros compatível que já está configurado em Workflow Studio. O spoke de terceiros envia a carga do evento para Workflow Studio sempre que ocorre um evento. Na definição do gatilho, especifique a carga do evento no formato JSON e as condições para iniciar o gatilho. Obtenha o JSON de carga do evento do spoke de terceiros que você configura.

Antes de Iniciar

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

Assinatura necessária: esta etapa requer uma assinatura do Integration Hub.

Plug-ins necessários: instale os seguintes plug-ins do Integration Hub:

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

• Construtor de gatilho externo [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 Integration Hub, consulte Cronogramas jurídicos - Visão geral do Integration Hub

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

• Spoke do Jira
• Spoke do GitHub
• Spoke do Docusign eSignature

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

Importante:

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

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Na página inicial do Workflow Studio, selecione Novo(a) > 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 o fluxo. Em Externo, selecione Evento (Webhook).
   Descrição	Descrição do gatilho.
   Aplicação	Escopo da aplicação para criar o gatilho. Workflow Studio exibe os spokes configurados compatíveis.

4. Selecione Mostrar propriedades adicionais e preencher os campos.

   Tabela 2. Formulário de propriedades adicionais

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

5. Selecione Criar gatilho.
   Workflow Studio exibe a página de 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, no Editor JSON, cole a carga JSON da aplicação de terceiros.
   Consulte a documentação do webhook de terceiros para saber de onde você pode copiar o JSON de 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. No 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 seus requisitos.
11. Selecione Publicar para disponibilizar o gatilho para outras pessoas usarem.
    Nota:

    Você não pode editar um gatilho externo salvo após a publicação.