Come inviare i dati del modulo WordPress a qualsiasi API con webhook

WPForms ha un addon per circa quaranta servizi. Mailchimp, Salesforce, Stripe, Google Sheets e il resto dello stack usuale sono a una schermata di configurazione di distanza. Il sistema di prenotazione interno del tuo cliente non lo è.

L'addon Webhook copre questo divario. Prende una submission di un modulo e la invia come richiesta HTTP a qualsiasi URL tu indichi, nel formato che l'API ricevente si aspetta. Questo tutorial illustra la configurazione: ottenere i dettagli dell'endpoint, mappare i tuoi campi, aggiungere l'autenticazione e testarla prima che una submission reale dipenda da essa.

Crea ora il tuo modulo WordPress

Come inviare i dati del modulo WordPress a qualsiasi API con webhook

Un visitatore invia il tuo modulo. WPForms modella le risposte in una richiesta HTTP nel modo in cui la tua API la desidera, aggiunge il tuo header di autenticazione e la invia. La tua entry viene comunque salvata in WordPress in entrambi i casi.

Quando un Webhook è lo strumento giusto

Controlla prima un addon nativo. Mailchimp, Salesforce, Google Sheets, Notion, Airtable e circa altri quaranta si collegano in pochi clic, e quelle connessioni sono più profonde. Zapier, Make e n8n coprono la lunga coda delle app SaaS, con un costo per attività e un altro account nella catena.

I webhook servono per il resto: un sistema interno proprietario, un servizio regionale, il backend personalizzato di un cliente, un endpoint che hai scritto tu stesso. Inoltre, non hanno limiti di trasferimento, quindi un modulo che riceve 4.000 invii al mese costa quanto uno che ne riceve 40.

Cosa Ti Servirà

