FAQ

Installation et activation

Le module n'apparaît pas dans la liste des modules Dolibarr

Vérifiez que le dossier dolismtp est bien placé dans htdocs/custom/ et non dans un sous-dossier supplémentaire. La structure correcte est htdocs/custom/dolismtp/core/modules/modDolismtp.class.php.

J'obtiens une erreur lors de l'activation

Vérifiez que votre version de Dolibarr est 18.0 ou supérieure et que PHP 7.4 ou supérieur est installé. Consultez les journaux d'erreur PHP pour plus de détails.

Configuration

Où trouver mon jeton API DoliSMTP ?

Connectez-vous à votre compte sur dolismtp.fr. Le jeton API est disponible dans les paramètres de votre compte.

Le test de connexion échoue

Vérifiez les points suivants :

1. Le jeton API est correctement saisi (pas d'espace avant ou après)
2. L'URL de l'API est correcte (https://dolismtp.fr/api par défaut)
3. Votre serveur peut accéder à Internet (pas de pare-feu bloquant les requêtes HTTPS sortantes)
4. Votre compte DoliSMTP est actif et non suspendu

Les emails ne passent pas par DoliSMTP

Vérifiez que l'option Activer DoliSMTP est cochée dans la page de configuration. Vérifiez également que la tâche cron de synchronisation est active dans Accueil > Configuration > Tâches planifiées.

Emails

Un email reste au statut "En file d'attente"

L'email est en attente de traitement par le serveur DoliSMTP. Si le statut ne change pas après quelques minutes, cliquez sur Actualiser le statut dans la fiche de l'email. Si la synchronisation cron est activée, les statuts sont mis à jour automatiquement toutes les 5 minutes.

Comment savoir si un email a été lu ?

Si le destinataire ouvre l'email, le statut passe à "Ouvert" et le nombre d'ouvertures est affiché dans la chronologie de la fiche email.

Où sont stockés les fichiers EML ?

Les fichiers EML sont stockés dans le répertoire documents/dolismtp/mails/ de votre installation Dolibarr. Vous pouvez les télécharger depuis la fiche de chaque email.

Domaines

La vérification DNS échoue

La propagation DNS peut prendre jusqu'à 48 heures. Vérifiez que les enregistrements sont correctement configurés chez votre hébergeur DNS, puis réessayez. Vous pouvez utiliser un outil externe comme MXToolbox pour vérifier la propagation.

Quels enregistrements DNS sont nécessaires ?

Quatre types d'enregistrements sont nécessaires : MX, SPF, DKIM et DMARC. Les valeurs exactes à configurer sont affichées sur la fiche de chaque domaine dans DoliSMTP.

Rebonds

Quelle est la différence entre un rebond définitif et temporaire ?

Un rebond définitif (hard bounce) signifie que l'adresse n'existe pas ou que le domaine est invalide. Il faut retirer cette adresse de vos contacts. Un rebond temporaire (soft bounce) signifie que la boîte est pleine ou le serveur temporairement indisponible. L'envoi peut être retenté.

Que fait la liste noire ?

Les adresses en liste noire ne reçoivent plus aucun email envoyé via DoliSMTP. Cette mesure protège votre réputation d'expéditeur en évitant les envois répétés vers des adresses invalides.

Performances

La synchronisation cron consomme-t-elle beaucoup de ressources ?

La tâche cron s'exécute toutes les 5 minutes et effectue un appel API léger pour mettre à jour les statuts des emails en attente. L'impact sur les performances de votre serveur est minimal.

Les journaux API occupent-ils beaucoup d'espace ?

Les journaux API peuvent croître rapidement si vous envoyez un volume important d'emails. Pensez à les vider régulièrement via le bouton Vider les journaux dans l'onglet Journaux, ou désactivez les journaux API si vous n'en avez pas besoin pour le débogage.