---
title: "Filtrer automatiquement le courrier entrant"
weight: 88
description: "Créer des filtres qui rangent, étiquettent, rattachent ou suppriment les mails à leur arrivée, avec un test à blanc avant de les armer."
---

# Filtrer automatiquement le courrier entrant

Un filtre examine chaque message qui arrive et, s'il correspond aux conditions que vous avez posées, exécute les actions que vous avez choisies : ranger dans un dossier, archiver, étiqueter, rattacher à un tiers, créer un ticket, répondre, supprimer.

Exemples courants :

- tout message dont le sujet contient "attestation de" part à la corbeille ;
- tout message dont le sujet contient "demande de mot de passe" est archivé ;
- tout message venant de `@grosclient.fr` est rattaché au tiers Gros Client et reçoit l'étiquette "Client stratégique" ;
- tout message arrivant sur `support@` avec un expéditeur déjà connu devient un ticket.

## Deux endroits selon qui décide

| Écran | Qui y accède | Portée |
|-------|--------------|--------|
| **Configuration du module > Filtres** | administrateur | une boîte précise, ou toutes |
| **Mes préférences > Mes filtres** | tout utilisateur ayant une boîte personnelle, et tout administrateur | ses propres boîtes ; pour un administrateur, aussi les filtres globaux |

Un filtre personnel ne peut viser qu'une boîte dont vous êtes propriétaire. C'est volontaire : archiver ou supprimer dans une boîte partagée ferait disparaître du courrier pour vos collègues.

### Administrateur : tout gérer depuis "Mes filtres"

Si vous êtes administrateur, l'écran **Mes filtres** affiche, sous vos filtres personnels, un second bloc **Filtres globaux** : le même tableau que dans la configuration du module, avec un bouton **Nouveau filtre global**.

Créer, modifier, activer ou désactiver, changer la priorité, cloner ou supprimer un filtre global se fait depuis ce bloc. Le formulaire est celui de la configuration du module, et une fois l'action terminée vous revenez sur **Mes filtres**. Inutile donc de passer par la configuration pour ajuster un filtre.

Ce bloc s'affiche même si vous n'avez pas de boîte personnelle. Un utilisateur qui n'est pas administrateur ne le voit jamais.

## Créer un filtre

1. Ouvrez l'écran des filtres et choisissez **Nouveau filtre**.
2. Donnez-lui un **nom** parlant : c'est ce qui apparaît dans les journaux quand il se déclenche.
3. Choisissez la **boîte mail concernée**, ou laissez "Toutes les boîtes".
4. Réglez la **priorité**. Les filtres s'appliquent du plus petit nombre au plus grand.
5. Ajoutez les **conditions**, puis les **actions**.
6. **Testez à blanc** (voir plus bas) avant d'enregistrer.

### Les conditions

Chaque condition compare un élément du message à une valeur. Vous pouvez exiger que **toutes** les conditions soient remplies, ou **au moins une**.

Éléments examinables : sujet, expéditeur (nom et adresse, adresse seule, nom seul, domaine), destinataire, copie, destinataire ou copie, corps du message, en-têtes complets, un en-tête précis (`X-Spam-Flag`, `List-Id`...), nom d'une pièce jointe, dossier d'arrivée, nom de la boîte, nombre de pièces jointes, taille du message, présence d'une pièce jointe, expéditeur déjà connu comme tiers, message déjà rattaché à un tiers, message qui est une réponse.

Comparaisons disponibles : contient, ne contient pas, contient l'un de, ne contient aucun de, est exactement, n'est pas, fait partie de, ne fait pas partie de, commence par, finit par, correspond à une expression régulière, est vide, n'est pas vide, et les comparaisons numériques pour la taille et le nombre de pièces jointes.

**La casse et les accents sont ignorés par défaut.** Un filtre écrit "attestation de" attrape "Attestation de" comme "ATTESTATION DÉ". Cochez "Respecter la casse" si vous voulez une comparaison stricte.

Les comparaisons "contient l'un de" et "fait partie de" acceptent **une valeur par ligne**, ce qui évite de multiplier les filtres quasi identiques.

### Les actions

| Famille | Actions |
|---------|---------|
| Rangement | déplacer vers un dossier, archiver, marquer indésirable, supprimer |
| Lecture | marquer lu ou non lu, mettre ou retirer l'étoile, poser ou retirer un marqueur 1 à 8 |
| Étiquettes | ajouter ou retirer une étiquette Capmail |
| Attente | mettre en attente (`2h`, `3d`, `1w`, `1m`, ou `monday` pour lundi prochain 8h) |
| Rattachement | rattacher à un tiers, rattacher à un projet |
| Création | créer un ticket, créer le tiers s'il n'existe pas, créer un projet |
| Communication | répondre avec un modèle, transférer à une adresse, prévenir un utilisateur |
| Divers | marquer privé, ajouter une note interne |

