Charitable Automation Connect vous permet de connecter Charitable à des milliers d'autres applications en utilisant des plateformes d'automatisation tierces comme Zapier, Make.com ou Zoho Flow.

Comment installer et activer le plugin Automation Connect

Automation Connect est un plugin et peut être installé de la même manière que toute autre extension Charitable. Voici un guide rapide :

1. Téléchargez votre extension depuis votre page de compte ou l'e-mail de votre reçu d'achat.
2. Allez dans Plugins > Ajouter un nouveau dans votre tableau de bord WordPress.
3. Cliquez sur le bouton Téléverser un plugin en haut de la page.
4. Sélectionnez le fichier zip que vous avez téléchargé à l'étape 1 et cliquez sur Installer maintenant.
5. Activez votre plugin !

Comprendre les abonnements aux webhooks

Automation Connect est construit autour des abonnements aux webhooks. Alors, qu'est-ce qu'un abonnement webhook ?

En bref, un abonnement webhook est une instruction à Charitable indiquant que vous souhaitez que des informations (les données) soient envoyées à une URL spécifique (l'URL de livraison) chaque fois qu'un événement particulier se produit sur votre site web (l'événement déclencheur).

Par exemple, supposons que vous utilisiez un CRM comme Salesforce. Chaque fois que vous recevez un nouveau don, vous souhaitez que les informations relatives à ce don soient envoyées à Salesforce.

Dans ce scénario, les données sont votre don et incluront des informations telles que le montant du don, le nom et l'adresse e-mail du donateur, le statut du don, et plus encore. (Passez à la suite si vous souhaitez voir toutes les informations envoyées pour les dons, les dons récurrents et les campagnes par Charitable.)

L'événement déclencheur est un nouveau don, bien que vous souhaitiez probablement également créer des flux de travail automatisés pour gérer les cas où un don est mis à jour, déplacé vers la corbeille ou restauré depuis la corbeille.

Enfin, l'URL de livraison sera un lien unique vers une application d'automatisation comme Zapier, Make.com, Zoho Flow, ou toute autre application qui vous permet de configurer une URL de webhook. Vous pouvez ensuite utiliser votre application d'automatisation pour prendre les données reçues de Charitable et les envoyer à Salesforce.

Comment créer, modifier ou supprimer un abonnement webhook

Vous pouvez créer, modifier et supprimer des abonnements aux webhooks en allant dans Charitable > Paramètres > Avancé.

Si vous êtes sur la page Plugins, vous pouvez accéder directement à cette page en cliquant sur le lien rapide « Abonnements aux webhooks » pour le plugin Charitable Automation Connect.

Créer un abonnement webhook

1. Cliquez sur Ajouter un abonnement webhook pour créer un nouvel abonnement webhook.
2. Facultativement, vous pouvez ajouter un nom descriptif à votre abonnement. Par exemple, vous pourriez l'appeler « Envoyer les dons » pour préciser qu'il s'agit d'envoyer des événements de don à Make :
3. Collez l'URL de livraison. Il s'agit d'une URL unique créée par votre application d'automatisation.
4. Choisissez l'événement qui déclenchera votre webhook.
5. Facultativement, définissez un Secret à utiliser pour le webhook. Laissez ce champ vide pour que Charitable en génère un automatiquement.
6. Cliquez sur Enregistrer pour créer l'abonnement.

Modifier ou supprimer un abonnement webhook

Une fois que vous avez configuré un abonnement webhook, vous pouvez le modifier en cliquant sur le bouton Modifier ; cela ouvrira le même formulaire d'abonnement webhook que celui utilisé lors de la création de l'abonnement.

Pour supprimer l'abonnement, cliquez sur Supprimer, puis confirmez la suppression en cliquant sur Supprimer l'abonnement webhook.

Comment connecter Zapier

Zapier est une application qui vous permet de déplacer automatiquement des informations entre différentes applications. Elle se connecte à plus de 3 000 applications.

L'intégration Zapier de Charitable est actuellement en mode sur invitation uniquement. Cliquez sur le lien ci-dessous pour commencer à l'utiliser :

https://zapier.com/developer/public-invite/145749/11b59eacc08b96703df9aa845a043b5d

Ensuite, cliquez sur Accepter l'invitation et créer un Zap pour commencer à utiliser l'intégration, comme montré ci-dessous :

Dans le tableau de bord Zapier, cliquez sur le bouton Créer un Zap dans le menu de gauche pour créer un nouveau Zap. Si vous êtes sur un écran plus petit, le bouton Créer un Zap est remplacé par un grand bouton + :

Configuration d'un Zap pour votre événement Charitable

Un Zap nécessite deux choses :

• Un Déclencheur, qui est l'événement qui démarre le flux de travail automatisé
• Une Action, qui est l'action qui aura lieu à la suite de l'événement

Dans notre cas, le Déclencheur sera un événement Charitable, comme un nouveau don ou une mise à jour d'une campagne. Charitable ne peut pas être utilisé pour l'étape d'Action.

1. Choisissez un événement Charitable comme Déclencheur pour votre Zap

Donnez un nom à votre Zap, puis recherchez Charitable dans le champ de recherche d'applications :

Zapier vous demandera alors de choisir l'Événement Déclencheur :

Une fois que vous avez choisi un événement, cliquez sur Continuer pour passer à l'étape suivante.

2. Configurez la connexion Charitable

Si c'est la première fois que vous créez un Zap avec Charitable, vous devrez configurer la connexion Charitable.

Cliquez sur Se connecter à Charitable pour commencer :

Une nouvelle fenêtre s'ouvrira avec un formulaire à remplir :

Il y a trois champs à remplir :

• L'URL de votre site web. C'est l'URL du site web où Charitable est installé.
• Votre nom d'utilisateur pour votre site web.
• Un mot de passe d'application pour votre compte sur le site web.

Bien que vous puissiez également utiliser votre mot de passe habituel, nous vous recommandons fortement de créer un mot de passe d'application, car cela maintient votre mot de passe normal plus sécurisé. Si vous n'êtes pas sûr de la manière de créer un mot de passe d'application, passez aux instructions étape par étape pour créer un mot de passe d'application.

Une fois que vous avez connecté votre compte de site web, cliquez sur Continuer pour passer à l'étape suivante.

3. Configurez un Événement Déclencheur spécifique

Auparavant, vous avez choisi le type de Déclencheur à utiliser pour votre intégration, en fonction du type de ressource : une Campagne, un Don ou un Don Récurrent. Vous devez maintenant choisir un événement spécifique lié à cette ressource.

Après en avoir choisi un, cliquez sur Continuer.

4. Testez le déclencheur

Enfin, vous pouvez tester le Déclencheur en cliquant sur Tester le Déclencheur. Cela garantira que tout est correctement configuré et vous fournira également des données d'exemple pour vous montrer ce qui sera inclus dans les informations envoyées à Zapier par Charitable.

En supposant que tout a été correctement configuré, cliquez sur Continuer pour passer à l'étape de configuration de l'Action pour votre Zap.

5. Configurez l'Action pour votre Zap

La dernière étape consiste à créer une Action pour votre Zap.

Il existe des milliers de façons différentes d'utiliser Zapier et Charitable ensemble pour automatiser les flux de travail de votre organisation à but non lucratif. Voici quelques exemples :

• Ajouter des dons à un CRM comme Salesforce.
• Ajouter des dons à une feuille Google.
• Ajouter des créateurs de campagnes ou des donateurs à une liste spéciale dans votre fournisseur de marketing par e-mail (s'il ne s'agit pas d'un que nous prenons déjà en charge avec notre plugin Newsletter Connect).
• Configurer un événement dans Google Agenda pour enregistrer la fin d'une campagne.
• Envoyer un e-mail après la création d'un don ou l'ajout d'une campagne.

Lorsque vous configurez l'Action, vous pourrez sélectionner les données de Charitable que vous souhaitez utiliser.

Par exemple, dans la capture d'écran ci-dessous, de nouveaux dons sont ajoutés à une feuille Google. Les champs « ID du don » et « Prénom du donateur » correspondent à des colonnes dans la feuille Google que j'ai créée, et je peux choisir dans les données de Charitable ce qui doit aller dans chaque colonne :

Si vous débutez avec Zapier, vous pouvez suivre ce guide détaillé pour configurer les actions Zap.

6. Activez votre Zap

Une fois que vous avez terminé la configuration de votre action, cliquez sur Tester et continuer pour l'essayer et vous assurer que tout fonctionne comme vous le souhaitez.

Si c'est le cas, la dernière étape consiste à activer le Zap en cliquant sur Activer le Zap.

Prochaines étapes avec Zapier

Ce guide a couvert les bases de la création d'un Zap en configurant un déclencheur et une action. Vous pouvez faire beaucoup plus avec Zapier. Voici quelques exemples de la façon dont vous pouvez personnaliser vos Zaps, avec des liens vers la documentation Zapier :

• Ajouter des conditions à votre Zap
• Ajouter une logique de branchement à votre Zap
• Ajouter des délais aux Zaps
• Formater les données entrantes de différentes manières

Comment intégrer avec d'autres applications d'automatisation

Automation Connect est conçu pour fonctionner avec toute application d'automatisation qui vous permet de configurer un abonnement webhook. Voici quelques exemples d'applications que vous pouvez utiliser à la place de Zapier :

• Créer
• Zoho Flow

Créer

Vous pouvez intégrer Charitable avec Make en créant un Scénario et en utilisant le module « Webhooks » avec l'option de déclenchement « Webhook personnalisé » :

Après avoir configuré cela, copiez l'adresse du webhook et utilisez-la comme « URL de livraison » lors de la création d'un abonnement Webhook dans vos paramètres Charitable.

Zoho Flow

Dans Zoho Flow, créez un nouveau Flux. Après avoir défini un titre et une description, choisissez « Webhook » comme option de déclenchement :

Sur la page suivante, laissez le format de la charge utile défini sur JSON. Copiez l'URL du webhook en bas et utilisez-la comme « URL de livraison » lors de la configuration d'un nouvel abonnement Webhook dans Charitable :

Comment créer un mot de passe d'application pour mon intégration ?

Vous pouvez créer un mot de passe d'application dans votre tableau de bord WordPress.

1. Accédez à votre page de profil en cliquant sur Utilisateurs > Profil dans le menu de gauche. Vous pouvez également y accéder en cliquant sur votre photo de profil dans le coin supérieur droit de la page, puis en cliquant sur Modifier le profil.
2. Faites défiler jusqu'à la section « Mots de passe d'application ». Donnez un nom unique à votre mot de passe d'application pour indiquer son utilisation, puis cliquez sur Ajouter un nouveau mot de passe d'application.

3. Copiez et collez le mot de passe de l'application et enregistrez-le dans un endroit sûr. Vous ne pourrez plus accéder au mot de passe :

Quelles informations Charitable envoie-t-il aux webhooks ?

Charitable envoie des informations sur trois types de ressources :

1. Dons
2. Dons récurrents
3. Campagnes

Les informations incluses dépendront des autres extensions Charitable que vous avez installées.

Dons

Clé de champ	Description	Disponibilité
id_don	ID du don	Noyau
prénom	Prénom du donateur	Noyau
nom	Nom de famille du donateur	Noyau
email	Adresse e-mail du donateur	Noyau
adresse	Adresse du donateur	Noyau
adresse_2	Adresse du donateur, ligne 2	Noyau
ville	Ville du donateur	Noyau
état	État/Province du donateur	Noyau
code_postal	Code postal du donateur	Noyau
pays	Pays du donateur	Noyau
téléphone	Numéro de téléphone du donateur	Noyau
sous-total	Montant du don, hors frais	Noyau
total	Montant total du don, frais inclus	Noyau
date	Date du don	Noyau
statut	Statut du don	Noyau
passerelle_don	Passerelle de paiement utilisée	Noyau
id_transaction_passerelle	ID ou référence de la passerelle de paiement pour le don	Noyau
mode_test	Le don a-t-il été effectué en mode test	Noyau
consentement_contact	Statut du consentement de contact du donateur	Noyau
couvrir_frais	Indique si le donateur a choisi de couvrir les frais	Réduction des frais
montant_frais	Le frais couvert par le donateur.	Réduction des frais
consentement_suivi	Indique si le donateur a donné son consentement au suivi (s'applique uniquement si Campaign Monitor est utilisé)	Connexion Newsletter
inscription_newsletter	Indique si le donateur s'est inscrit pour recevoir la newsletter	Connexion Newsletter
id_client_gocardless	L'ID client du donateur chez GoCardless	GoCardless
id_mandat_gocardless	L'ID de mandat GoCardless utilisé pour le don	GoCardless
giftaid_reclame	Indique si le donateur a réclamé le Gift Aid	Gift Aid
titre	Titre du donateur	Gift Aid
adresse_3	3ème ligne de l'adresse du donateur	Gift Aid
don_anonyme	Indique si le donateur a choisi de rester anonyme	Dons anonymes
commentaire_donateur	Le commentaire du donateur	Commentaires des donateurs

Dons récurrents

Clé de champ	Description	Disponibilité
id_don_recurrent	ID du don récurrent	Dons récurrents
id_premier_don	ID du don initial	Dons récurrents
sous-total_récurrent	Montant donné régulièrement (hors frais)	Dons récurrents
total_récurrent	Montant donné régulièrement (frais inclus)	Dons récurrents
periode_recu	Période de don récurrent (mois, semaine, année, etc.)	Dons récurrents
intervalle_récurrent	Nombre de périodes entre les dons récurrents	Dons récurrents
durée_récurrente	Nombre total de renouvellements du don récurrent	Dons récurrents
date_expiration_récurrente	Date d'expiration du don récurrent	Dons récurrents
date_renouvellement_récurrent	Date du prochain renouvellement du don récurrent	Dons récurrents
id_abonnement_passerelle	Identifiant/référence de l'abonnement à la passerelle de paiement	Dons récurrents
id_don	ID du don	Noyau
prénom	Prénom du donateur	Noyau
nom	Nom de famille du donateur	Noyau
email	Adresse e-mail du donateur	Noyau
adresse	Adresse du donateur	Noyau
adresse_2	Adresse du donateur, ligne 2	Noyau
ville	Ville du donateur	Noyau
état	État/Province du donateur	Noyau
code_postal	Code postal du donateur	Noyau
pays	Pays du donateur	Noyau
téléphone	Numéro de téléphone du donateur	Noyau
sous-total	Montant du don, hors frais	Noyau
total	Montant total du don, frais inclus	Noyau
date	Date du don	Noyau
statut	Statut du don	Noyau
passerelle_don	Passerelle de paiement utilisée	Noyau
id_transaction_passerelle	ID ou référence de la passerelle de paiement pour le don	Noyau
mode_test	Le don a-t-il été effectué en mode test	Noyau
consentement_contact	Statut du consentement de contact du donateur	Noyau
couvrir_frais	Indique si le donateur a choisi de couvrir les frais	Réduction des frais
montant_frais	Le frais couvert par le donateur.	Réduction des frais
don_anonyme	Indique si le donateur a choisi de rester anonyme	Dons anonymes
commentaire_donateur	Le commentaire du donateur	Commentaires des donateurs

Campagnes

Clé de champ	Description	Disponibilité
id_campagne	ID de la campagne	Noyau
description	Description courte	Noyau
objectif	Objectif de collecte de fonds	Noyau
date_fin	Date de fin de la campagne	Noyau
titre	Titre de la campagne	Noyau
date	Date de création de la campagne	Noyau
id_createur_campagne	ID utilisateur du créateur de la campagne	Noyau
nom_createur_campagne	Nom complet du créateur de la campagne	Noyau
email_createur_campagne	Adresse e-mail du créateur de campagne	Noyau
montant_donné	Montant donné à la campagne	Noyau
nombre_donateurs	Nombre de donateurs uniques à la campagne	Noyau
statut	Statut de la campagne	Noyau
lien_permanent	URL de la campagne	Noyau
destinataire	Type de campagne. L'une des options suivantes : – ambassadeur (campagne pour votre organisation) – collecte de fonds (collecte de fonds pour une autre campagne) – personnel (campagne pour une cause personnelle)	Ambassadeurs
parent_campagne	ID du parent de la campagne, ou 0 si ce n'est pas une collecte de fonds	Ambassadeurs
type_collecte_fonds	Type de collecte de fonds, ou false si ce n'est pas une collecte de fonds. L'une des options suivantes : – Membre de l'équipe – Équipe – Individuel	Ambassadeurs
action_requise_createur	Une action requise du créateur de la campagne avant que sa campagne ne puisse être activée.	Ambassadeurs
email_createur_campagne_soumis	L'adresse e-mail utilisée par la personne qui a soumis la campagne. Il s'agit de la même adresse que celle du champ email_createur_campagne, sauf s'il s'agit d'une campagne de membre d'équipe ajoutée par le capitaine d'équipe.	Ambassadeurs
supporte_campagnes_enfants	Indique si la campagne prend en charge les collectes de fonds.	Ambassadeurs
id_equipe	L'ID de l'équipe à laquelle appartient cette collecte de fonds, ou 0 si elle ne fait pas partie d'une équipe.	Ambassadeurs
nom_equipe	Le nom de l'équipe à laquelle appartient cette collecte de fonds.	Ambassadeurs
id_capitaine_equipe	L'ID utilisateur du capitaine de l'équipe à laquelle appartient cette collecte de fonds, ou null si elle ne fait pas partie d'une équipe.	Ambassadeurs