Le Créateur d'automatisations visuelles transforme Charitable Automation Connect en un canevas de glisser-déposer en plein écran où vous pouvez voir chaque automatisation comme un flux de cartes connectées : un Déclencheur, des Conditions optionnelles et une ou plusieurs Actions qui s'exécutent dans l'ordre. Au lieu de configurer un seul webhook dans un formulaire, vous créez maintenant un petit pipeline qui se déclenche lorsque quelque chose se produit dans Charitable, vérifie si vos règles correspondent, puis exécute chaque action que vous avez ajoutée.

Disponible dans Charitable Automation Connect 2.3.0 et versions ultérieures.

Fonctionnalités clés

• Créez des automatisations visuellement sur un canevas en plein écran, conçu pour correspondre au Créateur de campagnes Charitable.
• Exécutez plusieurs actions par automatisation, dans l'ordre, à partir d'un seul déclencheur.
• Taguez automatiquement les donateurs dans Charitable avec la nouvelle action Taguez le donateur, aucun service externe requis.
• Envoyez des webhooks à Zapier, Make, n8n, Pabbly Connect, ou tout point de terminaison acceptant une requête HTTP POST.
• Conditionnez chaque automatisation avec des groupes de conditions qui correspondent à TOUTES ou N'IMPORTE LESQUELLES de vos règles.
• Appliquez une automatisation aux donateurs existants avec le remplissage Rétroactif pour les donateurs existants.
• Basculez librement entre l'éditeur de formulaire simple et le créateur de canevas, les deux modifiant la même automatisation.
• Choisissez parmi 21 événements déclencheurs concernant les dons, les donateurs, les dons récurrents et les campagnes.
• Testez et déboguez n'importe quel webhook en ligne avant qu'il ne s'exécute sur un vrai don.

Pourquoi utiliser le générateur d'automatisation visuelle ?

Avant la version 2.3.0, chaque automatisation était un seul webhook déclenché par un seul événement. Les flux de travail de collecte de fonds réels sont rarement aussi simples. Vous voulez souvent qu'un événement fasse plusieurs choses à la fois, par exemple, taguer le donateur, notifier votre équipe sur Slack et pousser l'enregistrement vers votre CRM. Le Créateur d'automatisations visuelles vous permet de voir et de gérer l'ensemble de ce flux sur un seul écran, d'ajouter autant d'actions que nécessaire et de confirmer exactement ce qui sera exécuté avant sa mise en ligne. Il apporte la clarté d'un outil de flux de travail visuel à vos automatisations de dons sans vous demander d'écrire du code.

Voyez-le en action

Exigences

• Charitable Automation Connect 2.3.0 ou version ultérieure
• Un plan Charitable Pro actif qui inclut Automation Connect (la livraison est bloquée en cas de licence insuffisante ou expirée)
• WordPress 6.2 ou ultérieure
• Action Scheduler (inclus avec Charitable) pour la livraison des webhooks en arrière-plan

Démarrage

Où le trouver

1. Dans votre administration WordPress, allez dans Charitable > Automatisations.
2. La liste des automatisations montre chaque automatisation, son déclencheur, son statut et sa dernière livraison.
3. Cliquez sur Ajouter pour créer une nouvelle automatisation, ou cliquez sur une automatisation existante pour la modifier.

Les nouvelles automatisations et celles basées sur des modèles s'ouvrent par défaut dans le créateur de canevas. Les automatisations existantes s'ouvrent dans la vue qui leur convient, avec un bouton pour changer.

Les deux éditeurs : Simple et Canevas

Chaque automatisation peut être ouverte dans l'une des deux vues. Les deux modifient la même automatisation sous-jacente, et vous pouvez basculer entre elles à tout moment.

Simple

La forme classique, intégrée dans l'administration WordPress normale. Elle est idéale pour des modifications rapides : choisissez un déclencheur, définissez des conditions et configurez une seule livraison. Utilisez le lien Vue Canevas pour ouvrir la même automatisation dans le constructeur visuel.

Canevas

Le constructeur visuel en plein écran. Il prend le contrôle de l'écran, tout comme le Constructeur de Campagne, et affiche :

• Une barre supérieure avec le logo Charitable, un champ de nom d'automatisation en direct, un bouton Enregistrer, et un contrôle de statut.
• Un lien Vue Simple qui revient à l'éditeur intégré. Si vous avez des modifications non enregistrées, il vous invite d'abord à enregistrer.
• Une colonne de configuration gauche avec quatre onglets : Déclencheur, Conditions, Action, et Infos.
• Le canevas lui-même : cartes Déclencheur, Conditions et Action reliées par des lignes de connexion, avec un bouton Ajouter une Action, des contrôles de zoom, un quadrillage, et une mini-carte. La ligne du Déclencheur aux Conditions s'anime pour montrer la direction du flux.

