> For the complete documentation index, see [llms.txt](https://docs.mrsherlock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mrsherlock.ai/configuration/integrations/email-gmail.md).

# Email (Gmail)

Connectez la boîte Gmail de votre conciergerie : les emails de vos voyageurs arrivent dans la Messagerie unifiée, et vous leur répondez par email.

{% hint style="info" %}
**Fonctionnalité en accès anticipé**, ouverte espace par espace. Elle fonctionne avec la [Messagerie unifiée](https://docs.mrsherlock.ai/messagerie/messagerie-unifiee.md), ouverte en même temps.
{% endhint %}

Beaucoup de voyageurs écrivent par email, hors de la messagerie de la plateforme : pour envoyer une pièce d'identité, une photo, une question avant de réserver de nouveau. En connectant la boîte Gmail de votre conciergerie, ces emails arrivent dans la conversation du voyageur, à côté de ses messages Airbnb ou Booking.com. Sherlock les lit et peut y répondre, et vous répondez par email depuis Mr Sherlock.

La connexion se fait dans **Configuration › Intégrations**, sous-onglet **Email**.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-b3cfad35032aab64459ec2b603442f0a5fc3ce35%2Fintegrations-email-non-connecte-1280.png?alt=media" alt="Configuration › Intégrations, sous-onglet Email : section Boîte mail, carte Gmail OAuth avec le bouton Connecter et l&#x27;encadré qui décrit les emails importés"><figcaption><p>Le sous-onglet Email, avant la connexion</p></figcaption></figure>

### Ce qui est importé, et ce qui ne l'est pas

Mr Sherlock n'importe que les emails liés à vos voyageurs :

* les emails dont l'expéditeur ou le destinataire est un voyageur connu, ou l'adresse d'une réservation : celle de la réservation, ou celle saisie pendant le check-in en ligne ;
* les réponses aux emails envoyés depuis Mr Sherlock, et la suite des fils déjà importés ;
* leurs pièces jointes.

Ne sont **jamais importés ni conservés** :

* tous les autres emails, y compris ceux d'une adresse inconnue hors d'un fil déjà importé : seuls leurs en-têtes sont lus pour les trier, sans être enregistrés ;
* les emails relais d'Airbnb, de Booking.com et des autres plateformes (votre channel manager les reçoit déjà), les newsletters et les envois automatiques.

Mr Sherlock ne supprime ni ne modifie aucun email de votre boîte. Un espace de travail ne connecte qu'**une seule boîte Gmail**.

### Connecter votre boîte Gmail

{% stepper %}
{% step %}

#### Ouvrez le sous-onglet Email

Dans **Configuration › Intégrations**, cliquez sur **Email**, puis sur **Connecter** dans la carte **Gmail**.
{% endstep %}

{% step %}

#### Lisez ce que Mr Sherlock fera de vos emails

La fenêtre **Connecter votre boîte Gmail** récapitule ce qui est importé et ce qui ne l'est jamais. Cliquez sur **Continuer vers Google**.
{% endstep %}

{% step %}

#### Autorisez l'accès chez Google

Google vous demande de choisir le compte Gmail et d'autoriser Mr Sherlock à lire et à envoyer des emails. Cochez toutes les autorisations demandées : sans elles, la connexion échoue.
{% endstep %}

{% step %}

#### Revenez dans Mr Sherlock

De retour dans l'app, le message *« Connexion Gmail réussie »* confirme la connexion. Les emails des **30 derniers jours** sont importés et marqués comme lus, sauf ceux de la dernière heure.
{% endstep %}
{% endstepper %}

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-3933bc98227681034a3d29ec7ac7fa527b08b7ed%2Fzoom-integrations-email-consentement.png?alt=media" alt="Fenêtre Connecter votre boîte Gmail : ce qui est importé dans la messagerie, ce qui n&#x27;est jamais importé ni conservé, la phase de test qui demande de reconnecter le compte tous les 7 jours, boutons Annuler et Continuer vers Google" width="530"><figcaption><p>La fenêtre affichée avant l'autorisation chez Google</p></figcaption></figure>

Si la connexion échoue, un message en donne la raison, par exemple *« Vous avez refusé l'accès à Google. Relancez la connexion pour connecter votre boîte. »* ou *« Une autre boîte Gmail est déjà connectée à cet espace. Supprimez-la avant d'en connecter une nouvelle. »*

### La boîte connectée

La carte affiche l'adresse de la boîte, son statut (**Actif**) et une ligne de suivi, par exemple *« Sync il y a 2min · 214 emails importés depuis le 20 sept. 2026 »*.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-625186aa2988e2f6f83be57435447866cd22d9cc%2Fintegrations-email-connecte-1280.png?alt=media" alt="Carte Gmail connectée : adresse de la boîte, statut Actif, Sync il y a 2min · 214 emails importés depuis le 20 sept. 2026, bandeau Reconnexion à prévoir dans 2 jours avec Reconnecter, boutons pause, synchroniser et supprimer"><figcaption><p>Une boîte Gmail connectée</p></figcaption></figure>

À droite, trois boutons :

* **pause** : suspend l'import et l'envoi des emails sans supprimer la connexion. Le bouton de lecture la réactive ;
* **synchroniser** : lance tout de suite la lecture des nouveaux emails ;
* **supprimer** : retire la boîte (voir plus bas).

Les emails que vous envoyez par Gmail partent de l'adresse de la boîte, sous le nom du compte Gmail.

### Reconnecter la boîte tous les 7 jours

{% hint style="warning" %}
**Phase de test** : tant que Google n'a pas terminé la vérification de l'application, il demande de reconnecter le compte **tous les 7 jours**. Mr Sherlock vous prévient à chaque fois.
{% endhint %}

Quelques jours avant l'échéance, la carte affiche *« Reconnexion à prévoir dans 2 jours »* avec le bouton **Reconnecter**. Un email de rappel vous est aussi envoyé la veille. Cliquez sur **Reconnecter** et refaites l'autorisation chez Google : l'opération prend quelques secondes.

### Si la boîte est déconnectée

Une boîte non reconnectée à temps, ou dont l'accès a été retiré chez Google, est **déconnectée**. Un bandeau l'indique en haut de la Messagerie, avec le bouton **Reconnecter** :

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-86c90caa209154771c518ddffb2b14d7b66b9d8a%2Fzoom-inbox-liste-gmail-deconnecte.png?alt=media" alt="Bandeau de la messagerie : Gmail déconnecté : les emails des voyageurs ne sont plus reçus ni envoyés, avec le bouton Reconnecter" width="530"><figcaption><p>Le bandeau « Gmail déconnecté » de la Messagerie</p></figcaption></figure>

Tant que la boîte est déconnectée :

* les nouveaux emails des voyageurs n'arrivent plus dans Mr Sherlock ;
* les emails à envoyer par Gmail ne partent pas : ils passent en **Non remis** (voir [Échecs d'envoi](https://docs.mrsherlock.ai/messagerie/messagerie-unifiee/echecs-denvoi.md)). Renvoyez-les après la reconnexion, ou par un autre canal.

### Supprimer la boîte

Cliquez sur l'icône **supprimer** de la carte, puis confirmez dans la fenêtre **Supprimer l'intégration ?**. Mr Sherlock n'importe plus les emails de cette adresse et ne peut plus envoyer depuis elle. Les emails déjà importés restent dans les conversations. Les réservations réglées sur Gmail pour leurs emails passent à votre channel manager, et repassent par Gmail si vous reconnectez une boîte.

### Qui peut connecter la boîte ?

Le sous-onglet **Email** est visible des membres qui voient les intégrations de l'espace. Connecter, mettre en pause, reconnecter ou supprimer la boîte demande le droit de gérer les intégrations sur tout l'espace. Voir [Rôles et accès](https://docs.mrsherlock.ai/configuration/membres-et-roles/roles-et-acces.md).

### Et après ?

{% content-ref url="/pages/Tx35VpseQavMHDaMTooH" %}
[Messagerie unifiée : onglets, recherche, filtres](https://docs.mrsherlock.ai/messagerie/messagerie-unifiee.md)
{% endcontent-ref %}

{% content-ref url="/pages/cAwDghVaCxhkNqNIuCyc" %}
[Panneau réservation](https://docs.mrsherlock.ai/messagerie/messagerie-unifiee/panneau-reservation.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mrsherlock.ai/configuration/integrations/email-gmail.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
