Integrare Drimify: Guida a API, Webhooks e Callback JavaScript

Quando crei esperienze interattive con Drimify, spesso hai bisogno che i dati fluiscano nel tuo attuale stack tecnologico—per esempio, aggiungendo automaticamente una nuova piattaforma, un nuovo lead al tuo CRM o attivando un evento personalizzato sul tuo sito web nel momento in cui un utente termina una partita. Per farlo, Drimify offre tre metodi di integrazione: API, Webhooks, e Callback JavaScript. Ecco come scegliere quello giusto per le esigenze del tuo business.

1. API: Il Pull Dati "On-Demand"

Un'API (Interfaccia di Programmazione delle Applicazioni) consente al tuo sistema di richiedere specifiche informazioni da Drimify ogni volta che ne hai bisogno.

• Come funziona: Il tuo server invia una richiesta a Drimify chiedendo dati specifici (es. "Dammi tutte le iscrizioni delle ultime 24 ore"). Drimify poi ti invia quei dati indietro.
• Ideale per: Generare report, sincronizzare grandi quantità di dati con la tua dashboard, o verificare numeri di partecipazione alla fine di una campagna.
• Punto chiave: Il tuo sistema inizia la conversazione.

2. Webhook: Il Push "In Tempo Reale"

Un Webhook è una notifica inviata automaticamente da Drimify al tuo server nel momento in cui si verifica un evento specifico.

• Come funziona: Definisci un "Trigger" (come un utente che completa un modulo di registrazione o un'esperienza). Non appena l'evento accade, Drimify invia i dettagli di contatto dell'utente o i dati direttamente al tuo CRM o URL del database.
• Ideale per: Automazione in tempo reale, come inviare istantaneamente una email di "Benvenuto" o aggiornare il profilo di un lead nel tuo CRM.
• Punto chiave: Drimify inizia automaticamente la conversazione in base a un evento predefinito.

3. Callback JavaScript: La Reazione "In-Browser"

Un Callback JavaScript gestisce la comunicazione tra il widget Drimify e il sito web o l'app dove è incorporato. A differenza di API o Webhooks, questo avviene localmente nel browser dell'utente.

• Come funziona: Il tuo sito web "ascolta" le azioni che avvengono all'interno dell'iframe di Drimify. Quando un utente raggiunge un traguardo specifico, la partita invia un segnale alla tua pagina genitore (es. onComplete).
• Ideale per: Attivare cambiamenti visivi immediati sul tuo sito, come nascondere la partita e rivelare un link di download nascosto o reindirizzare l'utente a una specifica landing page.
• Punto chiave: Connettere l'esperienza al front-end del tuo sito web in tempo reale.

Confronto e Casi d'Uso

Comprendere il "Backend" vs. "Frontend"

Per scegliere il metodo giusto, chiediti: "Dove devono andare i dati?"

• Al tuo Database o CRM (Backend): Usa Webhooks. È così che invii l'indirizzo email di un lead o i dettagli di contatto in modo sicuro da Drimify ai tuoi sistemi interni (come HubSpot, Salesforce o un database personalizzato). Funziona perfettamente sia che la tua campagna sia su un sito web o in un'app.
• Allo Schermo dell'Utente (Frontend): Usa Callback JavaScript. Questo serve quando vuoi che il sito stesso reagisca immediatamente a un'azione del giocatore—per esempio, mostrando un pulsante "Richiedi il tuo Sconto" sulla tua pagina web nel momento in cui terminano la partita.### Confronto dell'Integrazione

Sommario dei Casi d'Uso

Che stiate incorporando Drimify su un sito web o all'interno di un'app mobile, utilizzerete spesso una combinazione di entrambi:

1. Un Webhook per garantire che il tuo team di marketing riceva i dettagli di contatto del lead nel tuo CRM.
2. Un JavaScript Callback per assicurare che l'utente veda immediatamente un messaggio di "Grazie" o un link per la ricompensa senza dover aggiornare la pagina.

Nota sui Callbacks: Poiché i JavaScript Callbacks vengono eseguiti nel browser dell'utente, sono eccellenti per l'esperienza utente (UX) ma non dovrebbero essere utilizzati per la convalida di dati ad alta sicurezza. Per trasferimenti di dati sicuri lato server (come informazioni sensibili sui lead), dai sempre priorità ai Webhooks.

Aggiornato il: 20/03/2026