---
title: Gmail
description: Envoyer, lire, rechercher et déplacer des messages Gmail ou
  déclencher des flux de travail à partir d'événements Gmail
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="gmail"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Gmail](https://gmail.com) est le service de messagerie populaire de Google qui fournit une plateforme robuste pour envoyer, recevoir et gérer les communications par e-mail. Avec plus de 1,8 milliard d'utilisateurs actifs dans le monde, Gmail offre une expérience riche en fonctionnalités avec de puissantes capacités de recherche, des outils d'organisation et des options d'intégration.

Avec Gmail, vous pouvez :

- **Envoyer et recevoir des e-mails** : communiquer avec vos contacts via une interface claire et intuitive
- **Organiser vos messages** : utiliser des libellés, des dossiers et des filtres pour garder votre boîte de réception organisée
- **Rechercher efficacement** : trouver rapidement des messages spécifiques grâce à la puissante technologie de recherche de Google
- **Automatiser les flux de travail** : créer des filtres et des règles pour traiter automatiquement les e-mails entrants
- **Accéder de n'importe où** : utiliser Gmail sur tous vos appareils avec une synchronisation du contenu et des paramètres
- **S'intégrer à d'autres services** : se connecter à Google Agenda, Drive et d'autres outils de productivité

Dans Sim, l'intégration Gmail permet à vos agents de gérer entièrement les e-mails de manière programmatique avec des capacités d'automatisation complètes. Cela permet des scénarios d'automatisation puissants tels que l'envoi de notifications, le traitement des messages entrants, l'extraction d'informations des e-mails et la gestion des flux de communication à grande échelle. Vos agents peuvent :

- **Composer et envoyer** : créer des e-mails personnalisés avec pièces jointes et les envoyer aux destinataires
- **Lire et rechercher** : trouver des messages spécifiques en utilisant la syntaxe de requête Gmail et extraire du contenu
- **Organiser intelligemment** : marquer les messages comme lus/non lus, archiver ou désarchiver des e-mails et gérer les libellés
- **Nettoyer la boîte de réception** : supprimer des messages, déplacer des e-mails entre les libellés et maintenir une boîte de réception vide
- **Déclencher des flux de travail** : écouter les nouveaux e-mails en temps réel, permettant des flux de travail réactifs qui répondent aux messages entrants

Cette intégration comble le fossé entre vos flux de travail IA et les communications par e-mail, permettant une interaction transparente avec l'une des plateformes de communication les plus utilisées au monde. Que vous automatisiez les réponses du service client, traitiez des reçus, gériez des abonnements ou coordonniez les communications d'équipe, l'intégration Gmail fournit tous les outils nécessaires pour une automatisation complète des e-mails.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez Gmail dans le flux de travail. Peut envoyer, lire, rechercher et déplacer des e-mails. Peut être utilisé en mode déclencheur pour lancer un flux de travail lorsqu'un nouvel e-mail est reçu.

## Outils

### `gmail_send`

Envoyer des e-mails avec Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `to` | chaîne | Oui | Adresse e-mail du destinataire |
| `subject` | chaîne | Non | Objet de l'e-mail |
| `body` | chaîne | Oui | Contenu du corps de l'e-mail |
| `contentType` | chaîne | Non | Type de contenu pour le corps de l'e-mail \(texte ou html\) |
| `threadId` | chaîne | Non | ID de conversation pour répondre \(pour le fil de discussion\) |
| `replyToMessageId` | chaîne | Non | ID de message Gmail pour répondre - utilisez le champ "id" des résultats de lecture Gmail \(pas le "messageId" RFC\) |
| `cc` | chaîne | Non | Destinataires en copie \(séparés par des virgules\) |
| `bcc` | chaîne | Non | Destinataires en copie cachée \(séparés par des virgules\) |
| `attachments` | file[] | Non | Fichiers à joindre à l'e-mail |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | chaîne | Message de succès |
| `metadata` | objet | Métadonnées de l'e-mail |

### `gmail_draft`

Créer des brouillons d'e-mails avec Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `to` | chaîne | Oui | Adresse e-mail du destinataire |
| `subject` | chaîne | Non | Objet de l'e-mail |
| `body` | chaîne | Oui | Contenu du corps de l'e-mail |
| `contentType` | chaîne | Non | Type de contenu pour le corps de l'e-mail \(texte ou html\) |
| `threadId` | chaîne | Non | ID de conversation pour répondre \(pour le fil de discussion\) |
| `replyToMessageId` | chaîne | Non | ID de message Gmail pour répondre - utilisez le champ "id" des résultats de lecture Gmail \(pas le "messageId" RFC\) |
| `cc` | chaîne | Non | Destinataires en copie \(séparés par des virgules\) |
| `bcc` | chaîne | Non | Destinataires en copie cachée \(séparés par des virgules\) |
| `attachments` | file[] | Non | Fichiers à joindre au brouillon d'e-mail |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | chaîne | Message de succès |
| `metadata` | objet | Métadonnées du brouillon |

### `gmail_read`

Lire des e-mails depuis Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `messageId` | chaîne | Non | ID du message à lire |
| `folder` | chaîne | Non | Dossier/libellé depuis lequel lire les e-mails |
| `unreadOnly` | booléen | Non | Récupérer uniquement les messages non lus |
| `maxResults` | nombre | Non | Nombre maximum de messages à récupérer \(par défaut : 1, max : 10\) |
| `includeAttachments` | booléen | Non | Télécharger et inclure les pièces jointes des e-mails |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | chaîne | Contenu textuel de l'e-mail |
| `metadata` | json | Métadonnées de l'e-mail |
| `attachments` | file[] | Pièces jointes de l'e-mail |

### `gmail_search`

Rechercher des e-mails dans Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `query` | chaîne | Oui | Requête de recherche pour les e-mails |
| `maxResults` | nombre | Non | Nombre maximum de résultats à retourner |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | chaîne | Résumé des résultats de recherche |
| `metadata` | objet | Métadonnées de recherche |

### `gmail_move`

Déplacer des e-mails entre les libellés/dossiers Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | chaîne | Oui | ID du message à déplacer |
| `addLabelIds` | chaîne | Oui | IDs de libellés à ajouter, séparés par des virgules (ex. INBOX, Label_123) |
| `removeLabelIds` | chaîne | Non | IDs de libellés à supprimer, séparés par des virgules (ex. INBOX, SPAM) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | chaîne | Message de succès |
| `metadata` | objet | Métadonnées de l'e-mail |

### `gmail_mark_read`

Marquer un message Gmail comme lu

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | chaîne | Oui | ID du message à marquer comme lu |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_mark_unread`

Marquer un message Gmail comme non lu

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message à marquer comme non lu |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_archive`

Archiver un message Gmail (retirer de la boîte de réception)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message à archiver |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_unarchive`

Désarchiver un message Gmail (remettre dans la boîte de réception)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message à désarchiver |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_delete`

Supprimer un message Gmail (déplacer vers la corbeille)

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message à supprimer |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_add_label`

Ajouter des étiquettes à un message Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message auquel ajouter des étiquettes |
| `labelIds` | string | Oui | IDs d'étiquettes séparés par des virgules à ajouter \(ex., INBOX, Label_123\) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `content` | string | Message de succès |
| `metadata` | object | Métadonnées de l'e-mail |

### `gmail_remove_label`

Supprimer des étiquettes d'un message Gmail

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `messageId` | string | Oui | ID du message duquel supprimer des étiquettes |
| `labelIds` | string | Oui | IDs d'étiquettes séparés par des virgules à supprimer \(ex., INBOX, Label_123\) |

#### Sortie
