Documentation Charitable

Apprenez à tirer le meilleur parti de Charitable grâce à des instructions claires, étape par étape.

Référence des champs Charitable Zapier

Vous voulez savoir exactement quelles données arrivent dans votre Zap lorsqu'un déclencheur Charitable se déclenche ? Chaque déclencheur envoie une charge utile structurée de champs de dons, de donateurs, d'abonnements récurrents ou de campagnes, et cette référence répertorie chaque champ par type de déclencheur afin que vous puissiez les mapper en toute confiance à l'étape suivante.

Ce guide vous présentera les champs disponibles dans chaque déclencheur Zapier de Charitable.

Remarque : L'intégration Zapier de Charitable nécessite Charitable Pro 1.8.14+ et le module complémentaire Automation Connect 2.1.0+ (plan Pro ou supérieur).

Avant de commencer, assurez-vous d'avoir déjà Connecté Charitable à Zapier.

Champs de déclenchement de don

Ces champs sont envoyés par Nouveau don, Don complété, Don remboursé, et Donateur pour la première fois. La structure de charge utile exacte est la même pour les quatre, donc un Zap créé pour l'un est facile à adapter aux autres.

ChampDescriptionExemple
id_donL'ID interne de l'article WordPress pour le don.123
événementLe slug de l'événement de déclenchement.don_complete
titreTitre du donateur, lorsqu'il est collecté sur le formulaire.Mme
prénomPrénom du donateur.Wanda
nomNom de famille du donateur.Maximoff
emailAdresse e-mail du donateur.[email protected]
adresseLigne d'adresse postale.Unité 2b
villeVille.Novi Grad
étatÉtat ou région.État de Novi Grad
code_postalCode postal.12345
paysCode pays ou nom complet, selon la configuration du formulaire.Sokovie
téléphoneNuméro de téléphone du donateur, lorsqu'il est collecté.987654321
sous-totalLe montant de base du don, avant les frais.25
totalLe montant final du don facturé au donateur, y compris les frais qu'il a couverts.26.50
dateHorodatage du don au format ISO 8601.2026-05-08T14:20:27+00:00
statutStatut caritatif interne avec le préfixe charitable-. Voir la référence des statuts ci-dessous.charitable-completed
passerelle_donSlug de la passerelle de paiement utilisée.stripe, paypal, manual
id_transaction_passerelleLa référence de transaction de la passerelle, utile pour la réconciliation.ch_abc123def
mode_test1 si le don a été effectué en mode test de la passerelle, sinon 0.0
id_campagneLa campagne à laquelle le don a été effectué. Lorsqu'un don est réparti sur plusieurs campagnes, il s'agit d'une liste d'identifiants séparés par des virgules.8
consentement_contact1 si le donateur a choisi d'être contacté, sinon 0.1
couvrir_frais1 si le donateur a choisi de couvrir les frais de traitement.1
montant_fraisLa part du total qui couvre les frais de passerelle.1.50
consentement_suivi1 si le donateur a choisi d'activer les pixels de suivi et l'analyse.0
inscription_newsletter1 si le donateur s'est inscrit à la newsletter.1
giftaid1 si le donateur a réclamé la déduction fiscale (donateurs britanniques).0
don_anonyme1 si le donateur a choisi de s'afficher comme anonyme publiquement.1
commentaire_donateurMessage texte libre laissé par le donateur avec le don.À la mémoire de Maria

Valeurs du statut du don

Le champ status utilise les slugs internes de Charitable, tous préfixés par charitable-. Les règles de filtrage et la logique conditionnelle doivent correspondre à ces valeurs exactes.

  • charitable-completed – paiement reçu et confirmé par la passerelle. Utilisez ceci lorsque vous ne souhaitez agir que sur les dons réels.
  • charitable-pending – ligne de don créée mais paiement non encore confirmé. Courant pour les passerelles hors ligne et les virements bancaires.
  • charitable-failed – la passerelle a signalé un échec. Le donateur n'a pas été facturé.
  • charitable-cancelled – le donateur ou l'administrateur a abandonné la transaction.
  • charitable-refunded – le don a été remboursé après avoir été complété.

Champs de déclenchement d'abonnement récurrent

Ces champs sont envoyés par Nouvel abonnement récurrent, Don récurrent renouvelé, Abonnement récurrent annulé et Paiement récurrent échoué. La charge utile décrit le plan récurrent lui-même, pas une seule transaction.

