E-mail et notifications

GCM envoie beaucoup d'e-mails — reçus de dons, PDF de relevés, rappels de présence, réinitialisations de mot de passe, notifications de flux de travail, messages de bienvenue pour les nouveaux membres. Cet article explique comment configurer qui semble envoyer les e-mails, comment ils sont livrés, et ce qu'ils disent.

L'onglet Paramètres → E-mail porte deux cartes : Identité d'expéditeur et Fournisseur d'e-mail. En dessous, la carte Modèles d'e-mail vous permet de surcharger n'importe quel modèle transactionnel par organisation. Les trois sont réservées aux administrateurs.

Identité d'expéditeur

Chaque e-mail sortant a besoin de trois choses : un nom d'expéditeur, un e-mail d'expéditeur et une adresse de réponse.

Nom d'expéditeur

Ce que les destinataires voient dans leur boîte de réception comme nom « De » — généralement le nom de marque de votre église. Gardez-le sous 30 caractères, sinon certains clients tronquent.

E-mail d'expéditeur

L'adresse depuis laquelle les messages partent. Elle doit être sur un domaine que vous pouvez vérifier avec le fournisseur que vous choisissez (voir ci-dessous). Si vous êtes sur le fournisseur Plateforme par défaut, laissez-le vide et nous enverrons depuis une adresse appartenant à GCM avec le nom de votre église dans le libellé De.

Adresse de réponse

Quand un destinataire clique sur Répondre dans sa boîte de réception, la réponse va ici au lieu de l'adresse d'expéditeur. Utile si votre expéditeur est noreply@grace.org mais que vous voulez que les réponses arrivent à office@grace.org. Laissez vide et les réponses retournent à l'e-mail d'expéditeur.

TIP

Définissez Adresse de réponse sur la boîte générale de votre église même si elle duplique l'expéditeur. Les rares personnes qui répondent à une adresse « noreply » sont souvent âgées ou peu à l'aise techniquement, et vous ne voulez pas que leur réponse disparaisse dans un trou noir.

Fournisseur d'e-mail

La liste déroulante des fournisseurs propose trois options. Choisissez-en une — le fournisseur s'applique à l'organisation entière, vous ne pouvez pas mélanger.

Plateforme par défaut

L'infrastructure d'envoi partagée que GCM exploite. Aucune configuration requise, aucune vérification de domaine. Idéal pour les petites organisations qui ne veulent pas gérer la délivrabilité et n'ont pas besoin de leur propre domaine d'origine.

Limitations :

• Plafond strict de 100 e-mails transactionnels par jour en starter, 1 000 en growth, illimité en network+.
• L'adresse De visible est un domaine appartenant à GCM ; seul le nom De est le vôtre.
• Les annonces en masse (plus de 50 destinataires par envoi) nécessitent un fournisseur non-plateforme.

Resend

Connectez votre propre compte Resend en collant une clé d'API. Resend gère la délivrabilité, le traitement des rebonds et la vérification par domaine. Le flux :

1. Inscrivez-vous sur resend.com, vérifiez votre domaine d'envoi (enregistrements DNS qu'ils vous donnent) et créez une clé d'API.
2. Collez la clé dans le champ Clé d'API Resend. L'icône d'œil bascule la visibilité — la clé est masquée par défaut.
3. Sauvegardez. Le prochain e-mail sortant utilise Resend.

