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
- Champs de déclenchement d'abonnement récurrent
- Champs de déclenchement de campagne
- Entrées d'action et de recherche
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.
| Champ | Description | Exemple |
|---|---|---|
id_don | L'ID interne de l'article WordPress pour le don. | 123 |
événement | Le slug de l'événement de déclenchement. | don_complete |
titre | Titre du donateur, lorsqu'il est collecté sur le formulaire. | Mme |
prénom | Prénom du donateur. | Wanda |
nom | Nom de famille du donateur. | Maximoff |
email | Adresse e-mail du donateur. | [email protected] |
adresse | Ligne d'adresse postale. | Unité 2b |
ville | Ville. | Novi Grad |
état | État ou région. | État de Novi Grad |
code_postal | Code postal. | 12345 |
pays | Code pays ou nom complet, selon la configuration du formulaire. | Sokovie |
téléphone | Numéro de téléphone du donateur, lorsqu'il est collecté. | 987654321 |
sous-total | Le montant de base du don, avant les frais. | 25 |
total | Le montant final du don facturé au donateur, y compris les frais qu'il a couverts. | 26.50 |
date | Horodatage du don au format ISO 8601. | 2026-05-08T14:20:27+00:00 |
statut | Statut caritatif interne avec le préfixe charitable-. Voir la référence des statuts ci-dessous. | charitable-completed |
passerelle_don | Slug de la passerelle de paiement utilisée. | stripe, paypal, manual |
id_transaction_passerelle | La référence de transaction de la passerelle, utile pour la réconciliation. | ch_abc123def |
mode_test | 1 si le don a été effectué en mode test de la passerelle, sinon 0. | 0 |
id_campagne | La 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_contact | 1 si le donateur a choisi d'être contacté, sinon 0. | 1 |
couvrir_frais | 1 si le donateur a choisi de couvrir les frais de traitement. | 1 |
montant_frais | La part du total qui couvre les frais de passerelle. | 1.50 |
consentement_suivi | 1 si le donateur a choisi d'activer les pixels de suivi et l'analyse. | 0 |
inscription_newsletter | 1 si le donateur s'est inscrit à la newsletter. | 1 |
giftaid | 1 si le donateur a réclamé la déduction fiscale (donateurs britanniques). | 0 |
don_anonyme | 1 si le donateur a choisi de s'afficher comme anonyme publiquement. | 1 |
commentaire_donateur | Message 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.
| Champ | Description | Exemple |
|---|---|---|
id_don_recurrent | L'identifiant du post du plan récurrent. | 122 |
événement | Le slug de l'événement de déclenchement. | subscription_renewed |
id_premier_don | L'ID du don de la première transaction ayant initié ce plan. | 123 |
sous-total_récurrent | Le montant de base récurrent avant les frais. | 50 |
total_récurrent | Le montant récurrent facturé, frais inclus. | 53 |
periode_recu | L'unité de récurrence. | jour, semaine, mois, année |
intervalle_récurrent | Combien d'unités recurring_period entre les transactions. 1 = chaque mois, 3 = tous les trois mois, etc. | 1 |
durée_récurrente | Nombre total de transactions. 0 signifie aucune fin fixe. | 6 |
date_expiration_récurrente | Date de fin du plan, ISO 8601. Vide si ouvert. | 2026-09-08T00:00:00+00:00 |
date_renouvellement_récurrent | Date de la prochaine transaction prévue, ISO 8601. | 2026-06-01T00:00:00+00:00 |
id_abonnement_passerelle | La référence d'abonnement de la passerelle. Utile pour le rapprochement direct avec Stripe ou PayPal. | sub_xyz987 |
prénom | Prénom du donateur. | Wanda |
nom | Nom de famille du donateur. | Maximoff |
email | Adresse e-mail du donateur. | [email protected] |
adresse, adresse_2, ville, état, code_postal, pays, téléphone | Adresse et téléphone du donateur, lorsqu'ils sont collectés sur le formulaire. | |
sous-total | Le montant de base de la transaction individuelle la plus récente. | 25 |
total | Le montant final de la transaction individuelle la plus récente. | 26.50 |
date | Date de création du plan, ISO 8601. | 2026-05-08T14:20:27+00:00 |
statut | Le statut actuel du plan. Voir ci-dessous. | charitable-actif |
passerelle_don | Slug de la passerelle. | stripe |
mode_test | 1 si créé en mode test. | 0 |
id_campagne | La 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_donateur | Mêmes significations que la charge de don ci-dessus. | |
id_client_gocardless | Référence client GoCardless, le cas échéant. | goc123123 |
id_mandat_gocardless | Ré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.
| Champ | Description | Exemple |
|---|---|---|
id_campagne | L’ID de publication de la campagne. | 123 |
événement | Le slug de l'événement de déclenchement. | campaign_goal_reached |
titre | Titre de la campagne. | Appel de fin d’année |
description | Courte description de la campagne. | Aidez-nous à atteindre notre objectif de jumelage |
objectif | Objectif 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_donateurs | Nombre total de donateurs uniques. | 38 |
date_fin | Date 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 |
date | Date de publication de la campagne, ISO 8601. | 2026-05-01T10:00:00+00:00 |
statut | Statut de publication WordPress. | publish |
lien_permanent | URL publique de la campagne. | https://example.org/campaigns/year-end/ |
id_createur_campagne | ID utilisateur WordPress du propriétaire de la campagne. | 4 |
nom_createur_campagne | Nom d’affichage du propriétaire de la campagne. | Bruce Banner |
email_createur_campagne | Adresse e-mail du propriétaire de la campagne. | [email protected] |
destinataire | Où vont les fonds – généralement fundraiser pour le pair-à-pair ou parent pour les campagnes enfants. | fundraiser |
parent_campagne | Si la campagne est une campagne enfant pair-à-pair, l’ID de la campagne parente. 0 pour les campagnes autonomes. | 99 |
type_collecte_fonds | Pour les campagnes pair-à-pair, le type de collecte de fonds. | individuel, équipe |
id_équipe, nom_équipe, id_capitaine_équipe | Mé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.
