Intégration à DonorPerfect

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.

Créer l'interface API de DonorPerfect

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.

Ajouter une donation à un donateur dans DP

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 Webhooks by Zapier comme App

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.

Détecter si le donateur est déjà dans la base de données

Pour formater le fait d'avoir trouver ou non un donateur dans la DonorPerfect avec cet email, il faut rajouter une étape Formatter.

App d'action à ajouter

Vous choisissez alors Utilities dans les 4 choix proposés, et vous le configurez de la façon suivante :

Configuration de Utilities

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.

Ajouter/mettre à jour le donateur

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 :

Champs params du GET

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 :

Configuration de l'étape d'addition

Et pour finir, une dernière étape Webhooks, un GET encore avec la configuration suivante :

Configuration du dernier GET