Intégration à DonorPerfect
Last updated
Was this helpful?
Last updated
Was this helpful?
Nous vous proposons ci-dessous différentes méthodes d'intégration à un système distinct de gestion des donateurs. Nous savons que les besoins de chaque organisation sont uniques, alors n'hésitez pas à nous contacter à [email protected] pour discuter de l'option d'intégration qui vous convient le mieux !
Si vous utilisez DonorPerfect pour la gestion des donateurs, Zeffy offre une intégration directe à la plateforme. Ainsi, les données de vos donateurs reçues dans Zeffy sont automatiquement intégrées dans DonorPerfect.
Pour configurer l'intégration, contactez-nous à [email protected] avec votre clé API DonorPerfect et vos informations de compte Zeffy. Une fois que notre équipe aura confirmé que l'intégration est complète, vous commencerez à recevoir vos dons directement dans votre système de gestion des donateurs.
Nous recommandons l'intégration directe pour les besoins simples de collecte de fonds, comme les dons ponctuels à partir d'un seul formulaire Zeffy. Pour des campagnes plus complexes comme le pair-à-pair, veuillez nous contacter à [email protected] pour plus d'options.
Bien qu'il ne s'agisse pas d'une intégration, c'est parfois la méthode la plus efficace pour transférer vos données de Zeffy vers un système de gestion des donateurs distinct. Pour les campagnes à court terme, nous recommandons d'exporter les rapports sur les donateurs de Zeffy et de les importer directement dans DonorPerfect.
Zeffy fournit des rapports complets avec toutes vos données sur les donateurs ou les acheteurs, qui peuvent être exportés vers excel. Vous pouvez ensuite mapper vos rapports en fonction de vos utilisations spécifiques dans DonorPerfect et les importer directement.
Veuillez noter que la création de l'API DonorPerfect pour cette méthode d'intégration est effectuée par une source externe. Nous ne contrôlons pas la disponibilité de cette ressource.
Simplyk a une application sur la plateforme de connection d'API Zapier (lien d'invitation). Cela vous permet de récupérer facilement les données de Simplyk lorsqu'un nouveau don est reçu ou un nouveau billet est vendu, pour envoyer l'information dans Donor Perfect.
Une fois que vous avez connecté Simplyk à Zapier, vous devez configurer la communication avec l'API de Donor Perfect. Pour se faire, utilisez le guide ci-dessous. Pour de plus amples informations, contactez nous à [email protected].
La configuration est rapide, sécuritaire, et personnalisable.
Pour créer une interface d'API avec DonorPrefect, vous devez vous créer un compte au lien suivant: http://api.warrenbti.com.
Une fois le compte créé avec ...., vous obtiendrez une API key à garder précieusement.
Une fois la liaison avec Simplyk réalisée dans Zapier, avec New donation comme action de trigger dans votre zap, ajouter une étape Action/search.
Cette étape va permettre de rechercher, dans votre base de données Donor Perfect existante, le donateur, s'il existe.
Sélectionner le type d'action GET. L'idée va être ici de voir si le donateur existe déjà dans la base de données.
Dans le champ URL, entrer https://www.simplyk.io/api/v1/dpo.
Ensuite, entrer tous les champs nécessaires dans Query String Params:
apikey: renseigner l'api key que vous avez obtenu sur l'interface Donor Perfect api.warrenbti.com
action: Select donor_id, first_name, last_name,email from dp where email='step1-email'
en remplaçant step1-email par l'adresse email du donateur, qui est obtenu en cliquant sur le + à droite.
Toutes les prochaines inscriptions en gras commençant par step correspondent aux variables des étapes précédentes (exemple: step1-email). Pour les introduire, il faut cliquer sur le + à droite du champ.
Une fois cette étape fini, nous avons en notre possession une liste avec l'id du donateur, s'il a été trouvé dans la base de donnée, sinon, nous avons une liste vide.
Il va maintenant falloir formater cette liste pour avoir un seul id du donateur, ou un 0 si le donateur n'existe pas encore. Pour cela, il faut ajouter une étape dans le zapier et choisir non pas Action/Search mais Formatter.
Choisissez ensuite Utilities.
Choisissez Pick from list dans Transform, Choose first dans Opération, le champ step2-donor_id en cliquant sur + pour le champ Input et dans Default, inscrivez 0.
params: @gift_id=0, @donor_id=step2-donor_id, @record_type='G', @gift_date='step1-date', @amount=step1-amount, @gl_code=NULL, @solicit_code=NULL, @sub_solicit_code=NULL, @campaign=NULL, @gift_type=NULL, @split_gift=NULL, @pledge_payment=NULL, @reference=NULL, @memory_honor=NULL, @gfname=NULL, @glname=NULL, @fmv=0, @batch_no=0, @gift_narrative=step1-donation_title, @ty_letter_no=NULL, @glink=NULL, @plink=NULL, @nocalc=NULL, @old_amount=NULL, @receipt=NULL, @user_id='Simplyk', @gift_aid_date=NULL, @gift_aid_amt=NULL, @gift_aid_eligible_g=NULL, @currency='currency’
Avec: currency CAD ou USD.
Le résultat est qu'un don par Simplyk mettra à jour un donateur dans DonorPerfect.
Zapier offre un prix préférentiel pour les organismes de charités. Il faudra cependant compter une vingtaine de dollars par mois.
Pour formater le fait d'avoir trouver ou non un donateur dans la DonorPerfect avec cet email, il faut rajouter une étape Formatter.
Vous choisissez alors Utilities dans les 4 choix proposés, et vous le configurez de la façon suivante :
Notez bien que l'input est nécessaire et doit être le résultat de l'étape 2, et que la valeur de défaut doit être 0.
Pour ajouter (ou mettre à jour, suivant le résultat de l'étape précédente) le donateur, il faut ajouter une étape, qui est encore un GET avec Webhooks.
Les paramètres :
action: dp_savedonor
apikey: votre apikey comme précédemment
params:
Le reste des paramètres est intact comme précédemment.
Ensuite, une avant-dernière étape très simple qui consiste à additionner les id des donateurs avec la configuration suivante :
Et pour finir, une dernière étape Webhooks, un GET encore avec la configuration suivante :
