> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter Outlook à votre application

> Envoyez et lisez des e-mails et gérez des événements d'agenda depuis votre application, avec un compte partagé ou le compte de chaque personne.

Connectez votre application à Outlook pour envoyer et lire des e-mails, gérer des événements d'agenda et lancer des workflows quand un e-mail ou un événement change. Utilisez un compte partagé pour toute votre application, ou laissez chaque personne connecter son propre compte Microsoft.

> [!NOTE]
>
> Vous avez besoin d'un [forfait Builder](https://base44.com/pricing) ou supérieur pour utiliser les connecteurs dans votre application.

***

## Ce que vous pouvez faire

Intégrez votre messagerie et votre agenda Outlook aux workflows de votre application.

> [card] Envoyer des e-mails
>
> Envoyez des e-mails depuis votre compte Outlook quand un événement se produit dans votre application, comme une nouvelle réservation.

> [card] Lire et organiser vos e-mails
>
> Lisez les messages récents, résumez-les, et déplacez-les ou mettez-les à jour depuis votre application.

> [card] Gérer votre agenda
>
> Affichez vos événements Outlook dans votre application, et créez ou mettez à jour des événements quand quelque chose est planifié.

> [card] [Lancer des workflows](https://docs.base44.com/fr/Building-your-app/Creating-workflows.md#connector)
>
> Démarrez un workflow quand un e-mail arrive dans votre boîte de réception ou qu'un événement d'agenda est créé, ou quand l'un ou l'autre est mis à jour ou supprimé.

**Exemples de prompts**

Dans le chat IA, décrivez la boîte aux lettres ou l'agenda, ce qui déclenche l'action et les éventuels champs dynamiques. Par exemple :

```text wrap theme={null}
Envoie des e-mails depuis mon application avec Outlook.
```

```text wrap theme={null}
Affiche les événements de mon agenda Outlook dans le tableau de bord.
```

```text wrap theme={null}
Crée des événements dans l'agenda Outlook quand quelque chose est planifié dans mon application.
```

```text wrap theme={null}
Lis les e-mails récents d'Outlook et résume-les.
```

> [!TIP]
>
> Vous voulez que votre Superagent rejoigne vos réunions Outlook et prenne des notes ? Consultez [Connecter votre agenda](https://docs.base44.com/fr/superagents/meeting-notes.md#connecting-your-calendar).

***

## Connecter Outlook

Choisissez comment les personnes se connectent : un compte partagé pour toute votre application, ou le compte de chaque personne.

> [tab] Connecteur partagé
>
> Connectez un compte, et toutes les personnes qui utilisent votre application partagent ce compte et ses données.
>
> **Pour ajouter un connecteur Outlook partagé :**
>
> 1. Cliquez sur **Connecteurs** dans la barre latérale de votre espace de travail.
>
> 2. Cliquez sur **Ajouter un connecteur**.
>
> 3. Recherchez **Outlook**, puis cliquez dessus.
>
> 4. Sélectionnez **Connecteur partagé**, puis cliquez sur **Suivant**.
>
> 5. Saisissez un **Nom de la connexion**.
>
> 6. Dans **Qui peut accéder**, choisissez où la connexion peut être utilisée : **Apps et Super agent** (par défaut), **Apps uniquement** ou **Super agent only**.
>
> 7. Sous **Autorisations**, choisissez **Lecture seule** (par défaut), **Lecture et écriture** ou **Personnalisé**. Pour envoyer des e-mails, choisissez **Lecture et écriture**. En savoir plus sur les [scopes et permissions](#scopes-and-permissions).
>
>    ![Configuration d'un connecteur Outlook partagé avec Connection name, Who can access et les autorisations Read-only sélectionnées](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-shared-setup.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5638130e25a42638151162b63b297ef3)
>
>    Configurer un connecteur Outlook partagé
>
> 8. Cliquez sur **Ajouter un connecteur**.
>
> 9. Connectez-vous avec le compte Microsoft à partager.

> [tab] Connecteur utilisateur de l'application
>
> Chaque personne connecte son propre compte Microsoft. Votre application peut ainsi travailler avec sa messagerie et son agenda.
>
> > [!TIP]
> >
> > **Avant de commencer :** seuls les propriétaires et administrateurs de l'espace de travail peuvent configurer ce connecteur. Vous avez besoin d'un enregistrement d'application Microsoft, avec son ID client et son secret client. Sauf si vous saisissez un [ID de tenant Microsoft](#using-a-microsoft-tenant), réglez ses **Supported account types** sur les comptes de tout annuaire d'organisation et les comptes Microsoft personnels. Consultez [Utiliser votre propre client OAuth](https://docs.base44.com/fr/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Pour ajouter un connecteur Outlook utilisateur de l'application :**
>
> 1. Cliquez sur **Connecteurs** dans la barre latérale de votre espace de travail.
>
> 2. Cliquez sur **Ajouter un connecteur**.
>
> 3. Recherchez **Outlook**, puis cliquez dessus.
>
> 4. Sélectionnez **Connecteur pour les utilisateurs de l'app**, puis cliquez sur **Suivant**.
>
> 5. Copiez l'**URL de callback**.
>
> 6. Dans l'enregistrement de votre application Microsoft, ajoutez l'URL de callback aux URI de redirection autorisées.
>
> 7. De retour dans le formulaire **Add Outlook Connection**, saisissez un **Nom du connecteur**, un **ID client** et un **Secret client**.
>
>    ![Formulaire Add Outlook Connection avec Callback URL, Connector name, Client ID et Client Secret](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-credentials.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=5fb6f375d00995fabb114eb4e9dd463c)
>
>    Saisir les identifiants de votre application Microsoft
>
> 8. (Facultatif) Vérifiez les scopes présélectionnés sous **Scopes** et retirez ceux dont votre application n'a pas besoin.
>
>    ![Champ Scopes d'Outlook avec les scopes verrouillés et par défaut, et Additional scopes en dessous](https://mintcdn.com/base44/dnY2McSyQ8BRavEs/images/apps-connectors-outlook-app-user-scopes.png?fit=max\&auto=format\&n=dnY2McSyQ8BRavEs\&q=85\&s=2d9c8f72c63f63496b4f8f45aae8daf4)
>
>    Choisir les scopes d'un connecteur utilisateur de l'application
>
> 9. Cliquez sur **Ajouter un connecteur**.
>
> Demandez ensuite au chat IA de votre application d'ajouter un moyen pour chaque personne de connecter son propre compte Outlook.

***

## Scopes et permissions

Les scopes déterminent ce que votre application peut faire dans Outlook. Vous les choisissez quand vous configurez un connecteur.

> [card]
>
> **1. Ajoutés par Base44**
>
> Ces scopes sont toujours inclus. Ils apparaissent donc comme scopes verrouillés sous **Personnalisé** pour un connecteur partagé, ou sous **Scopes** pour un connecteur utilisateur de l'application.
>
> * `User.Read` : se connecter et lire le profil du compte qui se connecte
> * `offline_access` : garder la connexion active sans se reconnecter
>
> **2. Configurés par vous**
>
> Sélectionnez les scopes dont votre application a besoin sous **Personnalisé** pour un connecteur partagé, ou sous **Scopes** pour un connecteur utilisateur de l'application.
>
> Pour un connecteur partagé, **Lecture seule** donne à votre application `Mail.Read` et `Calendars.Read`. **Lecture et écriture** lui donne `Mail.ReadWrite`, `Calendars.ReadWrite` et `Mail.Send`.
>
> * `Mail.Read` : lire les e-mails
> * `Mail.ReadWrite` : lire, créer, mettre à jour et supprimer des e-mails, sans les envoyer
> * `Mail.Send` : envoyer des e-mails au nom du compte
> * `Calendars.Read` : lire les événements d'agenda
> * `Calendars.ReadWrite` : lire, créer, mettre à jour et supprimer des événements d'agenda
>
> **Accès :** votre application travaille avec la boîte aux lettres et l'agenda du compte Microsoft qui autorise la connexion.

### Utiliser un tenant Microsoft

Pour un connecteur utilisateur de l'application, vous pouvez saisir un **Microsoft Tenant ID** dans le formulaire de configuration, sous Connection Configuration. Laissez-le vide pour utiliser `common`. Si vous en saisissez un, le paramètre des types de comptes pris en charge de votre enregistrement d'application Microsoft ne s'applique pas.

***

## Utiliser les fonctions backend

Une fois Outlook connecté, vos fonctions backend peuvent récupérer un jeton d'accès et appeler directement l'API Microsoft Graph. Base44 gère la connexion et maintient le jeton à jour pour vous.

* Pour une connexion partagée, utilisez `getConnection()` pour récupérer le jeton.
* Pour une connexion utilisateur de l'application, utilisez `getCurrentAppUserConnection()` pour que chaque requête utilise le jeton de la personne connectée.

Appelez l'API Microsoft Graph sur `graph.microsoft.com` et passez le jeton dans l'en-tête `Authorization` :

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("outlook");

const response = await fetch(
  "https://graph.microsoft.com/v1.0/me/messages?$top=10",
  { headers: { Authorization: `Bearer ${accessToken}` } },
);
const { value: messages } = await response.json();
```

> [card] [Connecteurs partagés](https://docs.base44.com/fr/developers/backend/resources/connectors/shared-connectors.md)
>
> Configurez, déployez et appelez une connexion partagée depuis une fonction backend.

> [card] [Connecteurs utilisateur de l'application](https://docs.base44.com/fr/developers/backend/resources/connectors/app-user-connectors.md)
>
> Récupérez un jeton par utilisateur et appelez l'API en tant que personne connectée.

***

## Dépannage

Vérifiez la connexion et ses scopes si Outlook cesse de fonctionner dans votre application.

> [accordion] La connexion doit être reconnectée
>
> Si l'accès Outlook est perdu ou expire, la connexion affiche **Cette connexion doit être reconnectée**. Pour un connecteur partagé, [reconnectez-le](https://docs.base44.com/fr/Integrations/Connectors.md#managing-your-connectors) et connectez-vous avec le même compte Microsoft. Toutes les applications qui l'utilisent fonctionnent à nouveau. Pour un connecteur utilisateur de l'application, chaque personne reconnecte son propre compte depuis votre application.

> [accordion] Votre application ne peut pas envoyer d'e-mails
>
> Votre application a besoin du scope `Mail.Send` pour envoyer des e-mails. Le scope `Mail.ReadWrite` permet à votre application de lire et modifier des messages, mais pas de les envoyer.
>
> * Pour un connecteur partagé, les autorisations sont définies quand vous ajoutez la connexion. Cliquez sur **Add another connector** sur la page du connecteur Outlook et choisissez **Lecture et écriture** pour la nouvelle connexion.
> * Pour un connecteur utilisateur de l'application, ouvrez-le sur la page du connecteur Outlook, ajoutez `Mail.Send` à ses scopes et cliquez sur **Save Changes**. Les personnes déjà connectées gardent leur accès précédent jusqu'à leur prochaine connexion.

> [!NOTE]
>
> Cette page a été traduite par IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.