Requis : Charitable Pro 1.8.18+ et WordPress 6.9+

Mis à jour : 17 septembre 2026

Si vous n'avez pas encore connecté d'assistant, commencez par Démarrer avec les assistants IA. Cette page est l'image complète : chaque opération, le fonctionnement des autorisations et ce qui est délibérément hors de portée.

Pour une documentation plus détaillée, tout sur Charitable + AI est ici »

Comment cela fonctionne

Charitable enregistre ses opérations auprès de l'API WordPress Abilities, arrivée avec WordPress 6.9. Il s'agit d'une fonctionnalité de base de WordPress, pas de Charitable : n'importe quel plugin peut décrire ce qu'il peut faire, et n'importe quel client connecté peut ensuite lire cette description et agir en conséquence.

La conséquence pratique est que Charitable n'a pas intégré d'assistant particulier. Il publie ses opérations sur WordPress, et quel que soit le client que vous connectez, que ce soit Claude, ChatGPT ou tout autre outil parlant MCP, il lit la même liste. Lorsqu'un nouveau client apparaît, il fonctionne avec Charitable dès le premier jour sans que nous ayons rien à faire, ni vous.

Sur WordPress 6.8 ou une version antérieure, rien ne s'enregistre et rien ne change sur votre site.

Ce que vous pouvez faire

Chacun a une description écrite pour l'assistant, lui indiquant quand l'opération est le bon choix et ce que signifient ses valeurs. Vous n'appelez jamais ces opérations par leur nom. Vous décrivez ce que vous voulez, et l'assistant choisit.

Diagnostics (3)

Opération	Ce qu'il fait
Obtenir les informations du plugin Charitable	Version, statut de la licence et quels modules complémentaires Charitable sont actifs.
Obtenir l'environnement du site	Versions de WordPress et PHP, thème actif, devise et état du mode test.
Obtenir le statut de la passerelle	Quelles passerelles de paiement sont activées et si chacune est configurée. N'inclut jamais les clés ou les secrets.

Ce sont ces éléments qui permettent à un assistant de répondre à « pourquoi mes dons n'apparaissent-ils pas ? » avec un diagnostic réel au lieu d'une supposition.

Campagnes (14)

Opération	Ce qu'il fait
Lister les campagnes	Vos campagnes, filtrables par statut et triables par date, titre, montant collecté ou objectif.
Obtenir une campagne	Détails complets d'une campagne.
Obtenir les performances d'une campagne	Ce qu'une campagne a rapporté, son nombre de dons et sa progression vers l'objectif.
Lister les modèles de campagne	Les modèles du Constructeur de campagnes disponibles, afin qu'une nouvelle campagne puisse en utiliser un.
Créer une campagne	Une nouvelle campagne, classique ou visuelle. Voir Création de campagnes.
Mettre à jour la campagne	Modifier un objectif, une date de fin, une description ou des montants de don suggérés. Les champs que vous ne mentionnez pas sont inchangés.
Définir le statut de la campagne	Publier, dépublier ou passer de brouillon, en attente et privé.
Mettre la campagne à la corbeille	Déplacer une campagne vers la corbeille. Réversible. Refuse une campagne avec des dons sauf si vous confirmez.
Restaurer la campagne	Récupérer une campagne mise à la corbeille.
Obtenir le formulaire de don de la campagne	Les champs du formulaire de don d'une campagne, y compris les options et la valeur par défaut de tout menu déroulant, bouton radio ou case à cocher.
Mettre à jour le formulaire de don de la campagne	Modifier les champs existants : libellés, espaces réservés, état requis, ordre au sein d'une étape.
Ajouter un champ au formulaire de don de la campagne	Ajouter une nouvelle question à un formulaire de don. Voir Champs du formulaire.
Obtenir les styles de la campagne	Les couleurs, la typographie et les paramètres d'animation du design d'une campagne, tels qu'ils s'affichent actuellement.
Mettre à jour les styles de la campagne	Modifier ces couleurs et paramètres. Campagnes du générateur de campagnes uniquement.