ChampDescriptionExemple
id_don_recurrentL'identifiant du post du plan récurrent.122
événementLe slug de l'événement de déclenchement.subscription_renewed
id_premier_donL'ID du don de la première transaction ayant initié ce plan.123
sous-total_récurrentLe montant de base récurrent avant les frais.50
total_récurrentLe montant récurrent facturé, frais inclus.53
periode_recuL'unité de récurrence.jour, semaine, mois, année
intervalle_récurrentCombien d'unités recurring_period entre les transactions. 1 = chaque mois, 3 = tous les trois mois, etc.1
durée_récurrenteNombre total de transactions. 0 signifie aucune fin fixe.6
date_expiration_récurrenteDate de fin du plan, ISO 8601. Vide si ouvert.2026-09-08T00:00:00+00:00
date_renouvellement_récurrentDate de la prochaine transaction prévue, ISO 8601.2026-06-01T00:00:00+00:00
id_abonnement_passerelleLa référence d'abonnement de la passerelle. Utile pour le rapprochement direct avec Stripe ou PayPal.sub_xyz987
prénomPrénom du donateur.Wanda
nomNom de famille du donateur.Maximoff
emailAdresse e-mail du donateur.[email protected]
adresse, adresse_2, ville, état, code_postal, pays, téléphoneAdresse et téléphone du donateur, lorsqu'ils sont collectés sur le formulaire.
sous-totalLe montant de base de la transaction individuelle la plus récente.25
totalLe montant final de la transaction individuelle la plus récente.26.50
dateDate de création du plan, ISO 8601.2026-05-08T14:20:27+00:00
statutLe statut actuel du plan. Voir ci-dessous.charitable-actif
passerelle_donSlug de la passerelle.stripe
mode_test1 si créé en mode test.0
id_campagneLa campagne soutenue par le plan. Séparé par des virgules lorsqu'il est divisé.8
consentement_contact, couvrir_frais, montant_frais, consentement_suivi, opt_in_newsletter, giftaid_réclamé, don_anonyme, commentaire_donateurMêmes significations que la charge de don ci-dessus.
id_client_gocardlessRéférence client GoCardless, le cas échéant.goc123123
id_mandat_gocardlessRéférence mandat GoCardless, le cas échéant.goc987987

Valeurs d’état des abonnements récurrents

  • charitable-active – le plan est actif et se renouvelle comme prévu.
  • charitable-cancelled – le donateur ou l’administrateur a annulé le plan.
  • charitable-expired – le plan a atteint sa date de fin.
  • charitable-failed – une tentative de renouvellement a échoué et le plan est suspendu.

Champs de déclenchement de campagne

Ces champs sont envoyés par Objectif de campagne atteint et Campagne terminée. La charge utile décrit la campagne elle-même.

ChampDescriptionExemple
id_campagneL’ID de publication de la campagne.123
événementLe slug de l'événement de déclenchement.campaign_goal_reached
titreTitre de la campagne.Appel de fin d’année
descriptionCourte description de la campagne.Aidez-nous à atteindre notre objectif de jumelage
objectifObjectif de collecte de fonds dans la devise de votre boutique.2000
montant_donnéTotal collecté au moment où l’événement s’est déclenché.2045
nombre_donateursNombre total de donateurs uniques.38
date_finDate de fin de la campagne, ISO 8601. Vide si la campagne n’a pas de date de fin.2026-12-31T23:59:59+00:00
dateDate de publication de la campagne, ISO 8601.2026-05-01T10:00:00+00:00
statutStatut de publication WordPress.publish
lien_permanentURL publique de la campagne.https://example.org/campaigns/year-end/
id_createur_campagneID utilisateur WordPress du propriétaire de la campagne.4
nom_createur_campagneNom d’affichage du propriétaire de la campagne.Bruce Banner
email_createur_campagneAdresse e-mail du propriétaire de la campagne.[email protected]
destinataireOù vont les fonds – généralement fundraiser pour le pair-à-pair ou parent pour les campagnes enfants.fundraiser
parent_campagneSi la campagne est une campagne enfant pair-à-pair, l’ID de la campagne parente. 0 pour les campagnes autonomes.99
type_collecte_fondsPour les campagnes pair-à-pair, le type de collecte de fonds.individuel, équipe
id_équipe, nom_équipe, id_capitaine_équipeMétadonnées d'équipe pour les collectes de fonds d'équipe peer-to-peer.