Le tiers, le projet, l'utilisateur à prévenir et le modèle de réponse se choisissent dans une liste. Pour le tiers et le projet, tapez quelques lettres du nom ou de la référence : la liste ne propose que les tiers et les projets ouverts que vous avez le droit de voir.

![Choix du tiers d'un filtre dans une liste avec recherche](screenshots/fonction-filtres-choix-tiers.webp)

**L'ordre de saisie n'a pas d'importance.** L'étiquetage et les rattachements ont toujours lieu avant le rangement, et le rangement avant la suppression : un filtre qui étiquette puis supprime laisse bien sa trace avant d'effacer.

## Dupliquer un filtre

Le bouton **Dupliquer** de la liste crée une copie du filtre et ouvre directement sa fiche. Pratique pour décliner une variante sans tout ressaisir.

La copie est **créée désactivée**, volontairement : deux filtres identiques et actifs traiteraient deux fois le même courrier. Ajustez-la, testez-la à blanc, puis activez-la. Ses compteurs repartent de zéro, pour que son historique reste lisible.

## Testez à blanc avant d'armer

Le bouton **Tester sur les messages récents** compare vos conditions aux 200 derniers messages reçus et affiche ceux qui auraient correspondu. Rien n'est modifié.

Faites-le systématiquement, et particulièrement avant un filtre qui supprime : une condition trop large se voit immédiatement dans cette liste.

## Le mode observation

Un filtre peut être placé en **observation** : il note dans les journaux ce qu'il aurait fait, sans rien modifier, et son compteur de déclenchements avance normalement. C'est la façon prudente de vérifier un filtre sur du courrier réel pendant quelques jours avant de l'armer pour de bon.

## Ce qui arrête un filtre

Par défaut, **le premier filtre qui correspond est le dernier appliqué**. Décochez "Arrêter après ce filtre" si vous voulez qu'un message puisse être traité par plusieurs filtres successifs, par exemple un premier qui étiquette et un second qui range.

## Appliquer des filtres au courrier déjà reçu

Les filtres ne s'appliquent qu'aux messages qui **arrivent**. Trois façons de rattraper l'existant, de la plus ciblée à la plus large :

| Où | Portée |
|----|--------|
| **Depuis la liste des mails** : sélectionnez des messages (par exemple en filtrant sur les non-lus), puis menu "..." de la barre de sélection | les messages sélectionnés, tous filtres confondus |
| **Depuis la fiche d'un filtre** : bouton "Appliquer ce filtre aux messages déjà reçus" | ce filtre seul |
| **Configuration > Avancé** : "Appliquer les filtres au courrier déjà reçu" | tous les filtres, sur une portée et un nombre de messages au choix |

Les deux premières proposent un **test** qui affiche ce qui se passerait sans rien modifier. Utilisez-le d'abord.

Après une application depuis la liste, l'affichage se recharge : les filtres ont pu archiver, déplacer ou supprimer une partie de la sélection, et seule la liste rechargée montre l'état réel.

## Limites à connaître

- **La suppression est irréversible côté Dolibarr.** Le message part dans la corbeille de votre serveur de messagerie, mais sa fiche, son fichier source et ses pièces jointes sont effacés de Dolibarr. Chaque suppression décidée par un filtre est journalisée avec le sujet et l'expéditeur.
- **Les réponses et transferts automatiques ne partent jamais vers une machine.** Capmail refuse d'écrire à un message portant les marques d'un envoi automatique (`Auto-Submitted`, `List-Id`, `Precedence: bulk`), à un retour d'erreur, à une adresse en `noreply` ou à l'un de vos propres domaines. Sans ce garde-fou, deux répondeurs automatiques s'écrivent toute la nuit.
- **Créer un ticket suppose que le message soit déjà rattaché à un tiers.** Placez l'action de rattachement dans le même filtre, ou dans un filtre de priorité plus petite.
- Un filtre **sans condition** ne se déclenche jamais, et l'enregistrement le refuse : ce serait un filtre s'appliquant à tout le courrier.

## Voir aussi

- [Ignorer un mail](/capmail/action-ignorer-mail)
- [Lier un mail à un tiers existant](/capmail/action-lier-tiers)
- [Créer un ticket depuis un mail](/capmail/action-creer-ticket)
- [Configuration avancée](/capmail/admin-advanced)