Connectez Charitable à Brevo (anciennement Sendinblue) afin que les donateurs qui s'inscrivent sur vos formulaires de don soient automatiquement ajoutés à votre liste de contacts Brevo, avec leurs détails mappés aux attributs de contact Brevo. Disponible dans l'extension Charitable Newsletter Connect, version 2.4.0 et ultérieures.
Beta : Le support Brevo est actuellement en Beta. Il est sûr de l'utiliser en production, et nous recueillons activement des commentaires. Si quelque chose ne se comporte pas comme prévu, votre journal d'activité Charitable (voir Surveillance ci-dessous) capture les détails.
Fonctionnalités clés
- Ajoutez automatiquement les donateurs à une liste Brevo choisie lorsqu'ils s'inscrivent sur un formulaire de don.
- Mappez les champs de donateur Charitable aux attributs de contact Brevo (prénom, nom et vos propres attributs personnalisés).
- Double opt-in optionnel, afin qu'un donateur confirme par e-mail avant d'être abonné.
- Définissez une liste par défaut pour toutes les campagnes, ou choisissez une liste différente par campagne.
- Support complet du RGPD : exportation des données des donateurs et effacement permanent via les outils de confidentialité WordPress.
- Chaque tentative d'abonnement et chaque erreur sont enregistrées dans le journal d'activité Charitable pour faciliter le dépannage.
Pourquoi utiliser Brevo ?
Chaque don est une chance de construire une relation durable, mais cela n'arrive que si vous pouvez rester en contact. Brevo est l'une des plateformes de marketing par e-mail et de CRM les plus populaires, en particulier pour les organisations à but non lucratif en Europe. Avec cette intégration, les donateurs qui s'inscrivent affluent directement dans votre audience Brevo au moment où ils donnent, vous permettant ainsi d'envoyer des séquences de remerciement, des mises à jour de campagne et des appels aux dons sans exporter ni importer un seul CSV.
Voyez-le en action
Exigences
- Charitable Pro avec l'extension Newsletter Connect, version 2.4.0 ou ultérieure
- Un compte Brevo
- Une clé API v3 de Brevo (pas la clé SMTP)
Démarrage
Trouver votre clé API Brevo
- Connectez-vous à votre compte Brevo.
- Allez dans SMTP & API, puis ouvrez l'onglet API Keys.
- Copiez votre clé API v3. C'est la clé qui commence par
xkeysib-. N'utilisez pas la clé SMTP.
Si votre compte Brevo a la fonctionnalité de sécurité Adresses IP autorisées activée, ajoutez l'IP du serveur de votre site web à la liste d'autorisation dans Brevo sous Sécurité > IP autorisées. Sinon, Brevo rejettera les appels API de votre site avec une erreur 401.
Connecter Brevo dans Charitable
- Dans votre administration WordPress, allez dans Charitable > Paramètres > Marketing > Newsletters.
- Trouvez Brevo dans la liste des fournisseurs et cliquez sur Configurer.
- Collez votre clé API v3 dans le champ Clé API et cliquez sur Enregistrer les modifications.
- Lorsque la clé est acceptée, vos attributs de contact Brevo apparaissent dans le tableau Champs d’abonné.
Utilisation
Mapper vos champs d’abonné
Le tableau Champs d’abonné liste les attributs disponibles dans votre compte Brevo. Pour chacun, choisissez le champ de don caritatif qui doit le remplir. Par défaut, Caritatif mappe :
- Email à l’adresse e-mail du donateur
- FIRSTNAME au prénom du donateur
- LASTNAME au nom de famille du donateur
Laissez tout attribut défini sur le tiret ( – ) si vous ne souhaitez pas y envoyer de valeur.
Attributs de numéro de téléphone : Brevo exige que les attributs SMS, WhatsApp et ligne fixe soient au format de téléphone international, par exemple
+14155550123. Brevo rejette le contact entier si un numéro de téléphone n’est pas valide, alors laissez ces champs non mappés à moins que votre formulaire de don ne collecte les numéros de téléphone dans ce format.
Choisir une liste
Sur l’écran principal des paramètres Newsletters, utilisez Liste par défaut pour choisir la liste Brevo que les donateurs rejoignent par défaut. Vous pouvez remplacer cela sur une base de campagne dans les paramètres de newsletter de la campagne.
Choisir comment les donateurs s’abonnent
Utilisez Mode d’abonnement par défaut pour contrôler l’abonnement à la newsletter sur vos formulaires de don :
- Case à cocher d’abonnement, non cochée par défaut : le donateur doit cocher la case pour s’abonner.
- Case à cocher d’abonnement, cochée par défaut : la case est pré-cochée ; le donateur peut la décocher.
- Abonnement automatique : chaque donateur est inscrit, sans case à cocher affichée.
Vous pouvez également personnaliser l’étiquette de la case à cocher avec Étiquette d’abonnement par défaut.
Activer le double abonnement (facultatif)
Activez le Double abonnement pour que Brevo envoie un e-mail de confirmation avant qu’un donateur ne soit ajouté à votre liste. Le donateur n’est abonné qu’après avoir cliqué sur le lien de confirmation. Lorsque le double abonnement est activé, choisissez le modèle de double abonnement Brevo et entrez une URL de redirection de confirmation (où le donateur atterrit après confirmation).
Pour utiliser ceci, créez d’abord un modèle de double abonnement dans Brevo. Si Caritatif ne trouve aucun modèle dans votre compte, le champ modèle devient une zone de texte où vous pouvez entrer l’ID numérique du modèle.
Options de configuration
Connexion
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| Clé API | texte | vide | Votre clé Brevo API v3, depuis Brevo > SMTP & API > Clés API. |
Champs d’abonné
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| Mappage des champs | sélectionner (par attribut) | Email, FIRSTNAME, LASTNAME pré-mappés | Mappe chaque attribut de contact Brevo à un champ de don caritatif. |
Double abonnement
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| Double abonnement | case à cocher | désactivé | Envoie un e-mail de confirmation Brevo avant de s'abonner au donateur. |
| Modèle de double confirmation | sélectionner ou texte | vide | Le modèle Brevo utilisé pour l'e-mail de confirmation. Se rabat sur un champ d'ID de modèle numérique si aucun modèle n'est trouvé. |
| URL de redirection de confirmation | texte | vide | Où le donateur est envoyé après avoir confirmé son abonnement. |
Comportement des newsletters (écran Newsletters)
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| Liste par défaut | sélectionner | Choisir une liste | La liste Brevo que les donateurs rejoignent par défaut dans toutes les campagnes. |
| Mode d'opt-in par défaut | sélectionner | Case à cocher d'opt-in, non cochée | Comment l'opt-in apparaît sur les formulaires de don. |
| Libellé d'opt-in par défaut | texte | Abonnez-vous à notre newsletter | Le libellé affiché à côté de la case à cocher d'opt-in. |
RGPD et Confidentialité
L'intégration de Brevo prend en charge les outils de données personnelles de WordPress sous Outils > Exporter les données personnelles et Outils > Effacer les données personnelles :
- Exporter renvoie les attributs de contact Brevo du donateur.
- Effacer supprime définitivement le contact du donateur de Brevo (une suppression définitive, pas seulement un désabonnement).
Surveillance et dépannage
Chaque tentative d'abonnement est enregistrée dans le journal d'activité Charitable sous Charitable > Outils > Journaux. Filtrez par la source Brevo pour voir les succès et les erreurs, y compris le message exact renvoyé par Brevo.
La clé API n'est pas acceptée (erreur 401)
Vérifiez que vous avez utilisé la clé API v3 (commence par xkeysib-), pas la clé SMTP. Si votre compte Brevo restreint l'accès API par IP, ajoutez l'IP du serveur de votre site à la liste blanche des IP autorisées dans Brevo. L'entrée du journal affichera le message exact de Brevo, y compris une note « adresse IP non reconnue » lorsque l'IP est la cause.
Un donateur n'a pas été abonné
Vérifiez Charitable > Outils > Journaux filtrés par Brevo. Une cause fréquente est un numéro de téléphone qui n'est pas au format international envoyé à l'attribut SMS, WhatsApp ou ligne fixe, ce qui fait que Brevo rejette tout le contact. Démappez ces attributs, ou assurez-vous que votre formulaire collecte les numéros de téléphone au format +pays.
Les e-mails de double confirmation n'arrivent pas
Confirmez que le double opt-in est activé, qu'un modèle Brevo valide et une URL de redirection de confirmation sont définis, et que le modèle existe et est actif dans votre compte Brevo. N'oubliez pas qu'un donateur qui ne clique jamais sur le lien de confirmation n'est jamais ajouté à la liste, ce qui est le comportement prévu.
Les listes sont obsolètes
Charitable met en cache vos listes Brevo. Utilisez le bouton Synchroniser les listes à côté de Brevo sur l'écran Newsletters pour les actualiser.
Ressources pour les développeurs
Filtres
charitable_newsletter_connect_brevo_subscriber_data— Filtrez les données envoyées à Brevo lors de l'abonnement d'un donateur. Reçoit le tableau de charge utile, les données utilisateur et l'ID de la liste.charitable_newsletter_connect_brevo_export_custom_field— Filtrez si un attribut Brevo donné est inclus dans une exportation de données personnelles RGPD.charitable_settings_fields_providers_provider_brevo— Filtrer les champs de configuration Brevo.charitable_newsletter_connect_providers— Enregistrer ou modifier les fournisseurs de newsletter disponibles.charitable_newsletter_connect_log_success— Retourner false pour supprimer les entrées de journal de succès par don tout en continuant à journaliser les erreurs.
Constantes
CHARITABLE_DEBUG_NEWSLETTER— Définir sur true pour écrire des détails détaillés des requêtes et des réponses dans le journal Charitable. La clé API n'est jamais enregistrée. Utilisez ceci uniquement pour le débogage contrôlé, car les entrées de débogage peuvent inclure des données de réponse Brevo.
