INFRAS2SMTP2GO Gestion des E-mails par SMTP2GO 1. PRESENTATION DU MODULE Présentation du module Le module InfraS2Smtp2go permet de piloter, directement depuis Dolibarr, un compte d'envoi d'e-mails transactionnels SMTP2GO par l'intermédiaire de son API, sans avoir besoin d'ouvrir l'interface web de SMTP2GO. Il permet de : Créer, modifier et supprimer des « utilisateurs SMTP » (identifiants d'envoi) sur le compte SMTP2GO principal ou sur ses sous-comptes. Créer, modifier et supprimer des sous-comptes SMTP2GO. Régler pour chaque utilisateur SMTP des options avancées :  suivi des ouvertures et des clics, archivage des e-mails,  limitation d'envoi, authentification à deux facteurs,  notifications SMS,  pied de page de désinscription,  e-mail d'audit,  notifications de rebond. Consulter la consommation du cycle de facturation et un graphique d'activité d'envoi (e-mails envoyés, ouvertures, clics, rebonds). Lien avec Dolibarr : un identifiant SMTP2GO peut être rattaché (de manière facultative) à un utilisateur Dolibarr. Lorsque ce rattachement est fait, le login et le mot de passe SMTP de cet identifiant sont automatiquement synchronisés dans la configuration d'envoi d'e-mails de l'utilisateur Dolibarr concerné (fonctionnalité fournie par le module tiers « multismtp ») : l'utilisateur envoie alors ses e-mails via SMTP2GO sans manipulation supplémentaire de sa part. 2. PRÉREQUIS Installation 1. Prérequis : Un compte SMTP2GO actif et sa clé API. Le module tiers « multismtp » installé et activé. IMPORTANT : Après toute mise à jour de Dolibarr et/ou du module, il est impératif de DÉSACTIVER puis RÉACTIVER le module InfraS2Smtp2go pour que les éventuelles modifications de base de données et de fichiers soient prises en compte. 2. Menus :  Le module ajoute deux taches planifiées (cron), visibles dans Accueil > Outils > Taches planifiées, DÉSACTIVÉES PAR DEFAUT : « Synchronisation des utilisateurs SMTP2GO » : récupère les utilisateurs SMTP du compte principal et de tous les sous-comptes SMTP2GO, et met à jour la table locale (création, mise à jour, suppression des utilisateurs disparus). « Synchronisation des sous-comptes SMTP2GO » : récupère la liste des sous-comptes existants sur le compte principal SMTP2GO et met à jour la table locale (création, mise à jour, suppression des sous-comptes disparus). Un administrateur doit activer ces deux taches manuellement s'il souhaite une synchronisation automatique quotidienne, ou cliquer sur le bouton "Mise à jour des utilisateurs SMTP2GO" ou "Mise à jour des sous-comptes SMTP2GO" dans le paramètre du module. 3. CONFIGURATION DU MODULE Configuration Menu : Outils > InfraS > InfraS2Smtp2go > Paramètres Bloc « API SMTP2GO » Clé API SMTP2GO : clé API v3 du compte SMTP2GO (champ mot de passe, avec icone oeil pour l'afficher/la masquer). Si la clé API n'est pas renseignée, un message s'affiche : « Clé API SMTP2GO non renseignée. Saisissez une clé API pour accéder aux fonctions ci-dessous. » et aucune des fonctionnalités décrites en section 6 et suivantes n'apparait sur la page. Sauvegarde / Restauration des paramètres du module : deux boutons « Sauvegarder » et « Restaurer » permettent de sauvegarder puis de restaurer l'ensemble des paramètres du module. Après une restauration, actualiser la page (touche F5) pour voir le résultat. Bloc « Statistiques d'envoi SMTP2GO » Nombre d'évènements à récupérer pour les statistiques d'envoi (par défaut : 7 jours) : nombre de jours à affichés sur le graphique d'activité quotidienne (voir section 8). Graphique d'activité « Activité des N derniers jours » (N correspondant à l'option 1), avec les courbes : Total d'e-mails envoyés, Ouvertures, Clics, Rebonds. Si le volume d'e-mails est trop important pour être récupéré en totalité, un avertissement s'affiche : « Le volume d'e-mails sur cette période est important : le graphique peut être incomplet au delà de 30 jours. » Cycle de facturation : barre de progression de la consommation globale du compte, avec la date de réinitialisation, ainsi que deux indicateurs : Taux de rebond et Taux de signalement spam. 4. GESTION DES UTILISATEURS SMTP Utilisateurs SMTP Section « Utilisateurs SMTP » de la page Paramètres : « Liste des utilisateurs SMTP existants sur le compte SMTP2GO et création de nouveaux utilisateurs. » Créer un utilisateur SMTP Cliquer sur le bouton « Créer un utilisateur SMTP » pour afficher le formulaire de création. Champs du formulaire : Lier l'utilisateur SMTP à un utilisateur Dolibarr : liste déroulante des utilisateurs Dolibarr. Optionnel : laisser vide pour ne rattacher aucun utilisateur. Login : texte libre, entre 5 et 100 caractères. Mot de passe : champ mot de passe avec icône œil et bouton « Générer ». Obligatoire à la création. Description : texte libre. Limitation d'envoi personnalisée :  Si cochée : afficher « Nombre d'e-mails maximum » et « Période de la limitation » (par heure, par jour, par semaine ou par mois).  Si laissé vide/décoché :l'utilisateur peut envoyer autant d'e-mails que le plan SMTP2GO le permet. Pool d'IP dédiées (ID) : Disponible uniquement pour les forfaits de sous-comptes de plus de 100 000 E-mails. Activer le pied de page de désinscription : si cochée : afficher « Domaine des liens de désinscription », « Pied de page HTML » et « Pied de page texte ». Activer le suivi des ouvertures. Activer le suivi des clics. Activer l'archivage des e-mails. Forcer l'authentification à deux facteurs. Activer les notifications par SMS : si cochée : afficher « Limite d'envoi de SMS par utilisateur SMTP ». E-mail d'audit : adresse mise en copie cachée ("BCC") de tous les envois de cet utilisateur (optionnel). Notifications de rebond : « from » (par défaut, renvoyées à l'expéditeur), « drop » (ignorées), ou une adresse e-mail valide qui les recevra. Modifier un utilisateur SMTP Cliquer sur l'icône crayon de la ligne correspondante. Le formulaire « Modifier l'utilisateur SMTP » s'ouvre, prérempli (y compris le mot de passe actuel). Le login est affiché en lecture seule, les autres champs sont identiques à la création. Pour le mot de passe : laisser le champ vide pour conserver le mot de passe actuel, ou saisir un nouveau mot de passe respectant les règles de robustesse. Cliquer sur « Enregistrer » pour valider. Supprimer un utilisateur SMTP Cliquer sur l'icône poubelle de la ligne correspondante. Une boîte de confirmation s'affiche : « Supprimer l'utilisateur SMTP » / « Voulez-vous vraiment supprimer l'utilisateur SMTP ?  Cette action est irréversible. Synchroniser manuellement les utilisateurs SMTP Cliquer sur le bouton « Mise à jour des utilisateurs SMTP2GO. » pour relancer immédiatement une synchronisation avec SMTP2GO (équivalent manuel de la tâche planifiée). 5. GESTION DES SOUS-COMPTES SMTP2GO Sous-comptes SMTP2GO Section « Sous-comptes SMTP2GO » de la page Paramètres : « Liste des sous-comptes existants sur le compte SMTP2GO et création de nouveaux sous-comptes. » Créer un sous-compte Cliquer sur « Créer un sous-compte ». Champs du formulaire : Nom : nom identifiant le sous-compte sur SMTP2GO (exemple : nom du client ou du projet). E-mail du membre de l'équipe : adresse e-mail d'un membre de l'équipe que l'on souhaite inviter à rejoindre le sous-compte (optionnel). Limite d'envoi d'e-mails par sous-compte : nombre entre 2 000 et 10 000 000 par mois. Si laissé vide : le sous-compte peut envoyer autant d'e-mails que le plan SMTP2GO le permet. Pool d'IP dédiées (ID) : identifiant numérique optionnel. Les adresses IP dédiées ne sont disponibles que pour les forfaits de sous-comptes de 100 000 e-mails ou plus. Activer l'archivage des e-mails (case à cocher). Forcer l'authentification à deux facteurs (case à cocher). Activer les notifications par SMS (case à cocher) : si cochée : afficher « Limite d'envoi de SMS par utilisateur SMTP ». Modifier un sous-compte Cliquer sur l'icône crayon de la ligne correspondante. Le formulaire « Modifier le sous-compte » s'ouvre avec les mêmes champs que la création, à l'exception de l'e-mail du membre de l'équipe (non repris à l'édition). Supprimer un sous-compte Cliquer sur l'icône poubelle de la ligne correspondante. Une boîte de confirmation s'affiche : « Supprimer le sous-compte » / « Voulez-vous vraiment supprimer le sous-compte ?  ATTENTION : Cette action est irréversible et supprimera aussi tous ses utilisateurs SMTP. Supprimer un sous-compte supprime également TOUS les utilisateurs SMTP qui lui sont rattachés. Synchroniser manuellement les sous-comptes Cliquer sur le bouton « Mise à jour des sous-comptes SMTP2GO. » pour relancer immédiatement une synchronisation avec SMTP2GO. 6. FICHE D'UN SOUS-COMPTE Sous-compte Pour ouvrir la fiche d'un sous-compte, cliquer sur son nom dans le tableau « Sous-comptes SMTP2GO ». Titre de la page : « Mon sous-compte :  ». Un lien « Retour à la liste des sous-comptes » permet de revenir en arrière. La fiche affiche : Cycle de facturation : barre de progression de la consommation du sous-compte. Des messages d'alerte apparaissent selon le niveau de consommation : À partir de 75 % : « Votre quota d'envois est proche de la limite : vous avez déjà dépassé X % de votre plan SMTP2GO. » À partir de 95 % : « Votre quota d'envois est critique : vous avez déjà dépassé X % de votre plan SMTP2GO. » Liste des utilisateurs SMTP du sous-compte : même tableau et mêmes actions (créer / éditer / supprimer / synchroniser) que pour le compte principal (voir section 6), mais limitées à ce sous-compte. Le bouton de création est intitulé « Créer un utilisateur pour le sous-compte ». Remarque : lors de la création d'un utilisateur SMTP directement depuis la fiche d'un sous-compte, les champs « Pool d'IP dédiées » et « Pied de page de désinscription » ne sont pas proposés. 7. MOTS DE PASSE : GENERATION ET ROBUSTESSE Mots de passe Sur tout champ mot de passe (création ou édition d'un utilisateur SMTP), un bouton « Générer » permet de générer automatiquement, côté navigateur, un mot de passe aléatoire de 20 caractères respectant les 4 classes de caractères (minuscules, majuscules, chiffres, symboles). Une jauge de robustesse (rouge -> jaune -> vert) s'affiche en temps réel sous le champ : Si le mot de passe est suffisamment robuste : «  / bits estimés - mot de passe suffisamment robuste ». Si le mot de passe est trop faible : «  / bits estimés - trop faible, ajoutez : , et environ caractère(s) de plus ». Le formulaire refuse la validation tant que le mot de passe saisi n'atteint pas le seuil minimum requis. Règles à respecter pour un mot de passe : À la création : le mot de passe est obligatoire (SMTP2GO ne renvoie jamais de mot de passe auto-généré, il ne pourrait donc pas être enregistré localement). À l'édition : laisser le champ vide pour conserver le mot de passe actuel. Dans tous les cas où un mot de passe est saisi : au moins un nombre minimum de classes de caractères différentes (minuscules, majuscules, chiffres, symboles) et une entropie estimée minimale (exprimée en bits) doivent être atteints. Plus le mot de passe est long, plus il est considéré comme robuste.