🇮🇹 IT

↩️ Webhook Response

Restituisce una risposta HTTP personalizzata al chiamante che ha avviato il workflow tramite un Webhook Trigger. Usa questo nodo quando vuoi inviare una risposta significativa al mittente del webhook invece della risposta vuota 202 predefinita. Il workflow continua l'esecuzione dopo l'invio della risposta.

Categoria: Notifiche e Messaggistica · Identificatore tipo: webhook_response

Panoramica

Quando un workflow viene attivato da un Webhook Trigger, Flusso normalmente restituisce una risposta predefinita 202 Accepted immediatamente mentre l'esecuzione viene accodata. Il nodo Webhook Response ti permette di sovrascrivere questo comportamento: invia un corpo della risposta personalizzato, un codice di stato e header al chiamante nel punto del workflow in cui posizioni il nodo.

Questo è utile quando il mittente del webhook si aspetta una risposta significativa — ad esempio, un provider di pagamento che si aspetta un 200 OK per confermare la ricezione, o un sistema esterno che si aspetta un oggetto JSON contenente un risultato elaborato. Poiché il workflow continua l'esecuzione dopo l'invio della risposta, puoi confermare rapidamente al chiamante e poi proseguire con passaggi di elaborazione asincrona più lenti.

Una sola risposta per workflow. Deve essere posizionato un solo nodo Webhook Response per workflow. Se lo posizioni all'interno di un ramo, solo il ramo che viene eseguito restituirà una risposta.

Configurazione

Campo	Stato	Descrizione
Status Code	Obbligatorio	Codice di stato HTTP da restituire, es. `200`, `201`, `400`. Predefinito: `200`.
Body	Opzionale	Il corpo della risposta. Può essere un oggetto JSON, testo semplice o un riferimento `{{ variable }}`. Predefinito: vuoto.
Content Type	Opzionale	L'header Content-Type. Predefinito: `application/json`.
Headers	Opzionale	Header di risposta aggiuntivi come coppie chiave-valore.

Dati di Output

Dopo l'invio della risposta, i seguenti campi sono disponibili nell'output del passaggio:

Campo	Tipo	Descrizione
`sent`	boolean	True una volta che la risposta è stata inviata.
`status`	number	Il codice di stato che è stato inviato.

Esempio di Utilizzo

Aggiungi un nodo Webhook Trigger come trigger del workflow. Un provider di pagamento invierà dati dell'evento in POST a questo URL.
Aggiungi un nodo Logic Gate (step key: validate) che verifica la firma della richiesta da {{ trigger.output.headers.x-signature }}.
Sul ramo true, aggiungi un nodo Webhook Response. Imposta lo Status Code su 200 e il Body su:
{ "received": true }
Il provider di pagamento riceve una conferma immediata.
Aggiungi ulteriori passaggi dopo il nodo Webhook Response per elaborare il pagamento in modo asincrono — aggiornare il database, inviare un'email di conferma, attivare workflow downstream — senza far attendere il provider di pagamento.

Suggerimenti e Note

Posizionalo presto per pattern di acknowledgement. Se il chiamante necessita solo della conferma di ricezione, posiziona il nodo Webhook Response subito dopo il passaggio di validazione in modo che il chiamante non debba attendere durante l'elaborazione.
Il workflow continua dopo la risposta. I passaggi successivi vengono eseguiti normalmente dopo l'invio della risposta. Puoi usare questo per eseguire passaggi lenti o ad alto consumo di risorse senza influire sull'esperienza del chiamante.
Risposte con diramazione. Se usi un Logic Gate prima del nodo Webhook Response, puoi restituire codici di stato diversi su rami diversi — ad esempio 200 in caso di successo e 400 in caso di errore di validazione.
Funziona solo con Webhook Trigger. Questo nodo non ha effetto nei workflow attivati da schedule, esecuzioni manuali, trigger di evento o altri trigger non-webhook.

Nodi Correlati

Webhook Trigger — il trigger con cui questo nodo si abbina.
Logic Gate — valida la richiesta in arrivo prima di inviare una risposta.
Emit Event — delega il lavoro ad altri workflow dopo aver confermato al chiamante.