Cosa sono i webhook in Post Affiliate Pro?

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.

Quali eventi possono attivare un webhook?

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.

Quali dati posso includere in un URL webhook?

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.

I webhook supportano le richieste POST?

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.

Webhook e Callback

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.

Integration Automation Webhooks Callbacks

Disponibile in:

Post Affiliate Pro Ultimate , Post Affiliate Network

Cosa sono Webhook e Callback?

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:

Integrazione CRM - Aggiorna automaticamente il tuo database clienti quando avvengono vendite
Automazione Email - Attiva sequenze email basate su azioni degli affiliati
Sistemi Contabili - Sincronizza dati transazioni con il tuo software finanziario
Dashboard Personalizzate - Costruisci dashboard di reportistica in tempo reale
Tracciamento di Terze Parti - Notifica piattaforme di tracciamento esterne delle conversioni

Tipi di Webhook

Post Affiliate Pro supporta due tipi principali di webhook:

Webhook Tracciamento Vendite

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.

Webhook Registrazione Affiliati

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

Tipi di Richiesta

Post Affiliate Pro supporta tre tipi di richiesta HTTP per i webhook:

Richiesta GET

I parametri vengono aggiunti all’URL come parametri query string.

https://your-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456

Richiesta POST (Form-Urlencoded)

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

Richiesta POST JSON

I parametri vengono inviati come oggetto JSON nel corpo della richiesta.

Content-Type: application/json

{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}

Variabili Disponibili per Webhook Vendite

