---
title: "Configuration"
weight: 20
description: "Paramétrage complet du module DoliSMTP : API, options, repli SMTP, agenda et débogage."
---

# Configuration

La configuration du module est accessible depuis **Accueil > Configuration > Modules > DoliSMTP**. Elle est organisée en six onglets : Paramètres, Signatures, Statistiques, Rebonds, Journaux et À propos.

![Onglets de configuration du module DoliSMTP dans l'administration Dolibarr](screenshots/configuration-onglets.webp)

## Onglet Paramètres

### Configuration de l'API

| Option | Description |
|--------|-------------|
| URL de l'API | Adresse de base de l'API DoliSMTP. La valeur par défaut `https://dolismtp.fr/api` convient dans la majorité des cas. |
| Jeton API | Votre jeton d'authentification DoliSMTP. Ce champ est masqué par sécurité. Laissez-le vide pour conserver le jeton actuel. |
| Activer DoliSMTP | Active le routage de tous les emails sortants via l'API DoliSMTP. |

Après avoir saisi votre jeton, cliquez sur **Tester la connexion** pour vérifier le bon fonctionnement. Le test affiche le type de compte (Standard ou Revendeur), l'abonnement actif et l'utilisation du quota journalier.

### Options générales

| Option | Description |
|--------|-------------|
| Sauvegarder les fichiers EML | Conserve une copie locale de chaque email envoyé au format .eml dans le répertoire `dolismtp/mails/`. |
| Activer la synchronisation cron | Synchronise automatiquement les statuts des emails via une tâche cron exécutée toutes les 5 minutes. |
| Synchronisation automatique des utilisateurs | Crée automatiquement des sous-comptes DoliSMTP pour les utilisateurs Dolibarr. Cette option est visible uniquement pour les comptes revendeurs. |

### Repli SMTP

Le repli SMTP est un mécanisme de secours : si l'API DoliSMTP est momentanément indisponible, le module tente d'envoyer l'email via un serveur SMTP classique.

| Option | Description |
|--------|-------------|
| Activer le repli SMTP | Active le mécanisme de secours SMTP. |
| Serveur SMTP | Adresse du serveur SMTP de secours (par défaut : `mail.dolismtp.fr`). |
| Port SMTP | Port du serveur SMTP (par défaut : `587`). |
| Utilisateur SMTP | Identifiant de connexion au serveur SMTP. |
| Mot de passe SMTP | Mot de passe du serveur SMTP. Laissez vide pour conserver la valeur actuelle. |

### Intégration agenda

DoliSMTP peut créer automatiquement des événements dans l'agenda Dolibarr lors de certaines actions :

| Option | Description |
|--------|-------------|
| Email envoyé | Crée un événement quand un email est envoyé. |
| Email reçu | Crée un événement quand un email est reçu (réponse via webhook). |
| Email délivré | Crée un événement quand un email est délivré au destinataire. |
| Email en rebond | Crée un événement quand un email est en rebond. |
| Email ouvert | Crée un événement quand un email est ouvert par le destinataire. |

### Options de débogage

| Option | Description |
|--------|-------------|
| Activer les journaux API | Enregistre tous les appels API dans la base de données. Ces journaux sont consultables dans l'onglet **Journaux**. |

### Informations du compte

Lorsque le jeton API est configuré, la page affiche les informations de votre compte DoliSMTP :

- Nom et adresse email du compte
- Type de compte (Standard ou Revendeur) et rôles
- Abonnement actif et statut d'essai éventuel
- Quotas : emails par jour, volume par jour, nombre de boîtes mail

## Onglet Signatures

Consultez la page dédiée : [Signatures](/view.php?path=dolismtp/signatures.md).

## Onglet Statistiques

Consultez la page dédiée : [Statistiques](/view.php?path=dolismtp/statistiques.md).

## Onglet Rebonds

Consultez la page dédiée : [Rebonds](/view.php?path=dolismtp/rebonds.md).

## Onglet Journaux

Consultez la page dédiée : [Journaux API](/view.php?path=dolismtp/journaux-api.md).

## Onglet À propos

Affiche les informations techniques du module : version, auteur, licence, site web, description et liste des fonctionnalités.