Dons (4)

Opération	Ce qu'il fait
Lister les dons	Dons, filtrables par campagne, donateur, statut et plage de dates.
Obtenir un don	Un don en totalité, y compris les campagnes sur lesquelles il a été réparti.
Créer un don manuel	Enregistrer un cadeau reçu en dehors de votre site web, tel qu'un chèque, de l'argent liquide ou un virement bancaire.
Obtenir le résumé des dons	Totaux, nombres et moyennes pour un ensemble de dons.

Donateurs (3)

Opération	Ce qu'il fait
Lister les donateurs	Vos donateurs et leurs totaux. N'inclut jamais les adresses e-mail ou postales, qui que ce soit qui demande.
Obtenir un donateur	Un donateur nommé en entier, avec les coordonnées. Nécessite la capacité « données sensibles ».
Obtenir les dons d'un donateur	Tout ce qu'un donateur a donné. Nécessite la capacité « données sensibles ».

Rapports (5)

Opération	Ce qu'il fait
Obtenir un aperçu des rapports	Totaux pour toute période donnée : collecté, remboursé, net, nombre de dons et de donateurs.
Obtenir l'activité des rapports	Une ventilation jour par jour, éventuellement pour une seule campagne. Limité à 732 jours par requête.
Obtenir les meilleures campagnes	Vos campagnes les plus performantes. Classées sur toute la période sauf si vous spécifiez des dates.
Obtenir les meilleurs donateurs	Vos plus grands soutiens, avec leurs totaux. Classés sur toute la période sauf si vous spécifiez des dates. Nécessite la capacité « données sensibles ».
Obtenir les plages de dates des rapports	Les plages nommées disponibles, et la date calendaire actuelle, ce qui permet à un assistant de déterminer ce que signifie « la fin du mois prochain ».

Sur un site multi-devises, chaque chiffre ci-dessus est le montant converti, donc un rapport n'ajoute jamais de yens aux dollars.

Création de campagnes

Deux types, et la différence est importante :

Les campagnes visuelles sont construites avec un modèle de créateur de campagne et sont modifiables par la suite dans le constructeur glisser-déposer. C'est ce que devrait être une levée de fonds créée par IA, et la description de l'opération le dit. Le mode visuel configure la mise en page et le contenu du modèle, ses couleurs, et une échelle de montants de dons suggérés.

Cette échelle est adaptée à votre objectif, donc une grande campagne reçoit des suggestions proportionnellement plus importantes plutôt que des montants que le donateur devrait donner des centaines de fois :

Objectif	Montants suggérés
50 000 $ et plus	100 / 250 / 500 / 1 000
10 000 $ à 49 999 $	50 / 100 / 250 / 500
2 000 $ à 9 999 $	25 / 50 / 100 / 250
500 $ à 1 999 $	10 / 25 / 50 / 100
Moins de 500 $, ou pas d'objectif	5 / 10 / 15 / 20

Demandez vos propres montants et vous les obtiendrez à la place. Demandez-en aucun et vous n'en obtiendrez aucun.

Le mode visuel ne configure pas de passerelle de paiement, et il n'invente pas d'objectif ni de date de fin, alors fournissez-les si la campagne en a besoin.

Les campagnes classiques sont basiques, modifiées dans l'éditeur de publication WordPress normal : pas de modèle, pas de couleurs, pas de montants suggérés. Une campagne classique n'a pas de styles de conception propres, donc Mettre à jour les styles de campagne la refusera et expliquera que ses couleurs proviennent de votre thème, et que l'ouvrir une fois dans le Générateur de campagnes est la façon de la convertir.

Les nouvelles campagnes sont créées comme des brouillons sauf si vous demandez le contraire, donc rien ne devient public par accident.

Champs de formulaire

Un assistant peut ajouter dix types de questions à un formulaire de don : texte sur une seule ligne, texte de paragraphe, nombre, téléphone, URL, e-mail, date, case à cocher, boutons radio et liste déroulante.