Construction d'une automatisation

1. Choisissez un déclencheur. Dans l'onglet Déclencheur, choisissez l'événement qui démarre l'automatisation, par exemple Don créé ou Paiement de don récurrent effectué.
2. Ajoutez des conditions (facultatif). Dans l'onglet Conditions, construisez un ou plusieurs groupes de règles. Laissez vide pour exécuter toujours.
3. Ajoutez des actions. Cliquez sur Ajouter une Action pour ouvrir la palette d'actions, puis choisissez Webhook ou Marquer le Donateur. Chaque action que vous ajoutez apparaît comme une nouvelle carte dans le flux. Les actions s'exécutent de haut en bas.
4. Configurez chaque action. Sélectionnez une carte d'action, puis utilisez l'onglet Action pour définir ses options.
5. Réorganisez si nécessaire. Faites glisser les actions pour changer l'ordre dans lequel elles s'exécutent.
6. Enregistrer. Cliquez sur Enregistrer. Le bouton confirme en ligne lorsque vos modifications sont stockées.

Événements déclencheurs

Automation Connect 2.3.0 propose 21 événements déclencheurs couvrant le cycle de vie des dons, les donateurs, les dons récurrents et les campagnes. Exemples :

• Don créé
• Don complété
• Donateur créé (Premier don)
• Paiement de don récurrent effectué
• Objectif de campagne atteint

Le sélecteur de déclencheurs liste tous les événements en majuscules. Chaque événement affiche un texte d'aide décrivant quand il se déclenche.

Conditions

Les conditions sont facultatives. Construisez un ou plusieurs groupes de règles et choisissez si une automatisation s'exécute lorsqu'elle correspond à TOUTES ou N'IMPORTE LAQUELLE des règles d'un groupe. Laissez les conditions vides pour exécuter toujours. Le constructeur de conditions reflète le style de logique conditionnelle du Constructeur de Campagne, l'expérience est donc familière.

Actions

Une automatisation exécute une liste ordonnée d'actions lorsque son déclencheur se déclenche et que ses conditions sont remplies. La version 2.3.0 propose deux types d'actions.

Webhook

Envoyez les données de l'événement via une requête HTTP POST à n'importe quelle URL. C'est ainsi que vous connectez Charitable à Zapier, Make, n8n, Pabbly Connect et d'autres outils.

Option	Type	Défaut	Description
URL de livraison	chaîne de caractères	(vide)	Obligatoire. L'URL qui reçoit la requête POST du webhook. Doit commencer par https://.
Mode de livraison	choix	Asynchrone	La mise en file d'attente asynchrone de la requête en arrière-plan pour de meilleures performances.
Type de contenu	choix	JSON	JSON (application/json) pour Zapier, Make et la plupart des outils modernes, ou encodé formulaire (application/x-www-form-urlencoded) pour les points de terminaison qui l'attendent.
Secret	chaîne de caractères	généré automatiquement	Facultatif. Utilisé pour signer les charges utiles des webhooks. Laissez vide pour générer automatiquement.
En-têtes personnalisés	liste	(vide)	En-têtes de requête facultatifs tels qu'une clé API ou un jeton porteur. Les en-têtes Content-Type et signature sont gérés automatiquement et ne peuvent pas être remplacés.
Charge utile	champs	tous les champs	Choisissez les champs à inclure et faites-les glisser pour les réorganiser. La modification de la charge utile est disponible en mode Simple.

La livraison des webhooks s'exécute en arrière-plan par défaut. Les webhooks ne sont pas appliqués lors du remplissage.

Étiqueter le donateur

La première action qui s'exécute à l'intérieur de Charitable, sans service externe nécessaire. Elle modifie les étiquettes d'un donateur lorsque l'automatisation s'exécute.

Option	Type	Défaut	Description
Mode	choix	Ajouter une étiquette	Ajouter une étiquette (conserver les étiquettes existantes), Supprimer une étiquette, ou Remplacer un groupe (promouvoir ou rétrograder au sein d'un groupe d'étiquettes nommé).
Groupe	chaîne de caractères	(vide)	Utilisé uniquement lorsque le Mode est Remplacer le groupe. Le groupe d'étiquettes dans lequel échanger.
Étiquettes	liste	(vide)	Obligatoire. L'étiquette ou les étiquettes à appliquer. Les étiquettes sont créées automatiquement si elles n'existent pas.

