Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Chaque action significative dans votre programme d'ambassadeurs devrait déclencher une réponse. Lorsqu'une collecte de fonds est approuvée, l'ambassadeur doit le savoir immédiatement. Lorsqu'une candidature est rejetée, la personne mérite une explication claire. Lorsqu'un filleul s'inscrit via un lien d'invitation, la personne qui l'a recruté devrait en être informée.

Ambassadors déclenche 5 e-mails transactionnels qui gèrent tout cela automatiquement. Ils sont envoyés en réponse à un événement spécifique, et non à partir d'une campagne marketing que vous composez manuellement. Cette page documente chacun d'eux : quand il est envoyé, à qui il est destiné, à quoi ressemble le corps par défaut, quels balises intelligentes il accepte, et comment le personnaliser ou le désactiver.

Les cinq e-mails sont activés par défaut.

Où trouver ces e-mails d'ambassadeurs ?

Pour modifier le corps ou l'objet de l'un d'eux, allez dans Charitable » Paramètres » E-mails.

Faites défiler pour trouver les e-mails dont vous avez besoin. Vous pouvez activer/désactiver ces e-mails ici.

Comment modifier les e-mails des ambassadeurs ?

Une fois activé, cliquez sur le bouton Paramètres de l'e-mail pour accéder à l'e-mail à l'intérieur.

Un e-mail par défaut est configuré pour vous.

Vous pouvez modifier la ligne d'objet, le titre et le corps pour répondre à vos besoins.

Il existe également des codes courts que vous pouvez utiliser pour récupérer automatiquement des informations telles que l'URL de votre site Web, le nom de l'équipe, le nom du créateur, etc.

Si un e-mail est accidentellement désactivé, vous le verrez apparaître dans votre bannière Santé des e-mails.

Référence rapide

E-mail	ID	Se déclenche lorsque	Destinataire
Campagne approuvée	créateur_campagne_approuvée	Une collecte de fonds est approuvée par un modérateur ou approuvée automatiquement lors de la soumission.	L'ambassadeur.
Campagne rejetée	créateur_campagne_rejetée	Une collecte de fonds est rejetée par un modérateur.	L'ambassadeur.
Campagne nécessitant une révision	créateur_campagne_révision_requise	Un modérateur demande des modifications.	L'ambassadeur.
Approbation du filleul invité	recruteur_recrue_approuvée	La première collecte de fonds d'un ambassadeur recruté est approuvée.	L'invitant (recruteur).
Nouvelle campagne nécessitant une action	nouvelle_campagne_nécessite_une_action	Une nouvelle soumission de collecte de fonds arrive dans la file d'attente de modération.	Les administrateurs du site (tout utilisateur avec manage_charitable_settings).

Le côté technique

Campagne approuvée

ID : creator_campaign_approved
À : L'ambassadeur (post_author de la collecte de fonds)
Se déclenche : Chaque fois qu'une collecte de fonds passe au statut publié depuis un autre statut. L'action d'approbation de la modération déclenche ceci, l'approbation automatique lors de la soumission déclenche ceci, et la publication manuelle via l'éditeur WP déclenche ceci.

Sujet par défaut

Your campaign is live

Corps par défaut

Dear [charitable_email show=campaign_creator],

Your campaign, "[charitable_email show=campaign_title]", has been approved and is now live!

You can view your campaign online at [charitable_email show=campaign_url].

If you would like to edit it, go to [charitable_email show=campaign_edit_url].

Balises intelligentes disponibles

Balise	Substituts
[charitable_email show=campaign_creator]	Le nom d'affichage de l'ambassadeur.
[charitable_email show=campaign_title]	Le titre de la collecte de fonds.
[charitable_email show=campaign_url]	L'URL publique de la collecte de fonds.
[charitable_email show=campaign_edit_url]	L'URL d'édition de la collecte de fonds.
[charitable_email show=campaign_goal]	Le montant de l'objectif.
[charitable_email show=campaign_end_date]	La date de fin de la collecte de fonds.

Filtres de personnalisation