Les trois derniers prennent un ensemble d'options et, si vous le souhaitez, une valeur par défaut présélectionnée. « Ajouter une liste déroulante pour savoir comment ils ont entendu parler de nous : Facebook, un ami, notre newsletter, par défaut la newsletter » fonctionne comme une seule demande. Au moins une option est requise, car un champ de choix sans rien à choisir n'est pas un champ.

Deux choses qu'un assistant ne peut délibérément pas faire, car l'une ou l'autre arrêterait le rendu de votre formulaire :

• Déplacer un champ entre les étapes d'un formulaire multi-étapes. Il peut réorganiser les champs au sein d'une étape.
• Supprimer un champ dont le formulaire a besoin pour fonctionner, c'est-à-dire le montant du don ou la section de paiement.

Conception et styles

Obtenir les styles de campagne signale les couleurs, la typographie et les paramètres d'animation d'une campagne tels qu'ils sont actuellement rendus. Une campagne dont l'onglet Styles n'a jamais été enregistré signale la palette du modèle à partir duquel elle a été construite.

Deux limitations honnêtes, toutes deux délibérées :

• La couleur du texte du corps n'est pas signalée. Sur une campagne construite à partir d'un modèle, elle ne peut pas être lue de manière fiable, donc Charitable ne signale pas une valeur qu'il pourrait se tromper. Mettre à jour les styles de campagne peut toujours la définir.
• La famille de polices de la campagne ne peut pas être modifiée via un assistant. Rien ne rend encore ce paramètre, et le contrôle de la famille de polices du Générateur de campagnes a la même limitation, donc la demande est refusée plutôt qu'acceptée et ignorée silencieusement.

Les tailles de typographie et les préréglages d'animation sont vérifiés par rapport aux valeurs qui fonctionnent réellement. Demandez quelque chose qui n'existe pas et on vous indiquera les valeurs acceptées, plutôt qu'un message de succès et aucun changement visible.

L'accès en écriture est désactivé jusqu'à ce que vous l'activiez

Indépendamment de, et en plus de, tout ce qui se trouve dans la section Permissions ci-dessous.

Un site qui n'a jamais touché au réglage permet à un assistant de lire ses campagnes, dons, donateurs et rapports, et refuse toute modification. Neuf des vingt-neuf opérations sont des modifications : les huit opérations de campagne qui créent, mettent à jour, publient, mettent à la corbeille, restaurent ou re-stylisent, plus l'enregistrement d'un don. Les vingt autres sont des lectures et ne sont jamais affectées.

Activez-le sous Charitable > Outils > IA MCP. Cet écran montre également ce qui est enregistré et si un client peut se connecter ou non.

Trois points à comprendre sur son comportement :

• Rien n'est caché. Une opération bloquée apparaît toujours à l'assistant, qui sait donc que la capacité existe. Tenter de l'exécuter renvoie un refus qui indique l'écran à modifier, plutôt que l'opération n'existe tout simplement pas, ce qui amènerait un assistant à vous dire que Charitable ne peut pas faire quelque chose qu'il peut.
• Un refus ne change rien du tout. La requête est rejetée avant toute lecture, validation ou écriture.
• Les refus sont enregistrés, sous Charitable > Outils > Journaux filtrés sur Capacités, de sorte qu'une tentative de modification alors que l'écriture était désactivée laisse une trace.

Les développeurs peuvent outrepasser le réglage dans un sens ou dans l'autre avec le filtre charitable_abilities_allow_write, ce qui est utile pour le forcer à désactiver dans un environnement de staging, indépendamment de ce que dit la base de données.

Permissions

Rien n'est exposé à quiconque ne pourrait pas déjà le faire dans votre tableau de bord. Chaque opération vérifie une capacité Charitable avant de s'exécuter, et un assistant connecté en tant que Gestionnaire de campagnes peut faire strictement moins qu'un administrateur.

