Webhook Trigger

⚡ TRIGGER

Inizia il tuo flusso quando un sistema esterno invia una richiesta HTTP.

---

Quando Utilizzare

• Ricevere eventi dalla tua piattaforma di e-commerce
• Integrare con Zapier o Make
• Elaborare notifiche da sistemi esterni
• Connettersi a qualsiasi sistema che può inviare richieste HTTP
• Sincronizzare dati da database esterni
• Gestire notifiche di pagamento

---

Configurazione

Campo	Descrizione
Etichetta Nodo	Nome personalizzato per questo trigger
Descrizione	Aiuta l'AI a capire cosa fa questo SmartFlow
Variabili Webhook	Definisci la struttura del payload atteso

Variabili Webhook

Definisci le variabili che ti aspetti di ricevere nel payload del webhook:

Campo	Descrizione
Nome	Nome della variabile (es. order_id)
Tipo	Tipo di dato: String, Number, Boolean, Object, Array
Descrizione	Cosa rappresenta questa variabile

Clicca su + Aggiungi Variabile per definire ciascun campo che ti aspetti.

Perché Definire Variabili?

Definire variabili aiuta a:

• Documentare la struttura del payload del tuo webhook
• Abilitare il completamento automatico quando si utilizzano variabili nelle azioni
• Validare i dati in arrivo

---

URL del Webhook

Dopo aver salvato, riceverai un URL webhook unico:

https://aismarttalk.tech/api/webhook/{your-unique-id}

Copia questo URL nel tuo sistema esterno.

---

Variabili Disponibili

Tutti i dati inviati al webhook sono disponibili come variabili:

Variabile	Descrizione
{{webhook.variableName}}	Qualsiasi variabile definita
{{webhook.body}}	Corpo della richiesta completo (JSON)
{{webhook.headers}}	Intestazioni della richiesta

---

Esempio: Ordine E-commerce

Definire Variabili:

• order_id (String) — Identificatore dell'ordine
• customer_email (String) — Email del cliente
• total (Number) — Totale dell'ordine
• items (Array) — Articoli dell'ordine

Flusso:

1. Webhook — Riceve i dati dell'ordine
2. Invia Email — Conferma a {{webhook.customer_email}}
3. Chiamata API — Notifica Slack con i dettagli dell'ordine
4. JIRA Crea Problema — Crea un'attività di evasione

---

Esempio: Integrazione Zapier

1. Crea uno SmartFlow con trigger Webhook
2. Copia l'URL del webhook
3. In Zapier, utilizza l'azione "Webhooks by Zapier"
4. Incolla il tuo URL webhook SmartFlow
5. Mappa i tuoi dati Zap alle variabili del webhook

---

Sicurezza

• Ogni URL webhook è unico e non prevedibile
• Facoltativo: Aggiungi intestazioni di autenticazione nel tuo sistema esterno
• Monitora l'attività del webhook nelle Statistiche di Utilizzo

---

Correlati

• Chiamata API — Chiama API esterne
• Workflow Programmato — Trigger basati sul tempo