add_filter( 'charitable_email_creator_campaign_approved_default_subject', function ( $subject, $email ) {
    return "🎉 Your fundraiser is live: " . $email->get_field_value( 'campaign_title' );
}, 10, 2 );

add_filter( 'charitable_email_creator_campaign_approved_default_body', function ( $body, $email ) {
    return "
Welcome aboard!
" . $body . "
Reply to this email if you have any questions.
";
}, 10, 2 );

Supprimer par appel

Lors de l'approbation avec la case à cocher Notifier décochée, l'e-mail est supprimé via :

add_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );
// ...the approval runs...
remove_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );

N'utilisez pas ce filtre pour une suppression à l'échelle du site. Pour cela, utilisez la case à cocher Notifier par défaut via moderation_default_notify_on_approve.

Campagne rejetée

ID : creator_campaign_rejected
À : L'ambassadeur
Se déclenche : Lorsqu'un modérateur rejette une collecte de fonds via la file d'attente de modération.

Sujet par défaut

Your campaign was not approved

Corps par défaut

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and unfortunately it does not meet our guidelines.

Reason: [charitable_email show=rejection_reason]

If you'd like to discuss this further or submit a revised campaign, please reach out at [admin_email].

Balises intelligentes disponibles

Le même ensemble que Campagne approuvée, plus :

Balise	Substituts
[charitable_email show=rejection_reason]	Le texte de la raison du modal Rejeter.

Filtres de personnalisation

add_filter( 'charitable_email_creator_campaign_rejected_default_subject', function ( $subject ) {
    return 'About your recent fundraiser submission';
} );

add_filter( 'charitable_email_creator_campaign_rejected_default_body', function ( $body ) {
    return $body . '
You can read our submission guidelines at our guidelines page.
';
} );

Campagne nécessitant une révision

ID : creator_campaign_needs_revision
À : L'ambassadeur
Se déclenche : Lorsqu'un modérateur utilise l'action Demander des modifications.

Sujet par défaut

Updates needed to your campaign

Corps par défaut

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and we'd like a few small updates before publishing.

Notes from our team: [charitable_email show=revision_notes]

You can edit your campaign at [charitable_email show=campaign_edit_url] and resubmit when you're ready.

Balises intelligentes disponibles

Le même ensemble que Campagne approuvée, plus :

Balise	Substituts
[charitable_email show=revision_notes]	Les notes de la fenêtre modale Demander des modifications.
[charitable_email show=campaign_edit_url]	L'URL de l'éditeur du collecteur de fonds avec un jeton de connexion automatique par lien magique.

Filtres de personnalisation

add_filter( 'charitable_email_creator_campaign_needs_revision_default_body', function ( $body ) {
    return $body . '
Tip: reply to this email if you have questions about the requested changes.
';
} );

Approbation du filleul invité

ID : inviter_recruit_approved
À : L'invitant (recruteur)
Se déclenche : Lorsqu'une première collecte de fonds d'un ambassadeur recruté est approuvée, après que l'attribution a lié le recruté à l'invitant. S'envoie uniquement si l'option Envoyer un e-mail à l'invitant lors de l'approbation est activée dans les paramètres des Invitations, et uniquement après que l'attribution a lié le recruté à l'invitant.

Sujet par défaut

[charitable_email show=recruit_name] just joined as a fundraiser thanks to you!

Corps par défaut

Hi [charitable_email show=inviter_first_name],

Great news! [charitable_email show=recruit_name] just had their fundraiser approved - and they signed up through your invite link.

Their fundraiser: [charitable_email show=recruit_campaign_url]

Thanks for spreading the word.

Balises intelligentes disponibles

Balise	Substituts
[charitable_email show=inviter_name]	Le nom d'affichage de l'invitant.
[charitable_email show=inviter_first_name]	Le prénom de l'invitant.
[charitable_email show=recruit_name]	Le nom d'affichage du recruté.
[charitable_email show=recruit_campaign_title]	Le titre de la première collecte de fonds du recruté.
[charitable_email show=recruit_campaign_url]	L'URL de la première collecte de fonds du recruté.
[charitable_email show=site_url]	L'URL de votre site.