Nous ne validons pas la clé à la sauvegarde (Resend n'a pas de point de terminaison « test ping »), donc testez-la en envoyant un vrai e-mail — par exemple en déclenchant un message de bienvenue à vous-même.

SMTP

Pour le mail auto-hébergé ou les fournisseurs sans API (Mailgun, SendGrid, Postmark, votre propre Postfix). Champs :

Champ	Notes
Hôte SMTP	par ex. smtp.sendgrid.net
Port SMTP	587 pour STARTTLS (par défaut), 465 pour TLS implicite, 25 pour non chiffré (à éviter).
Nom d'utilisateur	Le nom d'utilisateur SMTP de votre fournisseur — souvent apikey pour SendGrid, votre e-mail complet pour les styles Gmail.
Mot de passe	Le mot de passe SMTP. Masqué par défaut ; cliquez sur l'œil pour révéler.
Utiliser TLS / SSL	Activez pour 587/465. Laissez activé sauf si vous testez localement.

Les identifiants sont stockés chiffrés dans app_settings sous les clés smtp_*. L'edge function qui envoie le mail (send-email) les lit côté serveur — ils n'apparaissent jamais dans le navigateur après la sauvegarde.

WARNING

SMTP est plus lent que les fournisseurs avec API (une connexion par envoi) et ne passe pas à l'échelle pour les annonces en masse. Si vous envoyez plus de quelques milliers d'e-mails par mois, utilisez Resend ou un fournisseur avec une API.

Modèles d'e-mail

Faites défiler au-delà de la carte du fournisseur jusqu'à Modèles d'e-mail. Cette carte liste chaque modèle transactionnel que GCM envoie — e-mails de bienvenue, réinitialisations de mot de passe, reçus de dons, notifications de relevés, connexions par lien magique, notifications de flux de travail.

Chaque ligne affiche le nom du modèle, un badge de catégorie et indique si votre organisation a surchargé la valeur par défaut. Cliquez sur une ligne pour ouvrir l'éditeur.

Modifier un modèle

L'éditeur comporte :

• Objet — la ligne d'objet de l'e-mail. Prend en charge les variables de fusion.
• Corps — le HTML de l'e-mail. L'éditeur vous permet de basculer entre les modes Aperçu et Code.
• Bascule Activé — désactivez un modèle que vous ne voulez pas envoyer (par exemple désactivez l'auto-bienvenue si vous gérez cela manuellement).
• Surcharge De — optionnelle. Si définie, ce modèle envoie depuis une adresse différente du défaut de l'organisation (utile pour une adresse « billing@ » sur les reçus).
• Surcharge Adresse de réponse — même idée pour les réponses.

Le panneau de droite liste les variables de fusion disponibles pour ce modèle — par exemple {{member_name}}, {{donation_amount}}, {{statement_year}}. Cliquez sur une variable pour la copier ; collez dans l'objet ou le corps.

Cliquez sur Réinitialiser au défaut pour supprimer la surcharge de votre organisation et revenir au modèle par défaut de la plateforme.

Sécurité HTML

Les corps de modèle sont assainis avec DOMPurify avant l'envoi. Vous pouvez utiliser tout HTML que vous voulez, mais les balises <script> et les gestionnaires onclick en ligne sont retirés. C'est pour empêcher un compte administrateur compromis d'empoisonner chaque e-mail que votre organisation envoie.

Notifications (in-app et push)

L'e-mail n'est pas le seul canal de notification. Configurez les autres dans l'onglet Canaux — c'est là que vivent SMS, WhatsApp, push et routage in-app. L'onglet Rappels (couvert dans Rappels) choisit ensuite quels canaux utiliser spécifiquement pour les rappels d'événements.

Ce qui est sauvegardé où

Clé	Où
messaging_sender_name, messaging_sender_email, email_reply_to	app_settings
email_provider	app_settings
resend_api_key	app_settings (chiffré au repos)
smtp_host, smtp_port, smtp_user, smtp_pass, smtp_secure	app_settings (mot de passe chiffré)
Surcharges de modèles	org_email_templates (une ligne par paire organisation-modèle)

Pièges courants

« Mes e-mails vont en spam. » Avec Plateforme par défaut, c'est en grande partie hors de votre contrôle. Avec Resend ou SMTP, vérifiez votre domaine — SPF, DKIM, DMARC. La documentation du fournisseur vous guide pour chacun. Sans DKIM, presque tous les e-mails atterrissent en spam.

« J'ai changé l'e-mail d'expéditeur et maintenant rien ne s'envoie. » Votre nouveau domaine d'expéditeur n'est pas vérifié avec le fournisseur. Retournez sur Resend (ou ailleurs) et ajoutez les enregistrements DNS qu'ils listent. Tant que la vérification n'est pas terminée, le fournisseur rejette les envois depuis ce domaine.

« Les reçus sont partis avec l'ancien modèle. » Les changements de modèle s'appliquent aux envois futurs uniquement. Les reçus déjà envoyés restent tels quels — nous ne re-générons pas les PDF historiques.

Étapes suivantes

• Canaux — SMS, WhatsApp, push, in-app.
• Rappels — choisissez quels canaux envoient les rappels d'événements.
• Bases de l'organisation — l'e-mail de l'organisation sous Identité est l'adresse de réponse de secours.