Ce guide explique comment configurer Discourse pour créer de nouveaux sujets ou des messages de groupe à partir des e-mails entrants. Il couvre les paramètres du site, la configuration des groupes et les paramètres des catégories.
Niveau d’utilisateur requis : Administrateur
Configurer les e-mails entrants pour créer de nouveaux sujets ou des messages de groupe
Discourse vous permet d’envoyer des e-mails à une adresse spéciale pour créer automatiquement de nouveaux sujets dans une catégorie ou de nouveaux messages de groupe. Cette fonctionnalité est utile pour intégrer Discourse avec des listes de diffusion externes, des systèmes de tickets de support, ou simplement pour permettre aux utilisateurs sans compte de publier via e-mail.
Résumé
Ce guide couvre les points suivants :
- Activation des paramètres de site principaux pour les e-mails entrants
- Configuration des e-mails entrants pour des groupes spécifiques
- Configuration des e-mails entrants pour des catégories spécifiques
- Comportement des e-mails transférés
- Considérations spéciales pour les sites Discourse Hosted
Activer les paramètres de site pour les e-mails entrants
Avant de pouvoir créer des sujets ou des messages de groupe via e-mail, vous devez activer la fonctionnalité principale des e-mails entrants au niveau du site.
- Accédez au panneau d’administration de votre site
- Dans la barre latérale gauche, cliquez sur E-mail puis Paramètres
- Recherchez chaque paramètre à l’aide du champ de filtre et configurez-les selon vos besoins
Vous pouvez également naviguer directement vers /admin/config/email pour accéder à ces paramètres.
email_in
C’est l’interrupteur principal pour la fonctionnalité des e-mails entrants.
- Libellé :
Enable email in - Description : Permet de créer des sujets et des messages de groupe via e-mail.
- Par défaut : Désactivé
Vous devez activer ce paramètre avant que toute autre configuration des e-mails entrants ne fonctionne.
email_in_allowed_groups
Ce paramètre restreint les utilisateurs autorisés à créer des sujets ou des messages de groupe via e-mail.
- Libellé :
Email in allowed groups - Description : Seuls les utilisateurs de ces groupes peuvent créer des sujets ou des messages de groupe via e-mail. Laissez vide pour autoriser tous les utilisateurs.
- Par défaut : Vide (tous les utilisateurs autorisés)
Pour restreindre les e-mails entrants à des groupes spécifiques (par exemple, staff, moderators), entrez les noms des groupes séparés par des virgules.
enable_staged_users
Ce paramètre contrôle si les utilisateurs qui créent des sujets via e-mail sont automatiquement mis en attente (nécessitent une approbation).
- Libellé :
Enable staged users - Description : Lorsqu’il est activé, les utilisateurs qui créent des sujets via e-mail seront mis en attente et nécessiteront une approbation avant de pouvoir publier.
- Par défaut : Activé
Si vous désactivez ce paramètre, les utilisateurs qui créent des sujets via e-mail pourront publier immédiatement sans approbation.
Pour les sites Discourse hébergés, le paramètre
enable_staged_usersest désactivé et masqué pendant la période d’essai pour prévenir les abus. Une fois un abonnement démarré, le paramètre est démasqué. Pour demander son activation pendant votre période d’essai, contactez team@discourse.org.
Les utilisateurs en attente sont des comptes placeholders spéciaux créés automatiquement lorsqu’un e-mail arrive de la part de quelqu’un sans compte Discourse. Ils ont une fonctionnalité limitée :
- Le nom d’utilisateur et le nom d’affichage sont attribués automatiquement
- Ne peuvent pas être mentionnés ou trouvés dans la recherche d’utilisateurs
- Ne reçoivent pas de résumés d’e-mails ou d’e-mails de réinitialisation de mot de passe
- Suivent automatiquement les sujets auxquels ils participent et peuvent répondre via e-mail
- Peuvent revendiquer le compte en s’inscrivant avec la même adresse e-mail, le convertissant en un compte normal
Configurer les e-mails entrants pour un groupe
Vous pouvez configurer un groupe pour accepter les e-mails entrants qui créent de nouveaux messages de groupe. Cela est utile pour créer une boîte de réception de groupe accessible par e-mail.
email_inest activé et que vous êtes connecté en tant qu’administrateur.
- Accédez à la page des groupes (par exemple,
/g) - Cliquez sur le nom du groupe que vous souhaitez configurer
- Cliquez sur Gérer pour accéder à la page de gestion du groupe
- Cliquez sur l’onglet Interaction
- Faites défiler jusqu’à la section E-mail entrant
- Entrez l’adresse e-mail entrante personnalisée dans le champ Adresse e-mail entrante personnalisée
- Cochez la case Accepter les e-mails des utilisateurs anonymes sans compte si vous souhaitez autoriser les utilisateurs sans compte à envoyer des e-mails à ce groupe
- Cliquez sur Enregistrer pour appliquer les modifications
|. Par exemple,groupe1@exemple.com|groupe2@exemple.com.
Visibilité du champ e-mail du groupe
Le champ E-mail entrant n’apparaît que si :
- Le paramètre de site
email_inest activé - Vous êtes connecté en tant qu’administrateur
- Le groupe n’est pas un groupe automatique (système)
Si le champ n’apparaît pas, vérifiez que le paramètre de site email_in est activé et que vous êtes connecté en tant qu’administrateur.
Configurer les e-mails entrants pour une catégorie
Vous pouvez configurer une catégorie pour accepter les e-mails entrants qui créent de nouveaux sujets. Cela est utile pour créer une catégorie accessible par e-mail.
- Accédez à la page de la catégorie (par exemple,
/c/<category_slug>) - Cliquez sur l’icône de clé à molette
pour modifier la catégorie - Sur la page Modifier la catégorie, cliquez sur le bascule Afficher les paramètres avancés en haut à droite de l’en-tête de la page
- Cliquez sur l’onglet Paramètres
- Faites défiler jusqu’à la section E-mail
- Entrez l’adresse e-mail entrante personnalisée dans le champ Adresse e-mail entrante personnalisée
- Cochez la case Accepter les e-mails des utilisateurs anonymes sans compte si vous souhaitez autoriser les utilisateurs sans compte à envoyer des e-mails à cette catégorie
- Cochez la case La catégorie fait miroir une liste de diffusion si la catégorie est connectée à une liste de diffusion externe et que tous les messages proviennent de l’e-mail
- Cliquez sur Enregistrer dans la bannière en bas de la page pour appliquer les modifications
|. Par exemple,categorie1@exemple.com|categorie2@exemple.com.
Adresse e-mail entrante personnalisée
Entrez l’adresse e-mail entrante personnalisée qui sera utilisée pour créer de nouveaux sujets dans cette catégorie. Par exemple, support@exemple.com.
Accepter les e-mails des utilisateurs anonymes sans compte
Lorsqu’il est activé, les utilisateurs qui n’ont pas de compte sur votre site Discourse peuvent envoyer des e-mails à cette catégorie pour créer de nouveaux sujets. Ces utilisateurs seront automatiquement créés en tant qu’utilisateurs en attente (si enable_staged_users est activé) ou en tant qu’utilisateurs actifs (si enable_staged_users est désactivé).
La catégorie fait miroir une liste de diffusion
Activez cette option si la catégorie est connectée à une liste de diffusion externe et que tous les messages proviennent de l’e-mail. Lorsqu’elle est activée :
- Les utilisateurs en attente ne recevront pas de notifications web pour les sujets de cette catégorie
- La restriction
email_in_allowed_groupsest contournée pour les messages arrivant via l’adresse de la liste de diffusion
Ce paramètre est utile lorsque vous faites miroir une liste de diffusion externe vers Discourse et que vous souhaitez éviter de notifier les utilisateurs en attente qui n’ont pas encore été approuvés.
Comportement des e-mails transférés
Lorsque les utilisateurs transfèrent des e-mails vers Discourse, le contenu transféré est géré selon le paramètre de site forwarded_emails_behaviour. Ce paramètre contrôle la façon dont les e-mails transférés sont traités et affichés dans Discourse.
Le paramètre forwarded_emails_behaviour a trois options :
- Masquer : Le contenu transféré est masqué du message. Seul le contenu de l’e-mail original est visible.
- Citer : Le contenu transféré est cité en bas du message, de manière similaire à la façon dont les clients de messagerie gèrent les messages transférés.
- Créer des réponses : Une nouvelle réponse est créée pour chaque e-mail transféré, plutôt que de créer un nouveau sujet.
Pour configurer ce paramètre :
- Accédez au panneau d’administration de votre site
- Dans la barre latérale gauche, cliquez sur E-mail puis Paramètres
- Recherchez
forwarded_emails_behaviourà l’aide du champ de filtre - Sélectionnez l’option souhaitée dans le menu déroulant
- Cliquez sur Enregistrer pour appliquer les modifications
forwarded_emails_behaviours’applique à tous les e-mails entrants, qu’ils soient envoyés à un groupe ou à une catégorie.
Instructions spéciales pour les sites Discourse Hosted
Si vous utilisez l’hébergement Discourse, vous devez cocher la case « Accepter les e-mails entrants envoyés à » dans la section « Accepter les e-mails entrants » des paramètres e-mail :
- Accédez au panneau d’administration de votre site
- Dans la barre latérale gauche, cliquez sur E-mail puis Paramètres
- Faites défiler jusqu’à la section « Accepter les e-mails entrants »
- Cochez la case Accepter les e-mails entrants envoyés à
- Cliquez sur Enregistrer pour appliquer les modifications
Les sites Discourse Hosted utilisent un domaine e-mail spécial pour les e-mails entrants ({YOUR_PREFIX}.discoursemail.com). L’un des formats suivants peut être utilisé pour l’adresse e-mail entrante :
{ANYTHING}@{YOUR_PREFIX}.discoursemail.com- où :{ANYTHING}est l’adresse e-mail entrante personnalisée que vous configurez{YOUR_PREFIX}est le préfixe unique attribué à votre site. Il doit correspondre à la première série de caractères suggérés avant le signe+visible sous le paramètreAccept incoming emails sent to
{YOUR_PREFIX}+{ANYTHING}@discoursemail.com
De plus, si vous êtes un client hébergé et souhaitez utiliser une adresse e-mail vraiment unique qui ne correspond à aucun des formats ci-dessus, vous pouvez le faire en configurant l’adresse e-mail via un fournisseur de messagerie tiers et en transférant tous les e-mails reçus à cette adresse vers votre site. Vous devez activer l’option Accept incoming emails sent to et utiliser l’adresse e-mail affichée sous cette option comme adresse de transfert.
