Utilisateurs de l'API et liens.
Dernière modification: 20-08-2024Grâce à une clé API, vous pouvez récupérer des informations (automatiquement) sur la plateforme. Plusieurs parties ont établi des liens avec des systèmes tels que Salesforce, Collectekracht, Microsoft Dynamics.
Contenu de l'article
Clé API
Vous pouvez générer et utiliser vous-même une clé API gratuitement. Une clé API vous permet d'effectuer des appels API et de récupérer des informations dans la base de données associée à la plateforme. Une clé API est liée à un site et vous permet donc uniquement de récupérer des informations sur ce site.
Limite
La limite par défaut est de 100 demandes par minute et de 500 demandes par heure. Cette limite est suffisante pour récupérer les données. Si vous souhaitez augmenter ce nombre, vous pouvez contacter iRaiser.
Utiliser la clé API
Dans notre portail pour les développeurs, vous trouverez toutes les informations techniques sur l'utilisation de la clé API. Vous pouvez ainsi savoir exactement quelles informations vous pouvez récupérer. Par exemple, vous pouvez y voir l'API iRaiser, l'API Digicollect et les informations techniques sur iRaiser Connect.
Génération de clés API
Via Intégrations > API users, vous arriverez à la page d'aperçu des API users. Ici, vous pouvez générer une nouvelle clé comme suit:
Cliquez sur Ajouter et entrez le nom de l'utilisateur. Vous pouvez ensuite choisir si l'utilisateur peut uniquement lire les informations ou s'il peut également les modifier (via les droits d'écriture). Dans ce Menu, vous pouvez également désactiver l'utilisateur ultérieurement.
Lorsque vous cliquez sur enregistrer, les utilisateurs de l'API ont été créés. Cliquez sur le i pour voir la clé
Vous y trouverez également des informations sur les adresses IP connues par lesquelles cette clé a été utilisée et sur les appels qui ont été effectués.
Partage de la clé API
Une clé API vous donne accès à toutes les données trouvées sur le site. Veillez donc à partager une clé de manière sécurisée. Par exemple, si un intégrateur en a besoin pour établir le lien, nous vous recommandons de l'envoyer via un fichier protégé par mot de passe et de partager le mot de passe par SMS, par exemple.
Lien avec le CRM
Vous pouvez obtenir des données de la plateforme iRaiser dans votre propre CRM de plusieurs façons. Nous proposons un formulaire fixe qui vous permet d'obtenir les données de la plateforme, puis vous devez les traiter vous-même et les intégrer dans votre système de gestion de la relation client (CRM). Souvent, une conversion est encore nécessaire pour s'assurer que les données sont converties au format des données dans le CRM et qu'elles doivent être liées correctement. C'est pourquoi on fait souvent appel à un intégrateur pour mettre en place ce processus.
Sur la base des téléchargements
Depuis le tableau de bord iRaiser, vous pouvez créer des téléchargements, par exemple de Collecteurs, d'Équipes et de Dons. Certains de nos clients effectuent périodiquement une importation dans un CRM sur la base de ces téléchargements. Souvent, il y a encore des modifications à faire pour que les données soient adaptées à l'importation, ou l'importation est alignée avec le fichier Excel que vous pouvez générer à partir d'iRaiser. Nous annonçons généralement les changements apportés aux colonnes, afin de nous assurer que cela ne perturbe pas le processus du client.
Liaison automatique (pas en temps réel)
En utilisant la clé api, vous pouvez récupérer périodiquement les données de la plateforme iRaiser. Par exemple, si vous récupérez les données une fois par heure ou par jour et les traitez dans le CRM. La création d'un tel lien nécessite des connaissances techniques et vous avez généralement besoin d'un intégrateur pour cela.
Couplage via iRaiser Connect (en temps réel)
Vous pouvez également établir un lien en temps réel via iRaiser Connect. Cela fonctionne sur la base des webhooks. On nous donne un point de terminaison auquel envoyer un message lorsqu'un certain événement se produit et, sur cette base, vous pouvez utiliser la clé api pour récupérer toutes les données correspondantes et les traiter vous-même. Il est possible de paramétrer les événements auxquels un tel message est envoyé. La création d'un tel lien exige des connaissances techniques et nécessite généralement l'intervention d'un intégrateur. L'installation du lien entraîne également des coûts pour nous. Si vous souhaitez en savoir plus, veuillez contacter votre gestionnaire de compte.
Lien Salesforce (en temps réel via les objets iRaiser)
Vous pouvez vous interfacer avec Salesforce en vous basant sur iRaiser Connect. Cependant, nous avons également établi un lien standard avec Salesforce. La différence avec le lien via iRaiser Connect est que dans Salesforce, nous mettons toutes les informations dans des objets iRaiser prêts à l'emploi (une sorte de paquets avec toutes les données dedans) directement dans Salesforce. Vous devez ensuite les récupérer et les intégrer dans Salesforce. Cependant, vous avez besoin de connaissances techniques pour vous assurer que les données sont ensuite traitées dans Salesforce. Par exemple, vous devez savoir exactement quelles sont les données que vous voulez et vous devrez peut-être convertir les données dans un autre format pour qu'elles correspondent à vos données. Pour automatiser cela, nos clients font souvent appel à un intégrateur. Vous trouverez les informations techniques sur cette page sous la rubrique Salesforce. L'installation du lien de notre côté entraîne également des coûts. Si vous souhaitez en savoir plus, vous pouvez contacter votre gestionnaire de compte.
Intégrations célèbres
CM
CM propose des liens vers sa CDP (Customer Data Platform) où toutes les informations arrivent. De là, vous pouvez mettre en place des mails, mais surtout des parcours mobiles lors d'événements, par exemple. Il est également possible d'établir un lien avec Digicollect lors d'une collecte. Plus d'informations.
STB Eudonet
STB Eudonet a construit un lien vers son CRM pour iRaiser et Digicollect. En temps réel, les Dons ou les Collecteurs sont immédiatement visibles dans le CRM d'Eudonet. Plus d'informations.
Ifunds (Engage)
Via Ifunds, iRaiser peut être associé à Engage 365. Tous les Projets, donateurs et dons ainsi que les Inscriptions à la Newsletter qui sont recrutés atterrissent automatiquement dans Engage 365. Plus d'informations.
Cisis (Converse/Collective Force)
Cisis peut relier une plateforme iRaiser à Converse et les plateformes Digicollect à Collectekracht. Plus d'informations.
Xapti
Xapti propose une solution CRM en ligne dans laquelle tout ce qui concerne le processus de don peut être enregistré. Les données d'iRaiser peuvent être reliées à cette solution. Plus d'informations
Civicoop (lien automatique, pas en temps réel)
Civicoop a établi un lien avec CiviCRM. CiviCRM est un CRM open source destiné aux organisations à but non lucratif et CiviCooP est actif dans le monde néerlandophone de CiviCRM depuis plusieurs années. Ce faisant, ils sont surtout présents en Flandre.
L'extension qui a été développée est open source et peut donc être utilisée par plus d'organisations qui travaillent avec CiviCRM et voudraient récupérer des données d'iRaiser. L'existence peut être trouvée ici.
Liens Salesforce (via notre lien Salesforce)
Xebia (anciennement Gcompany)
Xebia, en tant qu'intégrateur, a déjà aidé de nombreux clients à établir des liens avec Salesforce et veille à ce que les données provenant d'iRaiser soient traitées dans votre propre environnement Salesforce. Plus d'informations.
Cobra
Cobra fonctionne également avec le lien standard de Salesforce et aide à rationaliser les processus clients avec Salesforce. Plus d'informations.
Bluedesk
Bluedesk intègre les données de la plateforme iRaiser dans Salesforce via le lien iRaiser. Plus d'informations
Outbirds (anciennement Bridgin.it)
Outbirds fournit un lien personnalisé entre la plateforme iRaiser et Salesforce. Plus d'informations.
Exemples de clients
L'api peut également être utilisée d'autres manières, par exemple lors d'événements. Voici quelques exemples:
Fondation Maarten van der Weijden - streaming
La Fondation Maarten van der Weijden a elle-même établi un lien avec son flux via l'API. Ce faisant, ils ont périodiquement collecté des Dons récents et les ont affichés sur le flux:
Ils ont également créé une bibliothèque à cet effet, que d'autres clients (ayant des connaissances techniques) peuvent également utiliser. Ils n'ont pas utilisé de lien iRaiser Connect, mais ont gardé à l'esprit les limites éventuelles lors de la récupération des données.
Marathon de jeux néerlandais - streaming
Le marathon des jeux néerlandais a utilisé iRaiser Connect en 2020 pour afficher en temps réel les Dons et les messages associés sur le flux. Vous pouvez en savoir plus dans cet article.
KNRM - Site d'enchères
Kikz a établi un lien avec le KNRM via l'api. Ils ont un site spécial de vente aux enchères où les initiateurs d'actions peuvent se connecter avec leur compte iRaiser (ceci est vérifié via l'api si les données sont correctes) et mettre aux enchères leurs propres articles. Après la vente aux enchères, le montant est ajouté au bon endroit dans la plateforme iRaiser par le biais d'un don manuel.
Fondation Erasmus MC - lien vers Eroutes
Après avoir lancé une action pour le Tour contre le cancer, les participants à l'action ont reçu une invitation d'eRoutes. Sur la base de la distance que vous avez choisie et de votre position GPS, l'application vous suggère des itinéraires à suivre.