Puoi usare variabili dinamiche nei tuoi URL webhook che vengono automaticamente sostituite con valori reali. Usa il formato ${#nomevariabile#} per includere una variabile.

Dati Transazione

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

Dati Affiliato

Variabile	Descrizione
`${#userid#}`	ID utente affiliato
`${#refid#}`	ID referral affiliato

Dati Clic

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

Dati Transazione Personalizzati

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

Dati Geografici e Tecnici

Variabile	Descrizione
`${#ip#}`	Indirizzo IP del cliente
`${#countrycode#}`	Codice paese basato su IP
`${#refererurl#}`	URL referrer

Dati Valuta

Variabile	Descrizione
`${#originalcurrency#}`	Nome valuta originale
`${#originalcurrencyvalue#}`	Valore valuta originale
`${#originalcurrencyrate#}`	Tasso di cambio usato

Note

Variabile	Descrizione
`${#merchantnote#}`	Nota visibile all’affiliato
`${#systemnote#}`	Nota visibile solo al merchant
`${#actionName#}`	Nome tipo commissione action
`${#actionCode#}`	Codice tipo commissione action

Variabili Disponibili per Webhook Registrazione

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

Supporto Multi-Tier

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:

Hai bisogno di tracciare le commissioni a tutti i livelli della tua gerarchia affiliati
Il tuo sistema esterno ha bisogno di conoscere i guadagni dei sub-affiliati
Stai costruendo reportistica completa che include tutti i livelli di commissione

Opzioni di Filtraggio Webhook

Puoi configurare i webhook per essere piu specifici:

Per Tipo Commissione

Limita il webhook a un tipo di commissione specifico (es. solo per commissioni action “Vendite Premium”).

Per Affiliato

Crea webhook che si attivano solo per un affiliato specifico. Questo e utile per:

Affiliati che usano i propri sistemi di tracciamento
Integrazioni speciali per affiliati top-performer
Testare i webhook con un singolo affiliato prima del rollout

Per Account (Modalita Network)

In Post Affiliate Network, puoi creare webhook specifici per account.

Log e Monitoraggio Webhook

Post Affiliate Pro mantiene un log completo di tutte le esecuzioni webhook, accessibile nel pannello merchant sotto Strumenti > Log Callback.

Il log mostra:

ID Log - Identificatore unico per ogni esecuzione webhook
ID Callback - Quale configurazione webhook e stata usata
URL Richiesta - L’URL completo che e stato chiamato (con variabili sostituite)
Data Creazione - Quando il webhook e stato messo in coda
Ultimo Retry - Quando e stato fatto l’ultimo tentativo di esecuzione
Numero Retry - Quante volte il sistema ha tentato l’esecuzione
Stato - In Sospeso, Inviato o Errore
Messaggio Errore - Dettagli se il webhook e fallito

Retry Automatico

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.

Conservazione Log

I log webhook vengono automaticamente puliti dopo un numero configurabile di giorni (predefinito: 60 giorni). Puoi regolare questo in Configurazione > Funzionalita > Application Callback.

Gestione Webhook

Workflow di Approvazione

Per impostazione predefinita, i webhook creati dagli affiliati richiedono approvazione del merchant prima di diventare attivi. I merchant possono:

Abilitare auto-approvazione - Approvare automaticamente tutti i nuovi webhook
Revisione manuale - Approvare o rifiutare ogni webhook individualmente

Gestione Stato

I webhook hanno tre stati possibili:

Approvato - Attivo e verra eseguito quando attivato
In Sospeso - In attesa di approvazione merchant
Rifiutato - Respinto e non verra eseguito

I merchant possono cambiare lo stato del webhook in qualsiasi momento dalla schermata di gestione webhook.

Notifiche Email

Post Affiliate Pro puo inviare notifiche email per eventi relativi ai webhook:

Notifiche Merchant

Nuovo webhook creato da affiliato

Notifiche Affiliato (Opzionali)

Stato webhook cambiato (approvato/rifiutato)
Webhook modificato dal merchant
Webhook eliminato dal merchant

Queste notifiche possono essere abilitate o disabilitate in Configurazione > Notifiche Email.

Esempi di Casi d’Uso

1. Integrazione CRM

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#}

2. Notifica Slack

Notifica il tuo canale team quando un nuovo affiliato si registra:

https://hooks.slack.com/services/xxx/yyy?text=Nuovo+affiliato:+${#firstname#}+${#lastname#}

3. Trigger Piattaforma Email

Aggiungi clienti a una sequenza email dopo l’acquisto:

POST https://email.example.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}

4. Sincronizzazione Software Contabilita

Registra i pagamenti commissioni nel tuo sistema contabile:

https://accounting.example.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}

Come Configurare un Webhook

Accedi al tuo Pannello Merchant
Naviga a Configurazione > Funzionalita
Attiva la funzionalita Application Callbacks
Vai a Campagne > [Seleziona Campagna] > Callback o al gestore callback globale
Clicca Aggiungi Nuovo Callback
Configura:
- Nome - Un nome descrittivo per il webhook
- Tipo - Tracciamento Vendite o Registrazione Affiliato
- Esecuzione - Quando attivare (on create, approve, decline, refund)
- Tipo Richiesta - GET, POST o POST JSON
- URL - Il tuo endpoint con variabili
- Esegui per ogni tier - Si/No
Salva il webhook

Considerazioni sulla Sicurezza

Usa endpoint HTTPS per trasmissione dati sicura
Considera di aggiungere un parametro segreto per verificare la fonte del webhook
Implementa rate limiting sul tuo endpoint ricevente
Valida i dati in arrivo prima di elaborarli
Mantieni i log webhook per scopi di audit

Funzionalita Correlate

Tracciamento S2S - Tracciamento server-to-server per conversioni accurate
API - Accesso programmatico completo a Post Affiliate Pro
API v3 - API RESTful moderna con OAuth 2.0

Domande frequenti

: 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.

Automatizza il Tuo Workflow di Affiliazione

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.

Inizia la Prova Gratuita Prenota una Demo

Per saperne di più

Cosa sono i Callback delle Applicazioni in Post Affiliate Pro?

Scopri come funzionano i Callback delle Applicazioni in Post Affiliate Pro. Scopri trigger di eventi personalizzabili per vendite, lead e registrazioni di affil...

Nov 28, 2025 10 min di lettura

È possibile eseguire una callback da Post Affiliate Pro? Guida completa agli URL di callback

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...

Nov 28, 2025 9 min di lettura

Come notificare un'API esterna quando viene attivata una Ricompensa Prestazionale in Post Affiliate Pro

Scopri diverse soluzioni affidabili per notificare la tua API esterna quando una regola di Ricompensa Prestazionale viene attivata in Post Affiliate Pro, inclus...

Nov 25, 2025 6 min di lettura

performance rewards webhook +4