Filtres de personnalisation

add_filter( 'charitable_email_inviter_recruit_approved_default_subject', function ( $subject, $email ) {
    $recruit = $email->get_field_value( 'recruit_name' );
    return "🎉 Your friend {$recruit} is fundraising too!";
}, 10, 2 );

Désactivation sur l'ensemble du site

Activez ou désactivez le paramètre Envoyer un e-mail à l'invitant lors de l'approbation sous Charitable » Ambassadeurs » Invitations.

Nouvelle campagne nécessitant une action

ID : new_campaign_requires_action
À : Administrateurs du site (tout utilisateur avec manage_charitable_settings)
Se déclenche : Lorsqu'une nouvelle collecte de fonds est soumise et que l'approbation automatique est désactivée, ce qui signifie qu'elle arrive dans la file d'attente de modération.

Sujet par défaut

A new fundraiser needs your review

Corps par défaut

A new fundraiser was submitted and is awaiting review.

Title: [charitable_email show=campaign_title]
Ambassador: [charitable_email show=campaign_creator]
Submitted: [charitable_email show=submission_date]

Review it in the Moderation queue: [charitable_email show=moderation_url]

Balises intelligentes disponibles

Balise	Substituts
[charitable_email show=campaign_title]	Le titre de la collecte de fonds.
[charitable_email show=campaign_creator]	Le nom d'affichage de l'ambassadeur.
[charitable_email show=campaign_url]	L'URL de la collecte de fonds (aperçu si pas encore publique).
[charitable_email show=submission_date]	Horodatage de la soumission.
[charitable_email show=moderation_url]	Lien direct vers la vue En attente dans la modération.

Filtres de personnalisation

add_filter( 'charitable_email_new_campaign_requires_action_default_subject', function () {
    return '🔔 [Charitable] Fundraiser awaiting review';
} );

Limitation

L'e-mail d'administration se déclenche une fois par soumission. Si votre équipe de modération est petite et que le volume devient excessif, envisagez d'utiliser plutôt les Notifications (le panneau avec l'icône de cloche). Il est limité en fréquence et peut être ignoré, ce qui en fait une meilleure option pour les programmes à volume élevé.

Ce que les cinq e-mails ont en commun

Quelques conventions s'appliquent à chaque e-mail, ce qui rend leur personnalisation cohérente une fois que vous connaissez le modèle.

Identifiants d'e-mail

Les chaînes d'identifiants (telles que creator_campaign_approved) sont stables. Elles sont utilisées comme préfixe de filtre (charitable_email_<id>_default_subject, etc.) et comme clé d'option pour le paramètre d'activation/désactivation des e-mails de Charitable.

Filtres

Chaque e-mail expose le même ensemble de filtres. Tous reçoivent l'objet $email comme deuxième argument afin que vous puissiez appeler get_field_value() pour composer votre personnalisation :

charitable_email__default_subject
charitable_email__default_body
charitable_email__recipient_email
charitable_email__recipient_name
charitable_email__should_send

Filtre de balise intelligente

Ajoutez de nouvelles balises intelligentes en vous accrochant au filtre de valeur du champ de contenu, puis utilisez votre balise dans le corps de n'importe quel e-mail :

add_filter( 'charitable_email_content_field_value_', function ( $value, $email ) {
    return 'Computed value';
}, 10, 2 );

// Then use [charitable_email show=your_tag] in any email body.

Adresse de l'expéditeur

Les cinq e-mails utilisent par défaut l'adresse admin_email de WordPress. Remplacez globalement via charitable_email_from_address ou par e-mail via charitable_email_<id>_from_address.

HTML vs Texte brut

Les cinq e-mails sont en HTML par défaut. Les clients de messagerie des destinataires reviendront automatiquement à une représentation en texte brut. Pour forcer le texte brut, renvoyez un corps dépouillé du filtre _default_body.

Conseils à garder à l'esprit

