Skip to main content

Installation

1. Prérequis :

  • Un compte SMTP2GO actif et sa clé API.
  • Le module tiers « multismtp » installé et activé.
  • Compatibilité Dolibarr : de la version 22.0.0 à la version 24.x.x.
  • Compatibilité PHP : de la version 7.4 à la version 8.4.

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. Configuration (CLÉ API SMTP2GO)

Accès : Outils > InfraS > InfraS2Smtp2go > Paramètres.

Le bloc « API SMTP2GO », en haut de la page, contient un seul champ :

  • Clé API SMTP2GO : champ masqué (type mot de passe) dans lequel saisir la clé API v3 de votre compte SMTP2GO. Une icône « œil » permet d'afficher ou de masquer la valeur saisie.

Cliquer sur le bouton « Modifier » pour enregistrer la clé. Tant qu'aucune clé API valide n'est enregistrée, le module affiche le message d'avertissement suivant et masque toutes les sections qui nécessitent un appel à l'API SMTP2GO (utilisateurs SMTP, sous-comptes, statistiques) :

  « Clé API SMTP2GO non renseignée. Saisissez une clé API pour accéder aux fonctions ci-dessous. »

3. Sauvegarde et restauration des paramètres 

Deux boutons, situés au-dessus du tableau de configuration de la clé API, permettent de :

  • Sauvegarder : conserver une copie de l'ensemble des paramètres du module (constantes de configuration) ;
  • Restaurer : réappliquer une sauvegarde précédemment effectuée.

Après une restauration, actualiser la page (touche F5) pour visualiser le résultat.

Remarque : ce mécanisme de sauvegarde/restauration ne concerne que les paramètres du module (par exemple la clé API ou le nombre de jours affichés sur le graphique). Il ne sauvegarde ni les utilisateurs SMTP, ni les sous-comptes, ni les clés API de sous-compte, qui existent uniquement côté SMTP2GO (avec un miroir local en base Dolibarr).

4. 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.