4.14 Emails
Chemin : Administration > Configuration > Emails (/admin/mails.php) Cette page centralise la configuration de l’envoi et de la réception des emails dans Dolibarr™. Elle est divisée en cinq onglets.
Onglet URL Description
E-mails sortants /admin/mails.php Configuration principale du
transport email
Emails sortants (Réinitialisation /admin/mails_passwordreset.php Transport dédié aux emails de
mdp) réinitialisation
Expéditeur des e-mails Liste des profils expéditeurs
/admin/mails_senderprofile_list.php
réutilisables
Modèles des courriels /admin/mails_templates.php Bibliothèque de modèles d’emails
E-mails entrants /admin/mails_ingoing.php Configuration de la réception
(collecteur)
Onglet 1 – E-mails sortants
Interrupteur global : MAIN_DISABLE_ALL_MAILS — bloque tous les envois d’emails. Utile pour les environnements de test.
Méthodes d’envoi disponibles :
Méthode Description
PHP mail function Fonction native PHP — non recommandée en
production
SMTP/SMTPS socket library Connexion SMTP directe
Swift Mailer socket library Bibliothèque Swift Mailer avec support DKIM
Á Avertissement
La méthode PHP mail function est déconseillée en production car elle dépend de la configuration locale du serveur, peut être bloquée par les filtres antispam et ne supporte pas l’authentification SMTP. Dolibarr™ affiche un avertissement si cette méthode est sélectionnée.
Paramètres de transport SMTP :
Paramètre Constante Défaut Méthode d’envoi MAIN_MAIL_SENDMODE mail Serveur SMTP MAIN_MAIL_SMTP_SERVER (valeur php.ini) Port SMTP MAIN_MAIL_SMTP_PORT 25 Type d’authentification MAIN_MAIL_SMTPS_AUTH_TYPE LOGIN (NONE/LOGIN/PLAIN/XOAUTH2) Identifiant SMTP MAIN_MAIL_SMTPS_ID vide Mot de passe SMTP MAIN_MAIL_SMTPS_PW vide Service OAuth (si MAIN_MAIL_SMTPS_OAUTH_SERVICE vide XOAUTH2) Chiffrement TLS (port 465) MAIN_MAIL_EMAIL_TLS Off Chiffrement STARTTLS MAIN_MAIL_EMAIL_STARTTLS Off (port 587) Autoriser les certificats MAIN_MAIL_EMAIL_SMTP_ALLOW_SELF_SIGNED Off autosignés
Ĺ Note
TLS et STARTTLS sont mutuellement exclusifs : activer l’un désactive l’autre automatiquement. DKIM n’est disponible qu’avec la méthode Swift Mailer.
Options DKIM (uniquement avec Swift Mailer) :
Paramètre Constante
Activer DKIM MAIN_MAIL_EMAIL_DKIM_ENABLED
Domaine DKIM MAIN_MAIL_EMAIL_DKIM_DOMAIN
Sélecteur DKIM MAIN_MAIL_EMAIL_DKIM_SELECTOR
Clé privée DKIM (format PEM) MAIN_MAIL_EMAIL_DKIM_PRIVATE_KEY
Autres options :
Paramètre Constante Défaut Rediriger tous les emails MAIN_MAIL_FORCE_SENDTO vide vers une adresse test E-mail de l’expéditeur MAIN_MAIL_EMAIL_FROM robot@domain.com automatique Expéditeur par défaut (user MAIN_MAIL_DEFAULT_FROMTYPE user / company / profil) E-mail pour les retours MAIN_MAIL_ERRORS_TO vide d’erreur (bounces) Copie cachée systématique MAIN_MAIL_AUTOCOPY_TO vide (Bcc)
Ď Astuce
Le bouton TESTER DISPONIBILITÉ SERVEUR teste si le serveur SMTP est joignable (connexion TCP sur le port configuré). Les boutons TESTER ENVOI et TESTER ENVOI HTML permettent d’envoyer un email de test. Un lien en bas de page permet de vérifier les enregistrements DNS SPF et DMARC des domaines utilisés.
Onglet 2 – Emails de réinitialisation du mot de passe
Permet de définir une configuration SMTP distincte utilisée exclusivement pour les emails de réinitialisation de mot de passe. Pratique pour utiliser un serveur transactionnel à haute délivrabilité pour ces emails critiques. Lorsque la méthode est default, Dolibarr™ utilise la configuration de l’onglet principal. Les constantes sont identiques à l’onglet 1 avec le suffixe _PASSWORDRESET (ex. MAIN_MAIL_SENDMODE_PASSWORDRESET, MAIN_MAIL_SMTP_SERVER_PASSWORDRESET…).
Onglet 3 – Expéditeur des e-mails
Gère la liste des profils expéditeurs de la table llx_c_email_senderprofile. Chaque profil est une identité d’envoi réutilisable qui apparaît dans la liste déroulante de l’expéditeur lors de la composition d’un email.
Colonne Description
Libellé Nom du profil (ex. « Service commercial », «
Support »)
Email Adresse email de l’expéditeur
Utilisateur Si renseigné, le profil est privé et réservé à cet
utilisateur
Position Ordre d’affichage dans la liste déroulante
État Actif / Inactif
Chaque profil peut inclure une signature HTML qui sera utilisée à la place de la signature personnelle de l’utilisateur lors de l’envoi avec ce profil.
Onglet 4 – Modèles des courriels
Liste les modèles d’emails définis dans Dolibarr™, utilisés pour pré-remplir le sujet et le corps des emails envoyés depuis les différents modules. Les modèles peuvent utiliser des variables de substitution du type __MAIN_INFO_SOCIETE_NOM__, __REF__, __LASTNAME__… qui sont remplacées dynamiquement au moment de l’envoi.
Colonne Description
Libellé Nom du modèle
Langue Langue du modèle (vide = toutes langues)
Type de modèle Type de document associé (Factures, Propositions…)
Propriétaire Utilisateur propriétaire si modèle privé
Joindre le fichier Indique si le PDF lié doit être joint
automatiquement
Défaut Si activé, ce modèle est présélectionné par défaut
Onglet 5 – E-mails entrants
La réception des emails est gérée par le module Collecteur de courrier électronique. Activez et configurez ce module si vous avez besoin de prendre en charge les messages entrants. Le module Collecteur permet de connecter Dolibarr™ à une boîte IMAP/POP3 et de traiter automatiquement les emails entrants : création de tickets, liaison aux objets existants (commandes, factures…).
Authentification SPF et DKIM
Pour éviter que les emails envoyés par Dolibarr™ soient classés en spam, configurez les protocoles d’authentification. SPF (Sender Policy Framework) Ajoutez un enregistrement TXT dans votre zone DNS. Exemple pour Google Workspace :
v=spf1 include:_spf.google.com ~all
DKIM (DomainKeys Identified Mail)
- Activez la signature DKIM depuis votre service de messagerie (Google Workspace, Microsoft 365…)
- Récupérez l’enregistrement DNS fourni (type TXT, avec sélecteur et clé publique)
- Ajoutez-le dans la zone DNS de votre domaine
La valeur ressemble à : v=DKIM1; k=rsa; p=MIGfM...