Quelques éléments qui font une réelle différence dans la façon dont ces e-mails parviennent à vos ambassadeurs.

• Personnalisez davantage les lignes d'objet que les corps. Les lignes d'objet déterminent les taux d'ouverture. Les corps clairs et directs surpassent presque toujours les corps astucieux.
• Envoyez toujours un test avant le déploiement. Charitable Pro dispose d'un bouton « Envoyer un test » sur la page des paramètres de chaque e-mail. Utilisez-le chaque fois que vous modifiez un sujet ou un corps, pas seulement lors de la configuration initiale.
• Utilisez les balises intelligentes à bon escient. Le codage en dur du nom de l'ambassadeur signifierait que chaque appel de fonds reçoit le même e-mail impersonnel. Les balises intelligentes donnent l'impression que chaque message a été rédigé spécifiquement pour cette personne.
• Gardez court l'e-mail « Nouvelle campagne nécessitant une action ». Votre équipe de modération lit ceci plusieurs fois par semaine. Une phrase avec le titre de la campagne et un lien direct vers la file d'attente est plus utile qu'un long paragraphe qu'ils survoleront.

Référence développeur

Hiérarchie des classes d'e-mails

Charitable_Email                                                    # Pro base class
    └─ Charitable_Ambassadors_Email_Creator_Campaign_Submitted     # Base for creator-targeted emails
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Approved
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Rejected
            └─ Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision
    └─ Charitable_Ambassadors_Email_Inviter_Recruit_Approved        # For inviter-targeted
    └─ Charitable_Ambassadors_Email_New_Campaign_Requires_Action    # Admin-targeted

Chaque classe feuille se trouve dans includes/emails/.

Aides statiques

Pour le déclenchement programmatique :

Charitable_Ambassadors_Email_Creator_Campaign_Approved::send_with_campaign_id( $campaign_id );
Charitable_Ambassadors_Email_Creator_Campaign_Rejected::send_with_campaign_id( $campaign_id, $reason );
Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision::send_with_campaign_id( $campaign_id, $notes );
Charitable_Ambassadors_Email_Inviter_Recruit_Approved::send_with_recruit_id( $recruit_user_id, $recruit_campaign_id, $inviter_user_id );
Charitable_Ambassadors_Email_New_Campaign_Requires_Action::send_with_campaign_id( $campaign_id );

Capacités

L'e-mail « Nouvelle campagne nécessitant une action » est envoyé à tous les utilisateurs disposant de manage_charitable_settings. Pour cibler des administrateurs spécifiques à la place, filtrez la liste des destinataires via charitable_email_new_campaign_requires_action_admin_recipients.

En résumé

Cela couvre les cinq e-mails transactionnels d'Ambassadors. Entre les e-mails d'approbation, de rejet et de révision que vos ambassadeurs reçoivent, et la notification d'administrateur qui maintient votre file d'attente de modération en mouvement, ce sont les messages qui maintiennent votre programme opérationnel en coulisses. Personnalisez les lignes d'objet, ajoutez la voix de votre marque aux corps, et utilisez des balises intelligentes pour que chaque e-mail semble personnel.

Si vous rencontrez quelque chose qui n'est pas couvert ici ou si vous avez besoin d'aide pour un e-mail spécifique, notre équipe de support est heureuse de vous aider.

Vous pourriez aussi vouloir lire

Ce sont les documents les plus étroitement liés aux e-mails transactionnels d'Ambassadors.

• Modération – les actions (approuver, rejeter, demander des modifications) qui déclenchent la plupart de ces e-mails.
• Santé de l'e-mail – la bannière sur l'aperçu qui signale l'un de ces e-mails lorsqu'ils ont été accidentellement désactivés.
• Notifications – le panneau dans l'administration avec l'icône de cloche qui complète ces e-mails pour votre équipe de modération.
• Invitations – la fonctionnalité qui déclenche l’e-mail « Recrue invitée approuvée ».
• Hooks & filtres dans Ambassadeurs – la référence complète des filtres.