API-User und Links.
Das letzte mal angepasst: 20-08-2024Mit einem API-Schlüssel können Sie (automatisch) Informationen auf der Plattform abrufen. Es gibt mehrere Parteien, die Verbindungen zu Systemen wie Salesforce, Collectekracht, Microsoft Dynamics hergestellt haben.
Inhalt des Artikels
API-Schlüssel
Sie können selbst einen API-Schlüssel generieren und kostenlos verwenden. Mit einem API-Schlüssel können Sie API-Aufrufe tätigen und Informationen aus der mit der Plattform verbundenen Datenbank abrufen. Ein API-Schlüssel ist mit einer Website verknüpft und erlaubt Ihnen daher nur den Abruf von Informationen über diese Website.
Limit
Es gibt ein Standardlimit von 100 Anfragen pro Minute und 500 Anfragen pro Stunde. Dies ist auch ausreichend, um die Daten abzurufen. Wenn Sie diese Zahl erhöhen möchten, können Sie sich an iRaiser wenden.
API-Schlüssel verwenden
In unserem Entwicklerportal finden Sie alle technischen Informationen zur Nutzung des API-Schlüssels. So können Sie genau sehen, welche Informationen Sie abrufen können. Zum Beispiel können Sie dort die iRaiser API, die Digicollect API und die technischen Informationen zuiRaiser Connect einsehen.
API-Schlüsselerzeugung
Über Integrationen > API-Nutzer gelangen Sie auf die Übersichtsseite mit API-Nutzern. Hier können Sie wie folgt einen neuen Schlüssel generieren:
Klicken Sie auf Hinzufügen und geben Sie dort den Namen des Benutzers ein. Sie können dann wählen, ob der Benutzer die Informationen nur lesen oder auch ändern darf (über Schreibrechte). In diesem Menü können Sie den Benutzer auch später wieder deaktivieren.
Wenn Sie auf Speichern klicken, sind die API-User erstellt. Klicken Sie auf das i, um den Schlüssel zu sehen
Dort sehen Sie auch Informationen über die bekannten IP-Adressen, von denen dieser Schlüssel verwendet wurde und welche Anrufe getätigt wurden.
API-Schlüssel teilen
Ein API-Schlüssel gibt Ihnen grundsätzlich Zugang zu allen Daten auf der Website. Stellen Sie daher sicher, dass Sie einen Schlüssel auf sichere Weise weitergeben. Wenn ein Integrator den Schlüssel benötigt, um die Verbindung herzustellen, empfehlen wir, ihn in einer passwortgeschützten Datei zu versenden und das Passwort z. B. per SMS weiterzugeben.
Verbindung mit CRM
Sie können Daten aus der iRaiser-Plattform auf verschiedene Weise in Ihr eigenes CRM übernehmen. Dabei bieten wir ein festes Formular an, mit dem Sie die Daten von der Plattform abrufen können und diese dann selbst weiterverarbeiten und in Ihr CRM übernehmen müssen. Oft ist noch eine Konvertierung erforderlich, um sicherzustellen, dass die Daten in das Datenformat des CRM konvertiert und richtig verknüpft werden. Um diesen Prozess einzurichten, wird daher oft ein Integrator eingesetzt.
Basierend auf Downloads
Vom iRaiser-Dashboard aus können Sie Downloads erstellen, zum Beispiel von Spendenaktionen, Teams und Spenden. Es gibt Kunden von uns, die auf der Grundlage dieser Downloads regelmäßig einen Import in ein CRM-System durchführen. Oft müssen die Daten noch bearbeitet werden, um sie für den Import geeignet zu machen, oder der Import wird mit der Excel-Datei abgeglichen, die Sie aus iRaiser generieren können. In der Regel kündigen wir Änderungen an den Spalten an, um den Kundenprozess nicht zu stören.
Automatische Verknüpfung (nicht in Echtzeit)
Mit Hilfe des api-Schlüssels können Sie regelmäßig Daten von der iRaiser-Plattform abrufen. Zum Beispiel, wenn Sie die Daten einmal pro Stunde oder pro Tag abrufen und im CRM verarbeiten. Das Erstellen einer solchen Verknüpfung erfordert technisches Wissen und in der Regel benötigen Sie dafür einen Integrator.
Kopplung über iRaiser Connect (realtime)
Sie können auch über iRaiser Connect eine Echtzeit-Kopplung herstellen. Dies funktioniert auf der Basis von Webhooks. Wir erhalten einen Endpunkt, an den wir eine Nachricht senden können, wenn ein bestimmtes Ereignis eintritt, und darauf basierend können wir mit dem Api-Schlüssel alle entsprechenden Daten abrufen und dann selbst verarbeiten. Wir können optional einstellen, bei welchen Ereignissen eine solche Nachricht gesendet wird. Das Erstellen einer solchen Verknüpfung erfordert technische Kenntnisse und in der Regel benötigen Sie dafür einen Integrator. Auch die Installation der Verknüpfung ist mit Kosten unsererseits verbunden. Wenn Sie mehr darüber wissen wollen, wenden Sie sich bitte an Ihren Account Manager.
Salesforce-Anbindung (Echtzeit über iRaiser-Objekte)
Sie können eine Schnittstelle zu Salesforce auf der Basis von iRaiser Connect herstellen. Wir haben aber auch eine Standard-Verknüpfung mit Salesforce eingerichtet. Der Unterschied zur Verknüpfung über iRaiser Connect ist, dass wir in Salesforce alle Informationen in vorgefertigten iRaiser-Objekten (eine Art Pakete mit allen Daten darin) direkt in Salesforce ablegen. Diese müssen dann von Ihnen abgerufen und in Salesforce eingefügt werden. Allerdings benötigen Sie technisches Wissen, um sicherzustellen, dass die Daten anschließend in Salesforce verarbeitet werden. Sie müssen zum Beispiel genau sehen, welche Daten Sie wollen, und Sie müssen die Daten möglicherweise in ein anderes Format konvertieren, damit sie mit Ihren Daten übereinstimmen. Um dies zu automatisieren, nutzen unsere Kunden oft einen Integrator. Die technischen Informationen finden Sie auf dieser Seite unter der Rubrik Salesforce. Die Installation der Verknüpfung ist auch auf unserer Seite mit Kosten verbunden. Wenn Sie mehr darüber wissen wollen, wenden Sie sich an Ihren Account Manager.
Bekannte Integrationen
CM
CM bietet Links zu seiner CDP (Customer Data Platform), wo alle Informationen eingehen. Von hier aus können Sie Mails einrichten, aber vor allem auch mobile Fahrten, zum Beispiel bei Veranstaltungen. Sie können auch eine Verbindung zu Digicollect für eine Abholung herstellen. Mehr Informationen.
STB Eudonet
STB Eudonet hat sowohl für iRaiser als auch für Digicollect eine Verbindung zu seinem CRM hergestellt. In Echtzeit ist eine Spende oder Spendenaktion auch sofort im CRM von Eudonet sichtbar. Mehr Informationen.
Ifunds (Engage)
Über Ifunds kann iRaiser mit Engage 365 gekoppelt werden. Alle geworbenen Mitstreiter, Spender und Spenden sowie Newsletter Abonnements landen automatisch in Engage 365. Mehr Informationen.
Cisis (Converse/Collective Force)
Cisis kann eine iRaiser-Plattform mit Converse und Digicollect-Plattformen mit Collectekracht verbinden. Mehr Informationen.
Xapti
Xapti bietet eine Online-CRM-Lösung, in der alles rund um den Spendenprozess erfasst werden kann. Daten aus iRaiser können damit verknüpft werden. Mehr Informationen.
Civicoop (automatischer Link, nicht in Echtzeit)
Civicoop hat sich mit CiviCRM verbunden. CiviCRM ist ein Open-Source-CRM, das sich an Non-Profit-Organisationen richtet, und CiviCooP ist schon seit einigen Jahren in der niederländischsprachigen CiviCRM-Welt aktiv. Dabei sind sie vor allem in Flandern tätig.
Die entwickelte Erweiterung ist Open Source und kann daher von weiteren Organisationen genutzt werden, die mit CiviCRM arbeiten und Daten aus iRaiser abrufen möchten. Die Existenz kann hier gefunden werden.
Salesforce-Links (über unseren Salesforce-Link)
Xebia (ehemals Gcompany)
Xebia hat als Integrator bereits vielen Kunden zu Salesforce-Anbindungen verholfen und sorgt dafür, dass Daten aus iRaiser in der eigenen Salesforce-Umgebung verarbeitet werden. Mehr Informationen.
Cobra
Cobra arbeitet ebenfalls mit der Standard-Verknüpfung zu Salesforce und hilft, Kundenprozesse mit Salesforce zu optimieren. Mehr Informationen.
Bluedesk
Bluedesk integriert Daten aus der iRaiser-Plattform in Salesforce über den iRaiser-Link. Weitere Informationen
Outbirds (ehemals Bridgin.it)
Outbirds bietet eine maßgeschneiderte Verbindung zwischen der iRaiser-Plattform und Salesforce. Mehr Informationen.
Kundenbeispiele
Die Api kann auch auf andere Weise genutzt werden, etwa bei Veranstaltungen. Hier sind einige Beispiele:
Maarten van der Weijden Stiftung - Streaming
Die Maarten van der Weijden Foundation selbst hat ihren Stream über die api verlinkt. Dabei sammelten sie regelmäßig aktuelle Spenden und zeigten sie im Stream an:
Zu diesem Zweck haben sie auch eine Bibliothek eingerichtet, die andere Kunden (mit technischen Kenntnissen) ebenfalls nutzen können. Sie haben keinen iRaiser Connect-Link verwendet, sondern bei der Datenabfrage auf eventuelle Einschränkungen geachtet.
Holländischer Spielemarathon - Streaming
Der Dutch Gaming Marathon nutzte iRaiser Connect im Jahr 2020, um Spenden und zugehörige Nachrichten in Echtzeit im Stream anzuzeigen. Mehr dazu können Sie in diesem Artikel lesen.
KNRM - Auktionshaus
Kikz hat sich über die API mit dem KNRM verbunden. Sie haben eine spezielle Auktionsseite, auf der sich Aktionsstarter mit ihrem iRaiser-Account anmelden können (über die api wird geprüft, ob die Daten korrekt sind) und ihre eigenen Artikel versteigern können. Nach der Auktion wird der Betrag über eine manuelle Spende an der richtigen Stelle in der iRaiser-Plattform hinzugefügt.
Erasmus MC Stiftung - Link zu Eroutes
Nachdem man eine Aktion für die Tour gegen Krebs gestartet hat, erhalten Aktionsstarter eine Einladung von eRoutes. Auf Basis der selbst gewählten Strecke und des GPS-Standorts schlägt die App Laufstrecken vor.