Note : Pour Objectif de campagne atteint, l'événement inclut montant_collecté, objectif, et pourcentage_financé en tant que champs supplémentaires au-delà de la charge utile standard de la campagne. Ceux-ci sont calculés au moment où l'objectif a été franchi et ne seront pas mis à jour par la suite.

Entrées d'action et de recherche

Les deux étapes d'action et les deux étapes de recherche ont leurs propres champs d'entrée visibles dans l'éditeur Zap. Comme les champs d'entrée évoluent plus souvent que les charges utiles de déclenchement, cette section est un résumé rapide plutôt qu'un tableau exhaustif – ouvrez l'étape dans l'éditeur Zap pour la liste complète actuelle avec texte d'aide.

  • Créer un donateur – accepte les champs de profil du donateur (prénom, nom, e-mail, champs d'adresse, téléphone, consentement de contact, inscription à la newsletter). Renvoie l'enregistrement complet du donateur créé ou trouvé.
  • Mettre à jour un donateur – prend un champ de recherche (e-mail ou ID de donateur) plus les mêmes champs de profil de donateur. Seuls les champs que vous fournissez sont modifiés.
  • Trouver un donateur par e-mail – prend une entrée, l'adresse e-mail. Renvoie l'enregistrement complet du donateur, ou aucun résultat.
  • Trouver une campagne – prend soit un slug de campagne, soit un ID de campagne. Renvoie la charge utile de campagne décrite dans la section Champs de déclenchement de campagne ci-dessus.

C'est tout ! Vous savez maintenant ce que chaque déclencheur Zapier Charitable envoie, ce qui signifie que le mappage des champs dans toute étape Zap en aval devrait être simple. Ensuite, consultez Filtrer les Zaps Charitable par campagne pour limiter un Zap à des campagnes ou conditions spécifiques, et Connecter Charitable à Zapier pour le guide principal de démarrage.

FAQ

Quelle est la différence entre sous-total et total?

sous-total est le montant de base de la donation sélectionné par le donateur. total est ce qui a été effectivement facturé, ce qui peut être plus élevé si le donateur a choisi de couvrir les frais de traitement de la passerelle. La différence apparaît dans le champ montant_frais.

Pourquoi statut commence-t-il toujours par charitable-?

Charitable enregistre ses propres statuts de publication WordPress pour les séparer des statuts WordPress intégrés tels que publier et brouillon. Le préfixe charitable- est interne mais requis lors du filtrage – les règles de (Texte) Correspond exactement nécessitent la valeur complète préfixée, pas seulement terminé ou remboursé.

Y a-t-il des champs qui ne figurent pas dans cette liste ?

Oui. Charitable permet aux développeurs d'ajouter des champs personnalisés de dons, de donateurs et de campagnes, et tout champ marqué show_in_webhook dans l'API des champs de dons est automatiquement inclus dans la charge utile aux côtés des valeurs par défaut. Vérifiez les données d'exemple du déclencheur dans l'éditeur Zap pour voir les champs personnalisés ajoutés par votre installation spécifique ou par d'autres extensions Charitable.

Puis-je envoyer uniquement un sous-ensemble de champs à mon action en aval ?

Oui. L'étape d'action de l'éditeur Zap vous permet de mapper n'importe quel sous-ensemble des champs du déclencheur dans les entrées de l'action. Les champs que vous ne mappez pas sont simplement ignorés. C'est le moyen le plus propre de garder les enregistrements de contacts CRM désencombrés.

Comment savoir à quelle campagne appartient un collecteur de fonds pair-à-pair ?

Regardez post_parent sur une charge utile de déclencheur de campagne. Pour les campagnes enfants,  post_parent contient l'ID de la campagne parente. Pour les campagnes autonomes, c'est 0.

Vous avez encore des questions ? Nous sommes là pour vous aider !

Dernière modification :

Quoi de neuf dans Charitable

Voir les dernières mises à jour
🔔 Abonnez-vous pour recevoir nos dernières mises à jour
📧 Abonnez-vous aux e-mails

Abonnement par e-mail

Rejoignez notre newsletter

Nous ne vous enverrons pas de spam. Nous envoyons un e-mail uniquement lorsque nous pensons qu'il vous sera réellement utile. Désabonnez-vous à tout moment !

ambassadeurs Nouveau

🔑 Présentation des collectes sans mot de passe : inscrivez-vous avec juste une adresse e-mail !

Les donateurs arrivent en voulant aider, et ensuite le formulaire leur demande d'inventer un mot de passe pour un site web qu'ils ne visiteront peut-être que deux fois. Beaucoup d'entre eux s'arrêtent là. Les comptes de collecte sans mot de passe, nouveauté de Charitable Ambassadors 3.5.0, permettent à un donateur de lancer une collecte de pair à pair avec rien d'autre qu'une adresse e-mail. Pourquoi c'est important :

  • 🔑 Aucune étape de mot de passe pour les perdre : Activez-la dans Charitable » Ambassadeurs » Modèles » Formulaire de soumission et le formulaire de création de collecte ne demande qu'un nom, une adresse e-mail et un titre de page.
  • 👤 Toujours un vrai compte WordPress : Un clic dans un e-mail confirme l'adresse, les connecte et crée le compte, afin qu'ils puissent revenir plus tard pour modifier leur histoire, changer leur photo et voir qui a fait un don.
  • 🎚️ Votre choix pour chaque campagne : Chaque campagne de pair à pair peut suivre la valeur par défaut du site ou la remplacer, ce qui est important lorsqu'une campagne paie les collecteurs via Stripe Connect et que ces personnes ont besoin d'un mot de passe.
  • 📋 Voir qui n'a pas encore cliqué : L'onglet Charitable » Ambassadeurs » Répertoire » En attente de connexion liste tous ceux qui attendent encore, avec la campagne qu'ils ont rejointe et un bouton Réenvoyer, afin qu'une faute de frappe ou un dossier de spam puisse être repéré et corrigé.
  • 🛡️ Liens que les scanners ne peuvent pas épuiser : L'ouverture du lien n'affiche qu'une page, et votre collecteur est connecté lorsqu'il appuie sur le bouton, de sorte que les scanners d'e-mails d'entreprise n'épuisent jamais le lien. Chacun fonctionne une fois, expire de lui-même et n'est stocké que sous forme de hachage.

Consultez notre annonce ici.

ambassadeurs Nouveau

🏃 Présentation de l'activité : Montrez les progrès au-delà de l'argent !

La plupart des collectes de fonds peer-to-peer ne se résument pas à l'argent. Un marathon de lecture porte sur les minutes lues, un marathon de marche sur les kilomètres parcourus et une collecte de nourriture sur les repas préparés. L'activité pour les Ambassadeurs Caritatifs permet à vos collecteurs de fonds de montrer cet effort juste à côté des dollars qu'ils collectent. Pourquoi c'est important :

  • 🎯 Progrès sur ce que vous comptez réellement : Une barre de progression montre chaque élément que vous comptez par rapport à sa propre cible, juste à côté de l'argent collecté.
  • 🏅 Jalons pour les choses oui ou non : Un badge de jalon marque les efforts qui sont simplement faits ou non faits, sans chiffre à atteindre.
  • ✍️ Les collecteurs de fonds enregistrent leurs propres chiffres : Vos supporters saisissent leurs totaux depuis leurs propres pages, de sorte que l'effort cesse de vivre dans une feuille de calcul, un commentaire ou nulle part ailleurs.
  • 🤖 Certains chiffres se comptent eux-mêmes : Une étiquette AUTOMATIQUE apparaît partout où le site a calculé le chiffre à partir des dons complétés, afin que vous puissiez voir en un coup d'œil ce que personne n'a tapé.
  • 🧩 Configurez une fois, utilisez partout : Vous décidez ce qui est compté une fois, puis vous choisissez quelles campagnes le comptent. Disponible dès maintenant dans Charitable Ambassadors 3.4.7, sans nouveau plugin et sans développeur.

Consultez notre annonce ici.

ambassadeurs Nouveau

🖨️ Présentation des prospectus et affiches : collectez des fonds loin de l'écran !

Une grande partie de la collecte de fonds de pair à pair se fait loin d'un écran : à la ligne d'arrivée d'un 5 km, sur un panneau d'affichage d'école, dans une cuisine de bureau. Charitable Ambassadors 3.4.7 ajoute 2 imprimables, un prospectus de collecte de fonds portant la propre histoire et le code QR de chaque collecteur de fonds, et une affiche de recrutement qui inscrit de nouveaux collecteurs de fonds. Les deux s'ouvrent comme une page Web normale et s'impriment directement depuis le navigateur. Pourquoi c'est important :

  • 🏁 Un prospectus pour chaque collecteur de fonds : Chacun porte la propre photo, histoire et objectif de ce collecteur de fonds, avec un code QR qui ouvre sa page plutôt que votre campagne principale.
  • 📌 Une affiche qui recrute : Elle affiche « Recrutement en cours » au-dessus du nom de votre campagne avec un grand code QR qui ouvre votre formulaire d'inscription, afin que quelqu'un puisse commencer à collecter des fonds sans attendre un lien de votre part.
  • 🪄 Aucun outil de conception nécessaire : Les deux imprimables s'affichent comme une page Web normale et s'impriment depuis le navigateur, sans plugin PDF et sans designer.
  • 📄 2 mises en page de prospectus : « À distribuer » contient l'histoire complète pour donner à vos amis et à votre famille, et « À afficher » contient un court message accrocheur avec 5 languettes détachables pour un panneau d'affichage.
  • 🛡️ Désactivé jusqu'à ce que vous l'activiez : Les prospectus restent désactivés après la mise à jour jusqu'à ce que vous les activiez sous Charitable » Ambassadeurs » Autre » Prospectus, et seul le propriétaire ou un administrateur peut en ouvrir un.

Consultez notre annonce ici.

Amélioration Paiements

💸 Introduction des tarifs échelonnés pour l'allègement des frais : Adaptez la demande au don !

L'allègement des frais pose une courte question à vos donateurs lors du paiement : souhaitez-vous couvrir les frais de traitement de ce don ? Jusqu'à présent, cette question utilisait un taux unique pour chaque don sur une passerelle, de sorte qu'un don de 10 $ et un don de 500 $ se voyaient demander le même pourcentage. L'allègement des frais 1.3.0 vous permet de définir autant de tranches de dons que vous le souhaitez, chacune portant son propre taux. Pourquoi c'est important :

  • 🪙 Plus doux pour les petits dons : Un coût de transaction fixe représente une part beaucoup plus importante d'un don de 10 $ que d'un don de 500 $, les tranches vous permettent donc de demander moins en bas.
  • 🎚️ Autant de tranches que nécessaire : Chaque tranche porte son propre pourcentage et son propre montant fixe, et la tranche supérieure s'exécute sans limite supérieure.
  • 🛑 Un plafond facultatif : Un champ de frais maximum empêche qu'un donateur ne se voie demander plus qu'un nombre que vous choisissez, quel que soit le montant du don.
  • 🔌 Défini par passerelle de paiement : Stripe peut fonctionner avec quatre tranches tandis que Windcave et Payfast restent sur un taux unique, car les tranches appartiennent à une passerelle et non à l'ensemble de votre site.
  • 🛡️ Rien ne change tant que vous ne le décidez pas : Vos taux actuels restent exactement les mêmes jusqu'à ce que vous activiez « Utiliser les tarifs échelonnés » sous Charitable » Paramètres » Avancé » Allègement des frais.

Consultez notre annonce ici.

Dons Amélioration

📊 Votre tableau de bord Pro peut désormais comparer, exporter et évaluer !

La plupart des tableaux de bord de collecte de fonds vous indiquent seulement combien vous avez collecté. Charitable Pro 1.8.19 reconstruit le tableau de bord et la Vue d'ensemble des rapports autour des questions les plus difficiles : si quelque chose ne fonctionne pas, si cette période a été meilleure que la précédente, et quel changement unique ferait la plus grande différence aujourd'hui. Pourquoi c'est important :

  • 📈 Chaque chiffre a une tendance : Choisissez une période et les vignettes ainsi que le graphique bougent ensemble, chaque total étant affiché par rapport à la période précédente.
  • 🗓️ Des graphiques lisibles : Les courtes périodes regroupent les dons jour par jour, tandis que les longues périodes regroupent par semaine ou par mois, de sorte qu'une année complète se lit comme une courbe au lieu d'une ligne plate.
  • 🔀 Comparez n'importe quelles 2 périodes : Pas seulement consécutives, vous pouvez donc demander comment ce mois de décembre s'est comparé au mois de décembre dernier. C'est important car la collecte de fonds est saisonnière.
  • 📤 Exportez le résumé complet : Envoyez la vue d'ensemble complète en CSV ou PDF, prête pour un dossier de conseil d'administration ou un rapport de bailleur de fonds.
  • 🎯 Évaluez votre configuration gratuitement : Faites évaluer votre configuration de collecte de fonds, de sorte que le seul changement à faire ensuite soit celui que vous pouvez voir.

Consultez notre annonce ici.