# 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 Keatic ERP. 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. Keatic ERP 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, Keatic ERP 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 Keatic ERP, 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 Keatic ERP à 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 Keatic ERP 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...