Torna alle guide

Configurare le tue offerte FlamyFox

Collega FlamyFox a RoyLead — salva le credenziali, attiva i postback degli stati e crea l'offerta con il suo Offer ID per inoltrare i lead in automatico.

Aggiornata il 24 giugno 2026


FlamyFox è integrato nativamente in RoyLead: una volta salvate le credenziali e creata l'offerta, ogni lead raccolto sulla tua landing viene inoltrato a FlamyFox in automatico, e gli aggiornamenti di stato (approvato / annullato / duplicato) tornano indietro da soli.

💡 Il giro completo è sempre questo: 1) salvi le credenziali → 2) attivi i postback degli stati → 3) crei l'offerta con il suo Offer ID → 4) la colleghi alle landing page.

Prima di iniziare

Ti servono, dal tuo pannello FlamyFox (app.flamyfox.com):

  • L'Email del tuo account e la tua API Key (nelle impostazioni API del pannello).
  • L'Offer ID di ogni offerta che vuoi promuovere.

📌 Questi valori te li dà FlamyFox, non RoyLead. Se non li trovi, chiedi al tuo manager FlamyFox.

💳 FlamyFox paga in EUR: nell'offerta il payout è già preimpostato su EUR.

Dove trovare l'Offer ID

Apri l'offerta sul pannello FlamyFox: l'ID Offerta è nella sezione omonima, con il pulsante «Copia ID Offerta». È il valore che incollerai nel campo Offer ID quando crei l'offerta (Passo 3).

La pagina dell'offerta su FlamyFox: l'ID Offerta evidenziato, da copiare
La pagina dell'offerta su FlamyFox: l'ID Offerta evidenziato, da copiare

Dove trovare l'API Key

Sul pannello FlamyFox vai in Impostazioni → Tracciamento & API → Gestione API (la prima volta clicca Richiesta API per attivarla). Lì trovi la tua Chiave API: copiala col pulsante «Copia Chiave API». L'Email è invece quella del tuo account FlamyFox.

Gestione API su FlamyFox: la Chiave API da copiare (qui oscurata)
Gestione API su FlamyFox: la Chiave API da copiare (qui oscurata)

1

Salva le credenziali

  1. Vai in Impostazioni → Credenziali Network.
  2. Apri la scheda FlamyFox e compila Email e API Key.
  3. Premi Salva Credenziali: compare il badge verde Credenziali salvate.

Vai in Impostazioni

La scheda FlamyFox: in alto Email e API Key, sotto i tre URL di callback (approvato/annullato/duplicato) da incollare nel pannello
La scheda FlamyFox: in alto Email e API Key, sotto i tre URL di callback (approvato/annullato/duplicato) da incollare nel pannello

🔒 Le credenziali si salvano per team e le riusano tutte le offerte FlamyFox: le inserisci una volta sola.

2

Attiva i postback degli stati

FlamyFox ti comunica l'esito di ogni ordine richiamando RoyLead. Per ogni stato c'è un URL dedicato.

  1. Sempre in Credenziali Network, genera/copia il Webhook Token.
  2. Sotto la scheda FlamyFox, RoyLead ti mostra tre URL di callback già pronti (col token e il segnaposto del lead id): Approvato ✓, Annullato ✗, Duplicato ⊘.
  3. Apri il postback globale di FlamyFox (c'è il link «Configura sul network» accanto agli URL) e incolla ciascun URL nel campo dello stato corrispondente.

💡 Lascia il segnaposto del lead id ({{subid}}) così com'è: FlamyFox lo sostituisce da solo. Senza postback i lead vengono comunque inoltrati, ma restano «in attesa».

3

Crea l'offerta

  1. Vai in Offerte e premi Nuova Offerta.
  2. Immagine e Nome — l'identità dell'offerta.
  3. Network — scegli FlamyFox dal menu. Sotto compare la Configurazione Network.
  4. Offer ID (FlamyFox) — incolla l'ID dell'offerta.
  5. Quantity — lascia 1, salvo offerte in bundle che richiedono qty 2.
  6. Payout — quanto incassi per lead valido, in EUR (già preselezionato).
  7. Prezzo + Valuta — il prezzo del prodotto al cliente, nella valuta locale dell'offerta.
  8. Cap giornaliero / Cap totale, Finestra duplicati, Paesi target, URL Offerta — come per ogni offerta.
  9. Salva.

Vai in Offerte

Il form Nuova Offerta con FlamyFox selezionato: campi Offer ID e Quantity
Il form Nuova Offerta con FlamyFox selezionato: campi Offer ID e Quantity

4

Collega l'offerta alle landing page

Nella lista Offerte, sulla card dell'offerta clicca l'icona a catena («Collega a Landing») e scegli le landing page da collegare: da quel momento ogni lead raccolto su quelle landing viene inoltrato a quell'offerta FlamyFox.

Sulla card dell'offerta, l'icona a catena «Collega a Landing» (evidenziata) per legare l'offerta alle tue landing page
Sulla card dell'offerta, l'icona a catena «Collega a Landing» (evidenziata) per legare l'offerta alle tue landing page

Verifica

  1. Pubblica una landing collegata all'offerta FlamyFox.
  2. Invia un lead di prova dal form.
  3. In RoyLead → Lead il lead deve passare a Inoltrato; quando FlamyFox lo processa, lo stato si aggiorna da solo grazie ai postback del Passo 2.

Vai ai Lead

💡 Stato bloccato su «in attesa»? Ricontrolla che i tre URL di callback (Passo 2) siano incollati nei campi giusti del pannello FlamyFox, col segnaposto intatto.

Pronto a metterlo in pratica?

Crea il tuo account RoyLead e parti in pochi minuti.

Inizia gratis