Pour ce faire	Vous devez être capable de
Lire les diagnostics	Gérer les paramètres Charitable
Lire ou lister les campagnes	Modifier les campagnes, plus lire cette campagne particulière
Créer ou modifier une campagne	Modifier cette campagne spécifique, pas seulement les campagnes en général
Publier ou dépublier une campagne	Publier des campagnes
Mettre une campagne à la corbeille	Supprimer les campagnes publiées
Lire les dons, ou lister les donateurs	Modifier les dons
Enregistrer un don manuel	Modifier les dons des autres
Voir les détails de contact d'un donateur nommé, ou vos meilleurs donateurs	Voir les données sensibles de Charitable
Lire les rapports	Exporter les rapports Charitable

Notez la troisième ligne. La modification d'une campagne est vérifiée par rapport à cette campagne, et non par rapport aux campagnes en tant que catégorie, donc sur un site multi-auteurs, un créateur de campagne ne peut pas accéder au travail d'un autre via un assistant.

Ce qui est délibérément hors de portée

• Toutes les modifications, jusqu’à ce que l’accès en écriture soit activé. Voir ci-dessus. C’est la seule limite de cette liste que vous contrôlez plutôt que nous.
• Informations d’identification de paiement. Vos clés et secrets de passerelle ne sont inclus dans rien qu’un assistant puisse lire, quel que soit le niveau d’autorisation.
• Adresses e-mail et postales des donateurs en masse. Les listes de donateurs ne les transportent jamais, qui que ce soit qui demande, donc une lecture autorisée ne peut pas devenir une exportation de votre fichier de donateurs.
• Suppression définitive d’une campagne. Ses enregistrements de dons y pointent, et sa destruction orphelinerait l’argent que de vraies personnes ont donné. La corbeille est réversible ; la suppression définitive n’est pas proposée.
• Mettre une campagne à la corbeille qui a des dons, sauf si vous le confirmez explicitement.
• Désactiver le mode test, activer une passerelle ou modifier le statut d’un don. Ce sont des tâches du tableau de bord, intentionnellement.

Voir ce qu’un assistant a fait

• Charitable » Outils » Journaux, filtré sur Capacités, enregistre chaque modification. Si plusieurs personnes utilisent des assistants sur votre site, donnez à chacune son propre mot de passe d'application et ce journal vous indique qui a fait quoi.
• Charitable » Outils » Informations système contient une section API des capacités : si les opérations sont enregistrées, si elles sont visibles via l'API REST et ce que votre version de WordPress prend en charge. Commencez ici lorsqu'un client se connecte mais ne voit rien.

Dépannage

Le site se connecte, mais aucune opération Charitable n'apparaît. 

Ce n'est pas un problème d'authentification. Vérifiez que WordPress est en version 6.9 ou ultérieure et que Charitable Pro est en version 1.8.18 ou ultérieure, puis consultez Outils > Informations système.

Votre assistant indique qu'il ne peut rien changer. 

L'accès en écriture est désactivé, ce qui est le paramètre par défaut. Activez-le dans Charitable > Outils > IA MCP. La lecture n'est pas affectée dans les deux cas.

Votre assistant signale une erreur d'autorisation. 

Le compte que vous avez connecté manque de la capacité dont cette opération a besoin. Vérifiez donc le tableau ci-dessus et connectez-vous en tant qu'utilisateur qui la possède. C'est différent de l'accès en écriture désactivé, et le message l'indique.

Un rapport jour par jour sur plusieurs années échoue. 

L'activité d'obtention des rapports est limitée à 732 jours par requête, et elle indique l'opération à utiliser pour une période plus longue. Demandez des totaux plutôt qu'une ventilation quotidienne, ou réduisez la période.

« Quelle campagne obtient les meilleurs résultats ? » donne une réponse inattendue. 

Les campagnes les plus performantes et les donateurs les plus importants sont classés sur toute la période par défaut et indiquent la période utilisée. Si un chiffre semble erroné, vérifiez d'abord la période dans la réponse.

Aucune section Mots de passe d'application dans votre profil. 

Elle n'apparaît que sur les sites servis via HTTPS.