Introduzione
Le API e i webhooks di idloom offrono strumenti potenti per automatizzare i flussi di lavoro e integrare sistemi esterni. Utilizzando le API, gli utenti possono sincronizzare facilmente i dati tra idloom e altri software, migliorando l’efficienza nella gestione degli eventi. I webhooks, invece, consentono di attivare trigger in tempo reale, garantendo che azioni specifiche o notifiche vengano eseguite automaticamente quando si verificano eventi all’interno della piattaforma.
Queste funzionalità sono ideali per organizzatori di eventi, sviluppatori e amministratori IT che desiderano personalizzare e ampliare le capacità della piattaforma.
Per iniziare
In idloom, crediamo fermamente nella proprietà dei dati, e le informazioni che raccogli appartengono esclusivamente a te. Per questo motivo, i nostri moduli di integrazione sono disponibili a partire dalla versione light, permettendoti di integrare idloom nel tuo ecosistema software senza problemi, sia che tu sia un utente occasionale o frequente.
Accedi alla sezione integrazioni dell’applicazione Events e avvia una nuova integrazione. Puoi scegliere tra un set di integrazioni native predefinite o crearne una personalizzata, che esploreremo più avanti.
Integrazione Personalizzata
L’integrazione si compone di quattro elementi principali:
- Impostazioni di base: Definisci il nome, il profilo che lo utilizzerà e l’eventuale chiave API.
- Configurazione automatica: Stabilisci una struttura fissa per i moduli di registrazione per inviare dati strutturati all’app esterna.
- Mappatura dei campi: Personalizza i dati per garantirne la compatibilità con l’app esterna.
- Webhooks: Configura i webhooks per la trasmissione dei dati in tempo reale e collegali ai trigger di idloom per automatizzare il processo.
Abilitare l’Accesso ai Dati del Profilo
Con l’integrazione che stai costruendo, puoi accedere alle informazioni sugli eventi e alle registrazioni tramite API o attivare webhooks. Per farlo, dovrai collegare il profilo pertinente all’integrazione e abilitare l’accesso API.
Per migliorare la sicurezza dei dati, consigliamo di:
- Creare integrazioni separate per diversi profili.
- Abilitare l’accesso API solo quando necessario.
- Generare una nuova chiave API al passaggio da sviluppo a produzione e aggiornarla regolarmente (es. ogni 6-12 mesi).
Creare e Gestire Webhooks
Inizia aggiungendo un webhook e selezionando il trigger da attivare:
- event.create, event.update, event.delete, event.manual: Questi trigger inviano un payload REST di eventi al tuo endpoint, utilizzando lo stesso formato del metodo API Get Events. Il trigger manuale aggiunge una nuova opzione nelle azioni relative all’evento.
- guest.create, guest.update, guest.delete, guest.manual: Questi trigger inviano un payload REST dei partecipanti, con lo stesso formato del metodo API Get Attendees. Il trigger manuale aggiunge una nuova opzione nelle azioni relative ai partecipanti.
Successivamente, puoi specificare il nome del webhook, l’URL per inviare il payload e il metodo HTTP da utilizzare (GET, POST, PUT, DELETE, PATCH). Se hai selezionato un trigger manuale, il nome del webhook diventerà l’etichetta della nuova funzione nel menu.
Puoi anche configurare gli headers della richiesta, come i Bearer Tokens o altre impostazioni di sicurezza.
Se desideri limitare il webhook a eventi specifici, inserisci semplicemente i loro valori UID separati da virgole. Queste informazioni si trovano nella sezione Geek > Analytics & Tracking delle impostazioni dell’evento.
Attivare Webhooks di Integrazione nei Profili
Ci sei quasi! Sebbene la connessione di un’integrazione ai profili e l’abilitazione dell’accesso API fornisca automaticamente accesso tramite API, questo non vale per i webhooks.
Per attivare i webhooks per un’integrazione specifica, vai su Profili Eventi, seleziona un profilo e naviga in Geek > Integrazioni. Da lì, attiva l’integrazione desiderata. Ricorda che solo un’integrazione può essere attiva per profilo alla volta.
Sostituire l’Integrazione Predefinita di un Profilo per un Evento Specifico
La buona notizia è che, indipendentemente dai webhooks attivati per un profilo, puoi comunque sostituirli per un evento specifico. Vai semplicemente alla sezione Geek > Integrazioni nelle impostazioni dell’evento, scegli l’integrazione che desideri applicare, modifica o sostituisci i mappaggi dei campi se necessario, e persino scegli di attivare i webhooks quando viene effettuato un pagamento di una registrazione.
Serve più personalizzazione?
Se hai bisogno di ulteriori processi o validazioni prima di inviare il payload, o di una maggiore sicurezza con SSL a due vie, contatta il tuo account manager, che inoltrerà la tua richiesta al nostro team tecnico.
Siamo impegnati a fornire la documentazione migliore possibile, anche per contenuti tecnici. Se hai domande o suggerimenti, non esitare a contattarci. Il tuo feedback ci aiuterà a migliorare questa guida e la sezione FAQ.
Buon divertimento!
Il team idloom