Esercizio sui webhook
Scopri come creare, attivare e gestire scenari avviati da webhook.
Panoramica dell’esercizio
Lo scopo di questo scenario è creare un'app da vendere ai minimarket in modo che possano determinare facilmente se un cliente ha l'età giusta per acquistare alcolici. Il cassiere deve semplicemente pubblicare il nome e la data di nascita del cliente su un URL che gli è stato fornito. Tale post attiverà lo scenario che calcolerà la risposta e la restituirà al richiedente.
-
Lo scenario è costituito da tre webhook.
-
Il modulo trigger è un webhook personalizzato che resta in ascolto per un post.
-
Quando riceve un post, lo invierà a uno dei moduli successivi.
-
Il modulo successivo restituisce una risposta al richiedente.
Passaggi da seguire
Impostare il webhook del trigger.
-
Crea un nuovo scenario e chiamalo “Utilizzo dei webhook”.
-
Per il trigger, aggiungi il modulo webhook personalizzato dall’app Webhooks.
-
Fai clic su Aggiungi per creare un nuovo Webhook.
-
Inserisci il nome del webhook "App per bere alcolici".
-
Lascia vuote le restrizioni IP, in modo che chiunque possa inviare dati al suo interno.
-
Fai clic su Salva.
-
Nel pannello di mappatura dei webhook è stato creato un URL per questo webhook specifico. Fai clic su “Copia indirizzo negli appunti” per copiare l’URL.
-
Fai clic su OK.
-
Fai clic su Esegui una volta.
-
Utilizza l’URL in Postman per inviare un nome e una data di nascita al tuo webhook personalizzato. Per istruzioni sulla configurazione di Postman, consulta il tutorial Procedura dettagliata sui webhook.
Il pannello del modulo Webhook dovrebbe avere un aspetto simile al seguente:
Il webhook è ora in uno stato in cui è in ascolto dei dati per determinarne la struttura.
-
È possibile definire la struttura dati del payload che si prevede di ottenere (le strutture dati verranno discusse più avanti). Se non definisci una struttura dati, Fusion la determinerà automaticamente quando il post verrà inviato.
-
Sul lato Postman desideri inviare all’URL copiato. Il post dovrebbe includere i dati del modulo di base. Per questo esempio sono necessari tre campi: Nome, Data di nascita e clientToken.
-
Dopo aver fatto clic su Invia da Postman dovresti ricevere un’indicazione che il post è stato accettato.
-
Questo è il punto in cui il tuo scenario mostrerà che la struttura dati è stata determinata con successo.
-
Puoi vedere che i dati sono stati ricevuti aprendo l’execution inspector (controllo di esecuzione).
Configurare l’indirizzamento per i token client.
-
Aggiungi un router al modulo trigger.
-
Nel percorso superiore, aggiungi un modulo di risposta webhook. Questo sarà il percorso quando il token client non corrisponde.
-
Imposta lo stato su 401.
-
Imposta il corpo su {"errore": "Impossibile autenticare la richiesta. Controlla il clientToken"}.
-
Crea un filtro tra il router e il modulo di risposta webhook. Chiamalo “Client token does not match” (Token client non corrisponde).
-
Per la condizione, utilizza il campo clientToken dal modulo trigger ed esegui un confronto numerico “Not equal to” (Non uguale a) con il numero 5121933.
-
Nel percorso inferiore, aggiungi un altro modulo di risposta webhook. Questo sarà il percorso da usare quando il token client corrisponde.
-
Imposta lo stato su 200.
-
Per impostare il corpo (Body), utilizza le funzioni del pannello di mappatura per verificare se la persona ha almeno 21 anni. Se sì, restituisci “You are old enough to drink!” (Sei abbastanza grande per bere), altrimenti restituisci “You are out of luck…” (Peccato).
-
Crea un filtro tra il router e il modulo di risposta webhook nel percorso inferiore. Chiamalo “Client token does match” (Client token corrisponde).
-
Per la condizione, utilizza il campo clientToken dal modulo trigger ed esegui un confronto numerico “Equal to” con il numero 5121933.
-
Fai clic sul pulsante Scheduling (Pianificazione) sotto Run once (Esegui una volta) per attivare lo scenario in modo che ogni nuovo post venga ricevuto, segua uno dei due percorsi e generi una risposta.