Um fluxo de ação é um fluxo de trabalho automatizado e definido pelo usuário. Cada fluxo de ação consiste em um gatilho, que inicia o fluxo, e em uma ou mais ações.
Você pode usar os gatilhos de fluxo de ação pré-definidos ou os administradores podem definir gatilhos de fluxo de ação personalizados. Este artigo descreve como criar um gatilho de fluxo de ação personalizado para monitorar uma solicitação HTTP de um sistema externo específico.
Após criar um gatilho de fluxo de ação, você pode usá-lo em qualquer fluxo de ação. Consulte Criação de fluxos de ação.
Criação de um gatilho de fluxo de ação personalizado
Os gatilhos de fluxo de ação são criados e gerenciados no construtor de ações.
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação. - Crie ou edite um fluxo de ação.
- Clique em + Adicionar gatilho.
- Na barra lateral da etapa, em Gatilhos personalizados, clique em Criar gatilho.
- Insira um Nome exclusivo e identificável para o gatilho de fluxo de ação.
O comprimento máximo é de 255 caracteres.
- (Opcional) Insira uma Carga de exemplo da solicitação de HTTP que você espera que o gatilho receba.
Deve ser uma solicitação POST com um corpo JSON válido. A carga não pode exceder 200 KB.
A carga de exemplo deve incluir todas as propriedades, com o tipo de dado apropriado, que você quer usar posteriormente em um fluxo de ação iniciado por esse gatilho.
- Clique em Avançar.
- Se você fornecer uma carga de exemplo, mapeie os dados clicando em Adicionar ao lado de cada par chave-valor que quer capturar como saída no seu fluxo de ação e depois clique em Próximo.
Se necessário, você pode usar o menu opções para editar o nome e o tipo de um par chave-valor ou removê-lo do gatilho. Os nomes de saída devem ser exclusivos dentro do gatilho e não podem exceder 255 caracteres.
Os seguintes tipos de dados têm suporte como saídas de gatilhos personalizados:- Texto
- Número
- Decimal
- Verdadeiro/falso
- Data (
YYYY-MM-DD) - Data e hora (
YYYY-MM-DDTHH:MM:SS[.sss]ZouYYYY-MM-DDTHH:MM:SS[.sss]+/-hh:mm) - Matrizes e objetos convertidos em cadeias de caracteres.
- Use a URL do webhook personalizada gerada para o gatilho para configurar um webhook em um sistema externo que enviará solicitações ao gatilho personalizado para iniciar um fluxo de ação.
Além disso, se disponível, configure a estratégia de repetição do sistema externo para usar recuo exponencial com variação de sinal, realizando três tentativas após uma solicitação com limite de taxa: 20 segundos, 120 segundos e 300 segundos.
Observação:- Trate a URL do webhook do gatilho de fluxo de ação personalizado como um segredo e não a compartilhe.
- As restrições de IP da sua conta são aplicadas à URL do webhook.
- Adicione o gatilho de fluxo de ação personalizado a um fluxo de ação. Consulte Criação de fluxos de ação.
Uso de saídas de gatilhos de fluxo de ação personalizados
-
Saídas de texto:
- Qualquer valor numérico, decimal, verdadeiro/falso, data ou data e hora é convertido para texto.
- Se a chave estiver ausente no corpo da solicitação, ela será representada como nulo.
-
Saídas de número:
- Valores decimais são arredondados para o número inteiro mais próximo, com valores 0,5 arredondando para cima.
- Para valores verdadeiro/falso, o valor verdadeiro é convertido para 1 e o valor falso é convertido para 0.
- Uma cadeia de caracteres que representa um número é convertida em números.
- Uma cadeia de caracteres que representa um número decimal é arredondada para o número inteiro mais próximo, com valores 0,5 arredondando para cima.
- Todas as outras cadeias de caracteres são convertidas para nulo.
- Se a chave estiver ausente no corpo da solicitação, ela será representada como nulo.
-
Saídas decimais:
- Valores numéricos são mantidos sem alterações.
- Para valores verdadeiro/falso, o valor verdadeiro é convertido para 1 e o valor falso é convertido para 0.
- Uma cadeia de caracteres que representa um número é convertida em decimais.
- Uma cadeia de caracteres que representa um decimal é convertida em decimais.
- Todas as outras cadeias de caracteres são convertidas para nulo.
- Se a chave estiver ausente no corpo da solicitação, ela será representada como nulo.
-
Saídas verdadeiro/falso:
- Valores nulos são convertidos em falso.
- Valores numéricos e decimais iguais a zero (0, -0, 0,0, -0,0) são convertidos em falso.
- Cadeias de caracteres vazias ("", "''", e "``") são convertidas emfalso.
- Todos os outros valores numéricos, decimais, cadeias de caracteres, de datas e de data e hora são convertidos em verdadeiro.
- Se a chave estiver ausente no corpo da solicitação, ela será representada como nulo.