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 mdp)
/admin/mails_passwordreset.php
Transport dédié aux emails de réinitialisation
Expéditeur des e-mails
/admin/mails_senderprofile_list.php
Liste des profils expéditeurs 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 (NONE/LOGIN/PLAIN/XOAUTH2)
MAIN_MAIL_SMTPS_AUTH_TYPE
LOGIN
Identifiant SMTP
MAIN_MAIL_SMTPS_ID
vide
Mot de passe SMTP
MAIN_MAIL_SMTPS_PW
vide
Service OAuth (si XOAUTH2)
MAIN_MAIL_SMTPS_OAUTH_SERVICE
vide
Chiffrement TLS (port 465)
MAIN_MAIL_EMAIL_TLS
Off
Chiffrement STARTTLS (port 587)
MAIN_MAIL_EMAIL_STARTTLS
Off
Autoriser les certificats autosignés
MAIN_MAIL_EMAIL_SMTP_ALLOW_SELF_SIGNED
Off
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 vers une adresse test
MAIN_MAIL_FORCE_SENDTO
vide
E-mail de l'expéditeur automatique
MAIN_MAIL_EMAIL_FROM
robot@domain.com
Expéditeur par défaut (user / company / profil)
MAIN_MAIL_DEFAULT_FROMTYPE
user
E-mail pour les retours d'erreur (bounces)
MAIN_MAIL_ERRORS_TO
vide
Copie cachée systématique (Bcc)
MAIN_MAIL_AUTOCOPY_TO
vide
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,