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™Keatic™. 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™Keatic™ 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™Keatic™ 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™Keatic™, 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™Keatic™ à 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™Keatic™ 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)

1. Activez la signature DKIM depuis votre service de messagerie (Google Workspace, Microsoft 365…)
2. Récupérez l'enregistrement DNS fourni (type TXT, avec sélecteur et clé publique)
3. Ajoutez-le dans la zone DNS de votre domaine

La valeur ressemble à :

v=DKIM1; k=rsa; p=MIGfM...