La funzionalita webhook e callback di Post Affiliate Pro ti permette di notificare automaticamente sistemi esterni quando si verificano eventi specifici, come nuove vendite, registrazioni affiliati o approvazioni commissioni.
Disponibile in:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
I webhook (chiamati anche Application Callback o URL Postback) sono notifiche HTTP automatizzate che Post Affiliate Pro invia a sistemi esterni quando si verificano eventi specifici. Invece di interrogare costantemente per aggiornamenti, i tuoi sistemi connessi ricevono notifiche istantanee nel momento in cui qualcosa accade nel tuo programma di affiliazione.
Questa funzionalita e essenziale per:
Post Affiliate Pro supporta due tipi principali di webhook:
Questi webhook vengono attivati da eventi relativi alle transazioni:
| Evento Trigger | Descrizione |
|---|---|
| On Create | Si attiva immediatamente quando una nuova transazione (vendita, action, lead) viene registrata |
| On Approve | Si attiva quando una transazione in sospeso viene approvata |
| On Decline | Si attiva quando una transazione viene rifiutata |
| On Refund/Chargeback | Si attiva quando viene elaborato un rimborso o chargeback |
Puoi configurare un singolo webhook per attivarsi su eventi multipli, o creare webhook separati per ogni tipo di evento.
Questi webhook vengono attivati da eventi di registrazione affiliati:
| Evento Trigger | Descrizione |
|---|---|
| On Register | Si attiva immediatamente quando un nuovo affiliato completa il modulo di registrazione |
| On Approve | Si attiva quando un affiliato in sospeso viene approvato da un merchant |
Post Affiliate Pro supporta tre tipi di richiesta HTTP per i webhook:
I parametri vengono aggiunti all’URL come parametri query string.
https://your-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
I parametri vengono inviati nel corpo della richiesta usando la codifica form standard.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
I parametri vengono inviati come oggetto JSON nel corpo della richiesta.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Puoi usare variabili dinamiche nei tuoi URL webhook che vengono automaticamente sostituite con valori reali. Usa il formato ${#nomevariabile#} per includere una variabile.
| Variabile | Descrizione |
|---|---|
${#transactionid#} | Identificatore transazione unico |
${#visitorid#} | ID visitatore (cookie di tracciamento) |
${#commission#} | Importo commissione |
${#totalcost#} | Valore totale ordine |
${#fixedcost#} | Importo costo fisso |
${#orderid#} | ID ordine dal tuo sistema e-commerce |
${#productid#} | ID prodotto |
${#dateinserted#} | Data e ora di creazione della transazione |
${#dateapproved#} | Data e ora di approvazione della transazione |
${#tier#} | Livello tier commissione |
${#status#} | Stato transazione (Approvato, In Sospeso, Rifiutato) |
${#statuscode#} | Codice stato (A, P, D) |
${#type#} | Tipo transazione (Vendita, Action, ecc.) |
| Variabile | Descrizione |
|---|---|
${#campaignid#} | Identificatore campagna |
${#campaignname#} | Nome campagna |
${#bannerid#} | Identificatore banner |
${#channel#} | Nome canale |
${#channel_code#} | Codice canale |
${#coupon_code#} | Codice coupon usato |
| Variabile | Descrizione |
|---|---|
${#userid#} | ID utente affiliato |
${#refid#} | ID referral affiliato |
| Variabile | Descrizione |
|---|---|
${#firstclicktime#} | Timestamp primo clic |
${#firstclickreferer#} | URL referrer primo clic |
${#firstclickip#} | Indirizzo IP primo clic |
${#firstclickdata1#} | Dati personalizzati 1 primo clic |
${#firstclickdata2#} | Dati personalizzati 2 primo clic |
${#lastclicktime#} | Timestamp ultimo clic |
${#lastclickreferer#} | URL referrer ultimo clic |
${#lastclickip#} | Indirizzo IP ultimo clic |
${#lastclickdata1#} | Dati personalizzati 1 ultimo clic |
${#lastclickdata2#} | Dati personalizzati 2 ultimo clic |
| Variabile | Descrizione |
|---|---|
${#saledata1#} | Campo dati personalizzati transazione 1 |
${#saledata2#} | Campo dati personalizzati transazione 2 |
${#saledata3#} | Campo dati personalizzati transazione 3 |
${#saledata4#} | Campo dati personalizzati transazione 4 |
${#saledata5#} | Campo dati personalizzati transazione 5 |
| Variabile | Descrizione |
|---|---|
${#ip#} | Indirizzo IP del cliente |
${#countrycode#} | Codice paese basato su IP |
${#refererurl#} | URL referrer |
| Variabile | Descrizione |
|---|---|
${#originalcurrency#} | Nome valuta originale |
${#originalcurrencyvalue#} | Valore valuta originale |
${#originalcurrencyrate#} | Tasso di cambio usato |
| Variabile | Descrizione |
|---|---|
${#merchantnote#} | Nota visibile all’affiliato |
${#systemnote#} | Nota visibile solo al merchant |
${#actionName#} | Nome tipo commissione action |
${#actionCode#} | Codice tipo commissione action |
Per i webhook registrazione affiliati, puoi usare variabili profilo affiliato:
| Variabile | Descrizione |
|---|---|
${#username#} | Email/username affiliato |
${#firstname#} | Nome affiliato |
${#lastname#} | Cognome affiliato |
${#name#} | Nome completo (nome + cognome) |
${#userId#} | ID utente affiliato |
| Campi personalizzati | Qualsiasi campo profilo personalizzato per il suo codice |
Per impostazione predefinita, i webhook vengono eseguiti solo per le commissioni tier 1 (dirette). Puoi abilitare l’opzione “Esegui per ogni tier” per attivare i webhook per tutti i livelli tier nelle strutture di commissioni multi-tier.
Questo e utile quando:
Puoi configurare i webhook per essere piu specifici:
Limita il webhook a un tipo di commissione specifico (es. solo per commissioni action “Vendite Premium”).
Crea webhook che si attivano solo per un affiliato specifico. Questo e utile per:
In Post Affiliate Network, puoi creare webhook specifici per account.
Post Affiliate Pro mantiene un log completo di tutte le esecuzioni webhook, accessibile nel pannello merchant sotto Strumenti > Log Callback.
Il log mostra:
Se un webhook fallisce (es. il tuo server e temporaneamente non disponibile), Post Affiliate Pro riprova automaticamente la richiesta. Questo assicura una consegna affidabile anche durante interruzioni temporanee.
I log webhook vengono automaticamente puliti dopo un numero configurabile di giorni (predefinito: 60 giorni). Puoi regolare questo in Configurazione > Funzionalita > Application Callback.
Per impostazione predefinita, i webhook creati dagli affiliati richiedono approvazione del merchant prima di diventare attivi. I merchant possono:
I webhook hanno tre stati possibili:
I merchant possono cambiare lo stato del webhook in qualsiasi momento dalla schermata di gestione webhook.
Post Affiliate Pro puo inviare notifiche email per eventi relativi ai webhook:
Queste notifiche possono essere abilitate o disabilitate in Configurazione > Notifiche Email.
Invia dati nuova vendita al tuo CRM quando una transazione viene approvata:
https://crm.example.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
Notifica il tuo canale team quando un nuovo affiliato si registra:
https://hooks.slack.com/services/xxx/yyy?text=Nuovo+affiliato:+${#firstname#}+${#lastname#}
Aggiungi clienti a una sequenza email dopo l’acquisto:
POST https://email.example.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
Registra i pagamenti commissioni nel tuo sistema contabile:
https://accounting.example.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
I webhook (chiamati anche Application Callback) sono richieste HTTP che Post Affiliate Pro invia automaticamente a un URL che specifichi quando si verificano determinati eventi, come una nuova vendita, approvazione commissione o registrazione affiliato. Questo ti permette di integrarti con sistemi esterni in tempo reale.
I webhook possono essere attivati da: creazione nuova transazione, approvazione transazione, rifiuto transazione, rimborsi e chargeback, nuova registrazione affiliato e approvazione affiliato. Puoi configurare URL diversi per eventi diversi.
Puoi includere qualsiasi dato di transazione o affiliato usando variabili dinamiche. Per i webhook vendite, puoi usare oltre 40 variabili inclusi ID transazione, commissione, ID ordine, ID prodotto, ID affiliato, nome campagna e campi dati personalizzati. Per i webhook registrazione, puoi includere dettagli affiliato come nome, email e campi profilo personalizzati.
Si, Post Affiliate Pro supporta tipi di richiesta GET, POST (form-urlencoded) e POST JSON. Puoi scegliere il formato che meglio si adatta ai requisiti del tuo sistema ricevente.
Connetti Post Affiliate Pro al tuo CRM, piattaforma email o qualsiasi sistema esterno con potenti webhook e callback. Ricevi notifiche in tempo reale per ogni evento importante.
Scopri come eseguire callback in Post Affiliate Pro. Scopri la configurazione degli URL di callback, le best practice di sicurezza e casi d'uso reali per automa...
Scopri come funzionano i Callback delle Applicazioni in Post Affiliate Pro. Scopri trigger di eventi personalizzabili per vendite, lead e registrazioni di affil...
Integra CartHook con Post Affiliate Pro per migliorare il tuo negozio Shopify con check-out personalizzabili su una pagina e upsell post-acquisto. Scopri funzio...
Unisciti alla nostra community di clienti soddisfatti e fornisci un eccellente supporto clienti con PostAffiliatePro.