Étant donné que Tag Donor s'exécute à l'intérieur de Charitable, il peut être appliqué aux donateurs existants par le biais du remplissage.

Appliquer aux donateurs existants (Remplissage)

Pour les automatisations dont les actions le prennent en charge, comme Tag Donor, un contrôle Appliquer aux donateurs existants estime le nombre de donateurs qui seraient affectés, vous demande de confirmer, puis les traite en arrière-plan. Seules les actions dans WordPress s'exécutent lors d'un remplissage. Les actions de webhook sont ignorées, car les dons passés n'ont pas été effectués en temps réel.

Tester et déboguer

Dans l'onglet Test d'une action de webhook, utilisez Envoyer une charge utile de test pour envoyer un webhook et voir la réponse en ligne. Vous pouvez tester avec des données d'exemple ou avec un enregistrement réel afin de voir exactement ce qu'une livraison en direct enverra. Le test contourne la livraison asynchrone afin que vous obteniez le résultat immédiatement. Une fois qu'une automatisation est enregistrée, l'historique de livraison et un contrôle de renvoi vous aident à diagnostiquer les échecs.

Compatibilité

Les automatisations créées avant la version 2.3.0 continuent de fonctionner sans modification. Une automatisation de webhook unique héritée est traitée comme une automatisation avec une seule action de webhook, de sorte que les livraisons et les Zaps existants continuent de se déclencher exactement comme avant. Aucune étape de migration n'est requise de votre part.

Dépannage

Les lignes de connexion entre les cartes sont manquantes

Ceci a été résolu dans la version 2.3.0. Si vous utilisez la version actuelle et que vous ne voyez toujours pas les lignes, rechargez le constructeur. Les lignes de flux sont dessinées automatiquement lorsque le canevas s'ouvre.

Une automatisation ne se déclenche pas

Vérifiez que le statut de l'automatisation est actif, et non en pause ou désactivé. Seules les automatisations actives sont envoyées. Confirmez également que votre licence Charitable Pro est active et non expirée, car la livraison est bloquée en cas de plan insuffisant ou expiré.

Les webhooks sont mis en file d'attente mais jamais envoyés

Les webhooks sont livrés par défaut en arrière-plan (asynchrone), ce qui repose sur Action Scheduler. Assurez-vous que les tâches planifiées de votre site s'exécutent. Pour un résultat immédiat pendant les tests, utilisez le contrôle Envoyer la charge utile de test ou définissez l'action sur livraison synchrone.

La rétroaction n'a pas envoyé de webhooks aux donateurs passés

C'est attendu. La rétroaction n'exécute que les actions dans WP, telles que Tag Donor. Les actions de webhook sont ignorées pour les donateurs existants par conception.

Ressources pour les développeurs

Accroches et filtres

• charitable_automation_connect_actions filtre les types d'actions enregistrés, vous pouvez donc ajouter votre propre action.
• charitable_automation_connect_events et charitable_automation_connect_event_labels filtrent les événements déclencheurs enregistrés et leurs étiquettes.
• charitable_automation_connect_events_for_editor filtre la liste des événements (et le texte d'aide par événement) transmis au constructeur.
• charitable_automation_connect_condition_fields filtre les champs disponibles dans le constructeur de conditions.
• charitable_automation_connect_templates et charitable_automation_connect_zapier_templates filtrent les modèles de démarrage.
• charitable_automation_connect_merge_tags et charitable_automation_connect_payload_fields filtrent les balises de fusion et les champs de la charge utile du webhook.
• charitable_automation_connect_default_editor_mode filtre le mode d'éditeur qui s'ouvre par défaut.
• charitable_automation_connect_http_args et charitable_automation_connect_secret_key filtrent la livraison sortante des webhooks.
• charitable_webhook_subscription_failure_threshold filtre le nombre d'échecs qui désactivent une automatisation.
• charitable_automation_connect_fire_event se déclenche lorsqu'un événement est envoyé, pour une gestion personnalisée.

Notes pour l'extension des actions

Les actions sont enregistrées dans le registre d'actions du module complémentaire et chacune étend une classe d'action abstraite partagée qui déclare son slug, son étiquette, son groupe, les événements pris en charge, si elle est rétroactive, son schéma de configuration et sa méthode d'exécution. Enregistrez votre propre action sur charitable_automation_connect_actions pour qu'elle apparaisse dans la palette Ajouter une action.

Ressources supplémentaires

• Documentation d'Automation Connect
• Annonce du constructeur d'automations visuelles
• Documentation Zapier