• WPForms Elite (l'addon Webhooks è incluso in questo livello di licenza)
• Un modulo sul tuo sito
• La documentazione dell'API ricevente

Non scriverai alcun codice. Tutto questo avviene nel costruttore di moduli.

Passaggio 1: Ottieni i dettagli dall'API

Saltare questo passaggio è il motivo per cui la maggior parte dei webhook fallisce al primo tentativo. Dalla documentazione dell'API, annota:

1. L'URL dell'endpoint, come https://api.example.com/v1/deliveries
2. Il metodo di richiesta, solitamente POST per creare un record
3. Il metodo di autenticazione, solitamente una chiave in un'intestazione come Authorization: Bearer YOUR_KEY
4. I nomi esatti dei parametri. Se l'API si aspetta customer_email e tu invii email, la richiesta avrà successo e il valore scomparirà.

Esempio pratico: un cliente fiorista il cui sistema di spedizione ordini accetta nuovi ordini a quell'endpoint tramite POST e si aspetta customer_name, customer_email, customer_phone, arrangement, quantity e order_total. Non esiste un plugin WordPress per questo, ed è esattamente quando si ricorre a un webhook.

Passaggio 2: Installa l'Addon e Attivalo

Vai su WPForms » Addons, cerca Webhooks e fai clic su Installa Addon. Si attiva da solo.

Quindi apri il tuo modulo, fai clic su Impostazioni » Webhooks e attiva Abilita Webhooks.

Fai clic sull'icona a forma di matita per rinominarlo con qualcosa che riconoscerai in seguito, come "API di spedizione".

Passaggio 3: Imposta l'URL della Richiesta, il Metodo e il Formato

Successivamente, configura queste impostazioni:

URL di richiesta. Incolla l'endpoint. Fai attenzione al segmento della versione, poiché /v1/ e /v2/ sono facili da confondere.

Metodo di richiesta. GET, POST, PUT, PATCH o DELETE. POST crea un nuovo record e copre la maggior parte delle configurazioni.

Formato di richiesta. JSON invia application/json e si adatta alla maggior parte delle API moderne. FORM invia application/x-www-form-urlencoded, quindi usalo solo quando la documentazione lo richiede. Nel dubbio, JSON.

Passaggio 4: Aggiungi i tuoi Header di Autenticazione

Infine, aggiungi le tue intestazioni di autenticazione.

Intestazioni di richiesta accetta coppie chiave/valore. Per un token bearer, usa Authorization come chiave e Bearer YOUR_TOKEN come valore. Per un'intestazione personalizzata, usa il nome che la documentazione fornisce, come X-API-Key. Aggiungi tutte le righe necessarie.

Il campo Segreto funziona al contrario e WPForms lo compila per te. Firma ogni richiesta in uscita in modo che il server ricevente possa confermare che i dati provengono effettivamente dal tuo sito. Usalo quando controlli l'endpoint e puoi verificare la firma; la maggior parte delle API di terze parti lo ignora.

Tratta il valore dell'intestazione come la credenziale che è. Chiunque abbia accesso al costruttore può leggerlo, quindi limita le chiavi API dei clienti e ruotale quando qualcuno lascia il progetto.

Crea ora il tuo modulo WordPress

Passaggio 5: Mappa i tuoi Campi del Modulo

Il Corpo della Richiesta è dove il modulo incontra l'API. Ogni riga abbina un nome di parametro che digiti con un campo del modulo che scegli:

• customer_name → Nome
• customer_email → Email
• customer_phone → Numero di Telefono
• arrangement → Piano
• quantity → Quantità
• order_total → Totale

Copia i nomi delle chiavi direttamente dalla documentazione. Maiuscole e underscore contano, e una discrepanza ti darà una richiesta che ha successo ma ignora il valore.

Checkbox, selezioni multiple e campi indirizzo inviano valori separati da una doppia barra (||), quindi dividi quella stringa lato server se l'API si aspetta un array.

Scegli Aggiungi Valore Personalizzato per inviare qualcosa che non è un campo del modulo, come un parametro source statico o un tag intelligente per l'ID dell'inserimento.

Passaggio 6: Aggiungi Logica Condizionale (Opzionale)

Attiva Abilita Logica Condizionale per controllare quando viene attivato il webhook. Potresti inviare solo un tipo di piano all'API di dispatch, o trattenere ordini che non necessitano di consegna. Per due destinazioni, fai clic su Aggiungi Nuovo Webhook e dai a ciascuno la propria regola.

Passaggio 7: Testa prima di andare in diretta

Testa in due passaggi.

Per prima cosa, invia a un ispettore di richieste. Webhook.site e RequestBin generano un URL temporaneo che mostra esattamente cosa è arrivato. Incollalo in URL Richiesta, salva e invia il modulo. Le tue intestazioni e il payload appaiono immediatamente, il che ti dice se i nomi delle chiavi sono corretti.

Poi passa all'endpoint reale, invia di nuovo e conferma che il record sia arrivato. Controlla anche WPForms » Voci.

Se sei bloccato, vai su WPForms » Strumenti » Log, attiva Abilita Log e controlla Provider ed Errori sotto Tipi di Log. Invia di nuovo e il log mostrerà la risposta dell'API. Disattiva di nuovo il logging in seguito, poiché queste voci possono contenere dati che non vuoi che rimangano sul server.

Errori comuni dei Webhook

• 401 o 403. Autenticazione: chiave errata, chiave scaduta, prefisso Bearer mancante o nome intestazione errato.
• 404. L'URL: errore di battitura, segmento di versione mancante o una barra finale che l'API rifiuta.
• 400 o 422. L'API ha ricevuto la richiesta e ha rifiutato il contenuto, solitamente un parametro obbligatorio mancante o una data non analizzabile.
• 200 ma non appare nulla. Discrepanza nel nome della chiave: l'API ha accettato la richiesta e ignorato i campi che non ha riconosciuto.
• Non succede nulla. Controlla la logica condizionale: sui moduli multipagina il webhook viene eseguito una volta, dopo l'invio finale.

FAQ sull'invio di dati da moduli WordPress a un'API

Quale piano WPForms include l'addon Webhook?

Elite. Quel livello copre anche Salesforce, Authorize.Net, ActiveCampaign e Airtable, motivo per cui è dove le agenzie che svolgono lavori di integrazione personalizzata solitamente si trovano.

Ho bisogno di sapere come programmare per usare i webhook?

No. Tutto avviene nell'editor di WPForms. Devi solo leggere la documentazione dell'API abbastanza bene da trovarne l'URL, il metodo di autenticazione e i nomi dei parametri.

Qual è la differenza tra i webhook e i componenti aggiuntivi Zapier o Make?

Zapier e Make si posizionano tra il tuo modulo e la destinazione, offrendoti flussi di lavoro multi-step e un ampio catalogo di connessioni a un costo per attività. Un webhook va direttamente all'endpoint, funziona con qualsiasi API e non misura le richieste.

Un modulo può inviare dati a più di un'API?

Sì. Fai clic su Aggiungi nuovo Webhook e configura la seconda connessione con il suo URL, header e mapping. Ognuno può portare la propria logica condizionale.

Come invio una chiave API con i dati del mio modulo?

Aggiungila negli Header della Richiesta come coppia chiave/valore. La maggior parte delle API vuole Authorization e Bearer LA_TUA_CHIAVE, anche se alcune usano un nome personalizzato come X-API-Key.

Cosa succede se l'API è offline quando qualcuno invia il mio modulo?

La submission viene comunque completata e la tua entry e le notifiche vanno a buon fine, poiché il webhook è una richiesta separata. Solo il webhook fallisce, quindi aggiungi il monitoraggio dal lato ricevente per qualsiasi cosa di critico per il business.

Successivamente, instrada le tue submission nel posto giusto automaticamente

Con la connessione API funzionante, il passo successivo è il routing attorno ad essa, in modo che le richieste di preventivo, le domande di supporto e le iscrizioni alla newsletter vadano ciascuna in un posto diverso per conto proprio. Come Instaurare Moduli di Invio a Liste e Strumenti Diversi in Base alle Risposte contiene la guida.

Crea ora il tuo modulo WordPress

Pronto a creare il tuo modulo? Inizia oggi stesso con il plugin per la creazione di moduli WordPress più semplice. WPForms Pro include molti modelli gratuiti e offre una garanzia di rimborso di 14 giorni.

Se questo articolo ti è stato utile, seguici su Facebook e Twitter per altri tutorial e guide gratuite su WordPress.