🇮🇹 IT

🔔 Webhook Notification

Invia una richiesta HTTP POST a un URL esterno con un payload JSON. Progettato per notifiche in uscita fire-and-forget verso servizi di terze parti, sistemi interni o altre piattaforme di automazione.

Categoria: Notifiche e Messaggistica · Identificatore tipo: webhook_notification

Panoramica

Il nodo Webhook Notification è un modo leggero per inviare dati da Flusso a qualsiasi sistema esterno che accetta richieste HTTP POST. Invia un body JSON e opzionalmente include header personalizzati (utili per token di autenticazione o override del content-type).

A differenza del nodo HTTP Request, Webhook Notification è progettato specificamente per notifiche in uscita. Non analizza né elabora il corpo della risposta — se hai bisogno di leggere la risposta e usarla nei passaggi successivi, usa invece il nodo HTTP Request.

Quando usare Webhook Notification vs HTTP Request

Caso d'uso	Nodo migliore
Notificare un servizio e proseguire (fire-and-forget)	Webhook Notification
Chiamare un'API e usare la risposta nei passaggi successivi	HTTP Request
Webhook specifici per piattaforma (Slack, Discord)	Nodi di messaggistica dedicati

Configurazione

Campo	Obbligatorio	Descrizione
URL	Obbligatorio	L'URL webhook di destinazione a cui inviare il POST. Supporta `{{ variable }}`.
Payload	Obbligatorio	Payload JSON da includere nel corpo della richiesta. Supporta i riferimenti `{{ variable }}` in qualsiasi punto del JSON.
Headers	Opzionale	Header HTTP personalizzati come coppie chiave-valore. Usa per token di autenticazione o content type personalizzati. Esempio: `Authorization: Bearer my_token`.
Timeout	Opzionale	Timeout della richiesta in secondi. Se il server esterno non risponde entro questo tempo, il passaggio fallisce. Predefinito: 10 secondi.

Dati di Output

Campo	Tipo	Descrizione
`status`	integer	Il codice di stato HTTP restituito dal server esterno (es. 200, 201, 404).
`ok`	boolean	`true` se il codice di stato è nell'intervallo 2xx.
`response_body`	string	Il testo grezzo del corpo della risposta restituito dal server. Disponibile per scopi di logging o debug.

Esempio di Utilizzo

Notificare un sistema operativo interno ogni volta che viene creato un nuovo record cliente. Il payload include il nome e l'ID del cliente risolti da un passaggio precedente.

-- URL -- https://ops.internal.example.com/hooks/new-customer -- Payload -- { "event": "customer.created", "customer_id": "{{ create_customer.output.id }}", "name": "{{ create_customer.output.name }}", "created_at": "{{ create_customer.output.created_at }}" } -- Headers -- Authorization: Bearer {{ trigger.output.api_key }}

Suggerimenti e Note

Se il server ricevente richiede la verifica della firma HMAC, usa invece il nodo HTTP Request — ti dà il pieno controllo sulla richiesta.
Impostare un Timeout ragionevole impedisce al tuo workflow di bloccarsi indefinitamente se il server esterno è lento o non disponibile.
Usa l'output ok in un nodo Logic Gate successivo per diramare in base al successo o al fallimento.
Il nodo non ritenta automaticamente in caso di fallimento. Aggiungi un pattern di retry utilizzando un Loop e un nodo Wait se è richiesta una consegna affidabile.

Nodi Correlati

Email Notification — invia un'email invece di un HTTP POST.
Emit Event — attiva altri workflow Flusso anziché un URL esterno.
Slack Message — integrazione Slack dedicata con opzioni di formattazione più ricche.