Un flusso di azioni è un workflow automatizzato definito dall’utente. Ogni flusso di azioni è costituito da un trigger del flusso di azioni, che avvia il flusso, e da una o più azioni.
Puoi usare trigger di flusso di azioni predefinitioppure gli amministratori possono definire trigger di flusso di azioni personalizzati. Questo articolo descrive come creare un trigger di flusso di azioni personalizzato per ascoltare una richiesta HTTP da un sistema esterno specifico.
Dopo aver creato un trigger di flusso di azioni, puoi usarlo in qualsiasi flusso di azioni. Consulta Creazione di flussi di azioni.
Creazione di un trigger di flusso di azioni personalizzato
I trigger del flusso di azioni vengono creati e gestiti in Creazione azioni.
Creazione di un trigger di flusso di azioni personalizzato
-
Nel Centro amministrativo, fai clic su
App e integrazioni nella barra laterale, quindi seleziona Azioni > Flussi di azioni.
- Crea o modifica un flusso di azioni.
- Fai clic su + Aggiungi trigger.
- Nella barra laterale dei passaggi, in Trigger personalizzati, fai clic su Crea trigger.
-
Inserisci un nome univoco e identificabile per il trigger del flusso di azioni.
La lunghezza massima è di 255 caratteri.
-
(Facoltativo) Inserisci un payload di esempio della richiesta HTTP che prevedi che il trigger riceva.
Deve trattarsi di una richiesta POST con un corpo JSON valido. Il payload non può superare i 200 KB.
Il payload di esempio deve includere tutte le proprietà, con il tipo di dati appropriato, da usare in un secondo momento in un flusso di azioni che inizia con questo trigger.
- Fai clic su Avanti.
-
Se fornisci un payload di esempio, mappa i dati facendo clic su Aggiungi accanto a ciascuna coppia chiave-valore che intendi acquisire come output nel flusso di azioni e quindi facendo clic su Avanti.
Se necessario, puoi usare il menu delle opzioni per modificare il nome e il tipo di una coppia chiave-valore o rimuoverla dal trigger. I nomi di output devono essere univoci all’interno del trigger e non possono superare i 255 caratteri.
I seguenti tipi di dati sono supportati come output dai trigger personalizzati:
- Testo
- Numero
- Decimale
- Vero/falso
- Data (
YYYY-MM-DD) - Data e ora (
YYYY-MM-DDTHH:MM:SS[.sss]ZoYYYY-MM-DDTHH:MM:SS[.sss]+/-hh:mm) - Le matrici e gli oggetti vengono convertiti in stringhe.
-
Usa l’ URL del webhook personalizzato generato per il trigger per configurare un webhook in un sistema esterno che invierà richieste al trigger personalizzato per avviare un flusso di azioni.
Inoltre, se hai la possibilità, configura la strategia di ripetizione dei tentativi del sistema esterno in modo da usare il backoff esponenziale con jitter per tre tentativi a 20 secondi, 120 secondi e 300 secondi dopo una richiesta con frequenza limitata.
Nota:
- Considera l’URL del webhook del trigger del flusso di azioni personalizzato come un segreto e non condividerlo.
- Per l’URL del webhook vengono applicate le limitazioni IP del tuo account.
- Aggiungi il trigger del flusso di azioni personalizzato a un flusso di azioni. Consulta Creazione di flussi di azioni.
Uso degli output dei trigger di flussi di azioni personalizzati
A tutti i dati che vuoi generare dal trigger del flusso di azioni deve essere assegnato il tipo di dati appropriato. Viene impostato automaticamente in base al payload di esempio, ma puoi modificarlo in base alle esigenze. Se i dati ricevuti differiscono dal payload previsto, il flusso di azioni tenterà di convertire i dati usando le regole seguenti:
-
Output di testo:
- Qualsiasi valore numerico, decimale, vero/falso, data o data/ora viene convertito in testo.
- Se la chiave non è presente nel corpo della richiesta, viene rappresentata come null.
-
Numero di output:
- I valori decimali vengono arrotondati al numero intero più vicino, mentre i valori 0,5 vengono arrotondati per eccesso.
- Per i valori true/false, true viene convertito in 1 e false in 0.
- Una stringa che rappresenta un numero viene convertita in un numero intero.
- Una stringa che rappresenta un decimale viene arrotondata al numero intero più vicino.
- Tutte le altre stringhe vengono convertite in nil.
- Se la chiave non è presente nel corpo della richiesta, viene rappresentata come nil.
-
Output decimali:
- I valori numerici vengono trasmessi senza modifiche.
- Per i valori true/false, true viene convertito in 1 e false in 0.
- Una stringa che rappresenta un numero viene convertita in decimale.
- Una stringa che rappresenta un valore decimale viene convertita in un valore decimale.
- Tutte le altre stringhe vengono convertite in nil.
- Se la chiave non è presente nel corpo della richiesta, viene rappresentata come nil.
-
Output vero/falso:
- I valori Null vengono convertiti in false.
- I valori numerici e decimali pari a zero (0, -0, 0,0, -0,0) vengono convertiti in false.
- Le stringhe vuote ("", "''" e "``") vengono convertite in false.
- Tutti gli altri valori numerici, decimali, stringhe, date e datetime vengono convertiti in true.
- Se la chiave non è presente nel corpo della richiesta, viene rappresentata come nil.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.