Utenti e collegamenti API.
Ultima modifica: 20-08-2024Attraverso una chiave API è possibile recuperare informazioni (automaticamente) sulla piattaforma. Ci sono diverse parti che hanno stabilito collegamenti con sistemi come Salesforce, Collectekracht, Microsoft Dynamics.
Contenuto dell'articolo
API-key
È possibile generare e utilizzare una chiave API senza alcun costo. Una chiave API consente di effettuare chiamate API e di recuperare informazioni dal database associato alla piattaforma. Una chiave API è collegata a un sito e consente quindi di recuperare informazioni solo su quel sito.
Limite
C'è un limite predefinito di 100 richieste al minuto e 500 richieste all'ora. Questo è sufficiente per recuperare i dati. Se si desidera aumentare questo numero, è possibile contattare iRaiser.
Usa la chiave API
Nel nostro portale degli sviluppatori potete trovare tutte le informazioni tecniche sull'utilizzo della chiave API. In questo modo è possibile vedere esattamente quali informazioni è possibile recuperare. Ad esempio, è possibile vedere l'iRaiser API, l'Digicollect API e le informazioni tecniche su iRaiser Connect.
Generazione chiavi API
Via Integrazioni > Utenti API si arriva alla pagina di panoramica con gli utenti API. Qui si può generare una nuova chiave nel modo seguente:
Fare clic su Aggiungi e inserire il nome dell'utente. Si può quindi scegliere se l'utente può solo leggere le informazioni o anche modificarle (tramite i permessi di scrittura). In questo Menu è anche possibile disattivare l'utente in un secondo momento.
Quando si fa clic su salva, gli utenti API sono stati creati. Cliccare sulla i per vedere la chiave
Vedrete anche le informazioni sugli indirizzi ip conosciuti da cui questa chiave è stata usata e quali chiamate sono state effettuate.
Condivisione della chiave API
Una chiave API dà fondamentalmente accesso a tutti i dati presenti sul sito. Pertanto, assicuratevi di condividere una chiave in modo sicuro. Ad esempio, se un integratore ne ha bisogno per stabilire il collegamento, si consiglia di inviarla tramite un file protetto da password e di condividere la password, ad esempio, tramite SMS.
Collegamento con il CRM
Potete inserire i dati della piattaforma iRaiser nel vostro CRM in diversi modi. In questo caso offriamo un modulo fisso in cui è possibile ottenere i dati dalla piattaforma e poi è necessario elaborarli autonomamente e inserirli nel proprio CRM. Spesso è necessaria una conversione per assicurarsi che i dati siano convertiti nel formato dei dati del CRM e che siano collegati correttamente. Per questo motivo, per impostare questo processo, si ricorre spesso a un integratore.
Sulla base dei download
Dalla dashboard di iRaiser è possibile creare download, ad esempio di Raccolte Fondi, Squadre e Donazioni. Alcuni nostri clienti effettuano periodicamente un'importazione in un CRM sulla base di questi download. Spesso c'è ancora qualche modifica da fare per rendere i dati adatti all'importazione, oppure l'importazione è allineata con il file Excel che si può generare da iRaiser. Di solito annunciamo le modifiche alle colonne, per garantire che ciò non interrompa il processo del cliente.
Collegamento automatico (non in tempo reale)
Utilizzando la chiave api, è possibile recuperare periodicamente i dati dalla piattaforma iRaiser. Ad esempio, se si recuperano i dati una volta all'ora o al giorno e li si elabora nel CRM. La creazione di un tale collegamento richiede conoscenze tecniche e di solito è necessario un integratore per questo scopo.
Accoppiamento tramite iRaiser Connect (realtime)
È possibile stabilire un collegamento in tempo reale anche tramite iRaiser Connect. Questo funziona sulla base dei webhook. Ci viene fornito un endpoint a cui inviare un messaggio quando si verifica un determinato evento e, sulla base di questo, è possibile utilizzare la chiave api per recuperare tutti i dati corrispondenti e poi elaborarli autonomamente. È possibile impostare facoltativamente a quali eventi inviare il messaggio. La creazione di un collegamento di questo tipo richiede conoscenze tecniche e di solito è necessario un integratore. L'installazione del collegamento comporta anche dei costi da parte nostra. Se volete saperne di più, contattate il vostro account manager.
Collegamento a Salesforce (in tempo reale tramite gli oggetti di iRaiser)
È possibile interfacciarsi con Salesforce tramite iRaiser Connect. Tuttavia, abbiamo anche stabilito un collegamento standard con Salesforce. La differenza con il collegamento tramite iRaiser Connect è che in Salesforce inseriamo tutte le informazioni in oggetti iRaiser già pronti (una sorta di pacchetti con tutti i dati) direttamente in Salesforce. Il sistema deve poi essere recuperato da voi e inserito in Salesforce. Tuttavia, è necessario disporre di conoscenze tecniche per garantire che i dati vengano elaborati in Salesforce. Ad esempio, dovete vedere esattamente quali dati volete e potreste dover convertire i dati in un altro formato in modo che corrispondano ai vostri dati. Per automatizzare queste operazioni, i nostri clienti ricorrono spesso a un integratore. Potete trovare le informazioni tecniche su questa pagina alla voce Salesforce. L'installazione del collegamento da parte nostra comporta anche dei costi. Se volete saperne di più, potete contattare il vostro account manager.
Integrazioni famose
CM
CM offre collegamenti alla propria CDP (Customer Data Platform), dove arrivano tutte le informazioni. Da qui è possibile impostare mail, ma soprattutto viaggi in mobilità, ad esempio durante gli eventi. Possono anche collegarsi a Digicollect per la raccolta di fondi. Più informazioni.
STB Eudonet
STB Eudonet ha creato un collegamento al proprio CRM sia per iRaiser che per Digicollect. In tempo reale, le Donazioni o le Raccolte Fondi sono immediatamente visibili anche nel CRM di Eudonet. Più informazioni.
Ifunds (Engage)
Con Ifunds, iRaiser può essere abbinato a Engage 365. Tutti i promotori, i donatori, le donazioni e le Iscrizioni alla newsletter che vengono reclutati finiscono automaticamente in Engage 365. Più informazioni.
Cisis (Converse/Forza Collettiva)
Cisis può collegare una piattaforma iRaiser a Converse e le piattaforme Digicollect a Collectekracht. Più informazioni.
Xapti
Xapti offre una soluzione CRM online in cui è possibile registrare tutto ciò che riguarda il processo di donazione. I dati di iRaiser possono essere collegati a questa soluzione. Più informazioni.
Civicoop (link automatico, non in tempo reale)
Civicoop si è collegato a CiviCRM. CiviCRM è un CRM open source rivolto alle organizzazioni non profit e CiviCooP è attivo nel mondo CiviCRM di lingua olandese da diversi anni. In questo modo, sono soprattutto nelle Fiandre.
L'estensione che è stata sviluppata è open source e può quindi essere utilizzata da più organizzazioni che lavorano con CiviCRM e desiderano recuperare i dati da iRaiser. L'esistenza può essere trovata qui.
Link a Salesforce (tramite il nostro link a Salesforce)
Xebia (ex Gcompany)
Xebia, in qualità di integratore, ha già aiutato molti clienti a stabilire collegamenti con Salesforce e garantisce che i dati di iRaiser vengano elaborati nel vostro ambiente Salesforce. Più informazioni.
Cobra
Cobra funziona anche con il collegamento standard a Salesforce e aiuta a semplificare i processi dei clienti con Salesforce. Più informazioni.
Bluedesk
Bluedesk integra i dati della piattaforma iRaiser in Salesforce tramite il link iRaiser. Più informazioni
Outbirds (ex Bridgin.it)
Outbirds fornisce un collegamento personalizzato tra la piattaforma iRaiser e Salesforce. Più informazioni.
Esempi di clienti
L'api può essere utilizzata anche in altri modi, ad esempio durante gli eventi. Ecco alcuni esempi:
Fondazione Maarten van der Weijden - streaming
La stessa Fondazione Maarten van der Weijden si è collegata al proprio streaming tramite l'api. In questo modo, hanno raccolto periodicamente le recenti Donazioni e le hanno visualizzate sullo streaming:
A questo scopo hanno anche creato una libreria che anche altri clienti (con conoscenze tecniche) possono utilizzare. Non hanno utilizzato un link iRaiser Connect, ma hanno tenuto conto di eventuali limiti durante il recupero dei dati.
Maratona di gioco olandese - streaming
La maratona di gioco olandese ha utilizzato iRaiser Connect nel 2020 per mostrare le Donazioni in tempo reale e i relativi messaggi sullo streaming. Per saperne di più, consultare questo articolo.
KNRM - Sito d'asta
Kikz si è collegato al sito KNRM tramite l'api. Hanno un sito d'aste speciale in cui chi inizia un'azione può accedere con il proprio account iRaiser (che viene controllato tramite l'api se i dati sono corretti) e mettere all'asta i propri oggetti. Dopo l'asta, l'importo viene aggiunto al posto giusto nella piattaforma iRaiser tramite una donazione manuale.
Fondazione Erasmus MC - link a Eroutes
Dopo aver avviato un'azione per il Tour Against Cancer, chi inizia l'azione riceve un invito da eRoutes. In base alla distanza scelta e alla propria posizione GPS, l'app suggerisce i percorsi da seguire.