# E-mail (IMAP) - Déclencheur de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/email_trigger

Language: fr

Déclenche le workflow à la réception d'un nouveau message dans un dossier IMAP

## Utilisation et spécificités

IMAP reçoit les messages ; SMTP les envoie. Par défaut, le premier poll enregistre le dernier UID et ignore l’historique. markAsRead applique le drapeau \Seen après une exécution réussie.

Type technique : `email_trigger`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : imap](/docs/credentials/imap)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `credentialId` | `string` | `""` | - |
| `folder` | `string` | `"INBOX"` | - |
| `pollInterval` | `string` | `"1m"` | - |
| `markAsRead` | `boolean` | `false` | - |
| `triggerOnFirstPoll` | `boolean` | `false` | - |
| `rules` | `object` | `{}` | - |
| `rules.fromContains` | `string` | `""` | - |
| `rules.subjectContains` | `string` | `""` | - |
| `rules.toContains` | `string` | `""` | - |
| `testPayload` | `string` | `""` | - |
| `pollState` | `object` | - | - |
| `pollState.lastSeenUid` | `number` | - | -; ≥ 0 |
| `lastError` | `string` | - | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `credentialId`<br>Boîte IMAP | Créez un identifiant dans Identifiants → IMAP (hôte, port, utilisateur, mot de passe d'application). |
| `folder`<br>Dossier | Dossier IMAP à surveiller - en général INBOX. |
| `pollInterval`<br>Intervalle de polling | Fréquence à laquelle nodulz vérifie la boîte mail. Exemples : 30s, 1m, 5m ou expression cron. |
| `markAsRead`<br>Marquer comme lu après exécution | Pose le drapeau \Seen sur IMAP après un run réussi. |
| `triggerOnFirstPoll`<br>Déclencher sur les mails déjà présents au 1er poll | Désactivé par défaut : le premier poll enregistre seulement le dernier UID, sans historique. |
| `testPayload`<br>Payload de test (JSON) | Utilisé lors du clic sur Tester le trigger dans l'éditeur. Doit inclure trigger, mailbox et message. |

## Exemples

- La sortie inclut sujet, corps, en-têtes et métadonnées des pièces jointes dans input.message.

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "credentialId": "",
  "folder": "INBOX",
  "pollInterval": "1m",
  "markAsRead": false,
  "triggerOnFirstPoll": false,
  "rules": {},
  "testPayload": ""
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)