Webhook

Un webhook è un callback HTTP che invia automaticamente dati da un'applicazione a un'altra quando si verifica un evento specifico. A differenza delle [API](/glossary/api) dove si effettua polling per gli aggiornamenti, i webhook inviano dati in tempo reale nel momento in cui si verificano gli eventi. L'applicazione ricevente ascolta su un endpoint URL specificato ed elabora i dati in arrivo immediatamente. I webhook seguono un modello publisher-subscriber: l'applicazione sorgente invia una richiesta HTTP POST a un URL pre-registrato ogni volta che si verifica un evento scatenante, e il subscriber elabora il payload senza mai doverlo richiedere.

I webhook eliminano la necessità di trasferimenti manuali di dati o polling costante tra sistemi. Per gli editori digitali, ciò significa che lead catturati, transazioni di vendita e attività dei visitatori possono fluire automaticamente in CRM, piattaforme email o database interni nel momento in cui avvengono. Questo riduce i ritardi da minuti o ore a millisecondi, elimina il lavoro manuale di export-import e garantisce che i vostri sistemi aziendali abbiano sempre dati aggiornati. Senza webhook, i team devono controllare manualmente le dashboard o costruire processi batch che restano indietro rispetto agli eventi in tempo reale.

La funzionalità [automazione e integrazioni](/features/automation-and-integrations) di FlipLink supporta webhook che si attivano quando si verificano eventi chiave. Potete configurare endpoint webhook per ricevere dati quando un nuovo lead viene catturato, un documento viene visualizzato o una vendita viene completata tramite Stripe. Ogni webhook invia un payload JSON strutturato contenente i dettagli dell'evento al vostro URL specificato. Questo vi permette di connettere FlipLink a praticamente qualsiasi sistema, inclusi strumenti come Zapier, Make o backend personalizzati. Combinati con l'[integrazione Google Sheets](/features/automation-and-integrations), i webhook offrono agli editori un modo flessibile per automatizzare l'intero flusso di lavoro editoriale senza scrivere codice.

Quando si verifica un evento scatenante, FlipLink invia una richiesta HTTP POST al vostro endpoint URL registrato. Il corpo della richiesta contiene un payload JSON strutturato così: - **Tipo evento** — una stringa che identifica l'evento (es. `lead.captured`, `document.viewed`, `sale.completed`) - **Timestamp** — data e ora dell'evento in formato ISO 8601 - **Dati del payload** — i campi specifici dell'evento come nome del contatto, email, titolo del documento o importo della transazione Il vostro endpoint deve restituire un codice di stato HTTP 200 per confermare la ricezione. Se l'endpoint restituisce un errore o va in timeout, FlipLink riprova la consegna per garantire che nessun evento venga perso. Tutti i payload webhook vengono inviati tramite [HTTPS](/glossary/https), quindi i dati sono crittografati in transito. Per gli sviluppatori che costruiscono integrazioni personalizzate, la struttura JSON coerente rende semplice analizzare e instradare gli eventi al gestore appropriato nella propria applicazione.

1. **Preparate il vostro endpoint.** Configurate un URL HTTPS sul vostro server, Zapier, Make o qualsiasi servizio che possa ricevere richieste POST. L'endpoint deve essere accessibile pubblicamente e restituire una risposta 200. 2. **Navigate alle integrazioni.** Nel pannello FlipLink, andate alle impostazioni di [automazione e integrazioni](/features/automation-and-integrations) della vostra pubblicazione. 3. **Aggiungete l'URL del webhook.** Incollate l'URL del vostro endpoint nel campo di configurazione webhook. 4. **Selezionate gli eventi scatenanti.** Scegliete quali eventi devono attivare il webhook — cattura lead, visualizzazione documento, completamento vendita o altri a seconda delle vostre esigenze. 5. **Inviate un evento di test.** Usate la funzione di test per inviare un payload di esempio al vostro endpoint. Verificate che il vostro sistema riceva ed elabori i dati correttamente. 6. **Andate live.** Salvate la configurazione. Da questo momento, ogni evento corrispondente nel vostro [flipbook](/glossary/flipbook) attiverà un POST in tempo reale verso il vostro endpoint. 7. **Monitorate la consegna.** Controllate periodicamente i log del vostro endpoint per confermare che i webhook arrivino. Se notate lacune, verificate che il vostro endpoint restituisca risposte 200 e che il vostro server non abbia regole firewall che bloccano le richieste di FlipLink.

| Aspetto | Webhook | API Polling | |---------|---------|-------------| | **Consegna dati** | Push automatico quando si verificano eventi | Pull a intervalli programmati | | **Latenza** | Quasi istantanea (millisecondi) | Dipende dall'intervallo di polling (secondi o minuti) | | **Carico server** | Minimo — le richieste avvengono solo quando si verificano eventi | Maggiore — le richieste avvengono ad ogni intervallo anche senza cambiamenti | | **Implementazione** | Registrare un URL e gestire le richieste POST in arrivo | Costruire un job pianificato che chiama l'endpoint API ripetutamente | | **Ideale per** | Notifiche in tempo reale, sincronizzazione CRM, alert istantanei | Elaborazione batch, report periodici, snapshot di dati | | **Rischio** | Un downtime dell'endpoint può far perdere eventi senza logica di retry | Nessun evento perso se il polling recupera, ma consapevolezza ritardata | Per la maggior parte degli editori FlipLink, i webhook sono la scelta migliore per eventi di cattura lead e vendita dove la velocità conta. Il polling API funziona meglio per esportazioni periodiche di analytics o dashboard che si aggiornano a intervalli fissi. Molti team usano entrambi: webhook per il routing dei lead in tempo reale e la [REST API](/glossary/rest-api) per le estrazioni notturne di analytics.