Fondamenti dei Webhook

Polling vs. Webhook

Zapier chiede periodicamente all'app Ci sono novità, in modo simile all'aggiornamento della casella di posta elettronica ogni pochi minuti. Questo approccio di polling è integrato nella maggior parte delle integrazioni Zapier ed è semplice da configurare tramite opzioni a discesa.

# Event happens in app
    ↓
# [Time passes — 1 to 15 minutes]
    ↓
# Zapier checks and finds the event
    ↓
# Zap runs

Con i trigger webhook, l'app invia attivamente i dati a Zapier nel momento in cui si verifica un evento.

# Event happens in app
    ↓
# App immediately sends data to Zapier URL
    ↓
# Zap runs instantly

Questo funziona come le notifiche push sul tuo telefono: nel momento in cui accade qualcosa, vieni notificato istantaneamente senza alcun ritardo. Richiede una configurazione manuale nell'app di origine, l'app deve supportare i webhook e può essere utilizzato anche quando non esiste una integrazione nativa con Zapier.

Comprendere i dati dei Webhook (JSON)

Quando i dati arrivano al tuo webhook, solitamente sono in formato JSON (JavaScript Object Notation). Non è necessario conoscere a fondo il JSON, ma comprendere le basi è utile.

Quando questo raggiunge il tuo webhook, Zapier analizza il payload e trasforma ogni valore in un campo utilizzabile:

• name → "John Smith";
• email → john@example.com;
• company → "Acme Corp";
• deal_value → 15000.

Questi campi appaiono nel selettore dei campi proprio come i dati provenienti da qualsiasi altro trigger. I webhook semplici inviano solo pochi campi, rendendoli facili da utilizzare direttamente, mentre i webhook complessi inviano dati annidati con dozzine di campi.

Zapier di solito appiattisce i dati annidati per consentire un accesso più semplice. Per valori profondamente annidati, potrebbe essere necessario utilizzare uno step Formatter o Code per estrarli, come verrà illustrato nelle sezioni successive.

Quando e come utilizzare i Webhook

Utilizzare i webhook per automazioni istantanee e in tempo reale o quando un'applicazione non dispone di un'integrazione con Zapier. Sono ideali per sistemi interni personalizzati, strumenti SaaS di nicchia o nuovi e piattaforme di pagamento che inviano eventi come acquisti o abbonamenti. Anche le applicazioni con integrazioni native Zapier possono offrire webhook per trigger più rapidi o dati evento più completi.

Poiché un URL webhook attiva direttamente il tuo Zap, mantenerlo privato, testare con dati reali e monitorare la cronologia degli Zap per eventuali errori. Le impostazioni dei webhook si trovano solitamente sotto Integrazioni, API, Notifiche o Impostazioni sviluppatore nell'applicazione di origine.