Développer des compléments Outlook pour le nouveau Outlook sur Windows

2025-07-01

Le nouveau client de bureau Outlook sur Windows unifie les codebases Windows et web pour créer une expérience Outlook plus cohérente pour les utilisateurs et les administrateurs. Son interface moderne et simplifiée a ajouté des fonctionnalités et vise à améliorer la productivité, la organization et la collaboration pour les utilisateurs. Plus important encore, la nouvelle version d’Outlook sur Windows prend en charge les compléments web Outlook, afin que vous puissiez continuer à étendre les fonctionnalités d’Outlook.

Impact sur les compléments VSTO et COM

La nouvelle version d’Outlook sur Windows vise à unifier l’expérience d’extensibilité sur toutes les plateformes Outlook. Pour offrir une expérience de complément plus fiable et stable, les compléments VSTO et COM ne sont pas pris en charge dans le nouvel Outlook sur Windows. Pour vous assurer que votre complément continue de fonctionner dans le nouvel Outlook sur Windows, vous devez migrer votre complément VSTO ou COM vers un complément web Outlook. La migration vers un complément web Outlook permet non seulement la compatibilité avec la nouvelle version d’Outlook sur Windows, mais elle rend également votre solution disponible pour les utilisateurs sur d’autres plateformes, telles qu’Outlook sur Mac, sur mobile ou sur le web.

Pour vous aider à démarrer le processus de migration, passez en revue les conseils suivants.

Les différences dans les fonctionnalités et les scénarios pris en charge par les compléments VSTO et COM et les compléments web Outlook sont traitées. Pour déterminer si votre scénario de complément est entièrement pris en charge dans un complément web Outlook, voir Scénarios pris en charge dans les compléments web Outlook.
Pour obtenir des conseils sur la transition de votre complément VSTO vers un complément web Outlook, consultez guide du développeur de complément VSTO et Tutoriel : Partager du code entre un complément VSTO et un complément Office avec une bibliothèque de code partagée.
Si vous débutez avec les compléments web Outlook, essayez le démarrage rapide Outlook pour créer votre premier complément.
Si vous êtes administrateur informatique et que vous souhaitez en savoir plus sur la transition vers les compléments web Outlook dans votre organization, voir Transition des compléments d’Outlook classique vers le nouvel Outlook pour Windows. Par défaut, lorsqu’un utilisateur bascule vers outlook sur Windows pour la première fois, il peut choisir d’importer ses paramètres Outlook et d’installer des compléments existants à partir d’Outlook classique sur Windows. Étant donné que les compléments COM ne sont pas pris en charge dans le nouveau client, les compléments web équivalents sont installés à la place. Pour plus d’informations, voir Installer des compléments web équivalents de compléments COM existants dans le nouvel Outlook pour Windows.

Remarque

Les compléments VSTO et COM sont toujours pris en charge dans outlook classique sur Windows.

Scénarios pris en charge dans les compléments web Outlook

Le développement de l’API JavaScript Outlook utilisée par les compléments web Outlook vise à combler l’écart dans les scénarios pris en charge uniquement par les solutions de complément VSTO et COM. De cette façon, les utilisateurs qui passent au complément web Outlook peuvent continuer à avoir une expérience transparente.

Le tableau suivant identifie les principaux scénarios Outlook et leur prise en charge status dans un complément web. Cette table sera mise à jour à mesure que d’autres scénarios seront pris en charge. Régulièrement case activée cette section lorsque vous envisagez de migrer votre complément VSTO ou COM.

Conseil

À mesure que nous continuons à mettre à jour le tableau des scénarios pris en charge, si vous souhaitez afficher les modifications récentes apportées, sélectionnez Modifier ce document (icône crayon) dans le coin supérieur droit de l’article, puis sélectionnez Historique.

Pour en savoir plus sur les fonctionnalités des compléments Outlook en préversion, voir Complément Outlook préversion d’API ensemble de conditions requises.

Scénario	Description	Prise en charge des status dans les compléments web Outlook	Fonctionnalités et exemples connexes
Création de rapports et d’éducation sur les courriers indésirables	Permettre aux utilisateurs de signaler des messages non sollicités et potentiellement dangereux et d’apprendre à identifier ces messages.	Pris en charge.	Implémenter un complément de création de rapports de courrier indésirable intégré Point d’extension ReportPhishingCommandSurface Office.context.mailbox.item.getAsFileAsync
Réunions en ligne	Permettre aux utilisateurs de créer et de participer à des réunions en ligne.	Pris en charge.	Créer un complément Outlook pour un fournisseur de réunions en ligne Implémenter des dossiers partagés et des scénarios de boîte aux lettres partagées dans un complément Outlook Office.context.mailbox.item.getSharedPropertiesAsync Office.SharedProperties
Améliorations apportées aux réunions	Fournir des services supplémentaires aux utilisateurs lorsqu’ils planifient des réunions, tels que la sélection de l’emplacement, les services de restauration et l’éclairage des salles et les réglages de température.	Pris en charge.	Activer des compléments avec des événements Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec des alertes intelligentes Office.context.mailbox.item.enhancedLocation
Signatures en ligne	Ajoutez automatiquement des signatures à thème aux messages et aux rendez-vous.	Pris en charge.	Mettre à jour automatiquement votre signature lors du basculement entre des comptes Exchange Implémenter l’activation basée sur les événements dans les compléments mobiles Outlook Utiliser l’activation Outlook basée sur un événement pour définir la signature Office.context.mailbox.item.loadCustomPropertiesAsync Office.context.mailbox.item.body.setSignatureAsync
Gestion de la relation client (CRM) et services de suivi	Permettre aux utilisateurs d’envoyer et de récupérer des informations à partir de leur système CRM pour suivre les communications avec les clients existants et potentiels.	Pris en charge.	Activer votre complément Outlook sans le volet de lecture activé ou un message sélectionné Journaliser les notes de rendez-vous dans une application externe dans les compléments mobiles Outlook Office.context.mailbox.item.body.getAsync Office.context.mailbox.item.body.setAsync Office.context.mailbox.item.loadCustomPropertiesAsync
Réutilisation du contenu	Permettre aux utilisateurs de transférer et de récupérer du texte et d’autres types de contenu à partir de systèmes partenaires.	Pris en charge.	Ajouter ou ajouter du contenu à un message ou un corps de rendez-vous lors de l’envoi Office.context.mailbox.item.body.appendOnSendAsync Office.context.mailbox.item.body.prependAsync Office.context.mailbox.item.body.prependOnSendAsync
Transformation d’élément de courrier	Permettre aux utilisateurs de transformer des éléments de courrier dans d’autres formats.	Pris en charge.	Méthode getAsFileAsync
Gestion de projet	Permettre aux utilisateurs de créer et de suivre des éléments de travail de projet à partir de systèmes partenaires.	Pris en charge.	Activer votre complément Outlook sur plusieurs messages Activer votre complément Outlook sans le volet de lecture activé ou un message sélectionné Vérifier les catégories de couleurs appliquées à un nouveau message ou rendez-vous
Gestion des pièces jointes	Permettre aux utilisateurs d’importer ou d’exporter des pièces jointes à partir d’emplacements partenaires.	Pris en charge.	Activer votre complément Outlook sur plusieurs messages Activer votre complément Outlook sans le volet de lecture activé ou un message sélectionné Activer des compléments avec des événements
Cryptage des messages	Permettre aux utilisateurs de chiffrer et de déchiffrer les messages.	Partiellement pris en charge. Les fonctionnalités essentielles doivent encore être traitées pour créer une expérience similaire aux compléments VSTO ou COM.	Office.context.mailbox.item.body.getAsync Office.context.mailbox.item.body.setAsync Office.context.mailbox.item.display (préversion) Office.context.mailbox.item.display.body.setAsync (préversion) Office.context.mailbox.item.display.subject.setAsync (préversion)
Prévention des pertes de données	Empêcher les utilisateurs de transférer des éléments de courrier contenant des informations hautement sensibles.	Pris en charge.	Case activée automatiquement pour une pièce jointe avant l’envoi d’un message Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec des alertes intelligentes Gérer l’étiquette de confidentialité de votre message ou rendez-vous en mode composition Vérifier l’étiquette de confidentialité d’un message Office.SensitivityLabel Office.SensitivityLabelsCatalog Office.SensitivityLabelDetails Office.context.mailbox.item.body.getAsync Office.context.mailbox.item.body.setAsync Office.context.mailbox.item.closeAsync Office.context.mailbox.item.inReplyTo Office.context.mailbox.item.getConversationIndexAsync Office.context.mailbox.item.getItemClassAsync
Classification des éléments de courrier	Permettre aux utilisateurs d’identifier et de classer les messages qui contiennent des informations sensibles.	Partiellement pris en charge. Les fonctionnalités essentielles doivent encore être traitées pour créer une expérience similaire aux compléments VSTO ou COM.	Case activée automatiquement pour une pièce jointe avant l’envoi d’un message Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec des alertes intelligentes Gérer l’étiquette de confidentialité de votre message ou rendez-vous en mode composition Gérer le niveau de sensibilité d’un rendez-vous Office.Sensitivity Office.SensitivityLabel Office.SensitivityLabelsCatalog Office.SensitivityLabelDetails
Service de synchronisation des données	Activez la synchronisation bidirectionnelle des éléments de messagerie avec les systèmes partenaires.	Partiellement pris en charge. Les fonctionnalités essentielles doivent encore être traitées pour créer une expérience similaire aux compléments VSTO ou COM.	Utiliser Microsoft Graph pour gérer les contacts personnels dans Outlook
Vérification des éléments de courrier	Fournir aux utilisateurs une aide à la vérification linguistique en temps réel quand ils composent des messages.	N’est pas pris en charge actuellement.	Non disponible

Il existe différentes possibilités d’extension de la fonctionnalité Outlook par le biais de compléments. Si votre solution de complément VSTO ou COM ne correspond à aucun des scénarios du tableau, répondez à l’enquête pour partager votre scénario.

Prise en charge d’Outlook classique sur Windows

Outlook classique sur Windows avec un abonnement Microsoft 365 ou une version commerciale perpétuelle d’Office 2016 ou version ultérieure continuera à prendre en charge le développement de compléments web Outlook nouveaux et existants. En outre, il continuera à recevoir les versions des dernières fonctionnalités du complément Outlook.

Tester votre complément dans le nouvel Outlook sur Windows

Testez votre complément web Outlook dans le nouvel Outlook sur Windows dès aujourd’hui ! Pour basculer vers la nouvelle version d’Outlook sur Windows, vous devez respecter les conditions suivantes.

Avoir un compte professionnel ou scolaire Microsoft 365 connecté à Exchange Online. Actuellement, le nouveau client ne prend pas en charge les comptes Exchange locaux, hybrides ou souverains.

Remarque

Bien que vous puissiez ajouter des comptes de messagerie non-Microsoft, tels que Gmail, au nouvel Outlook sur Windows, vous ne pouvez utiliser des compléments Outlook qu’avec un compte Microsoft. Pour plus d’informations, consultez la section « Comptes pris en charge » de la vue d’ensemble des compléments Outlook.
Disposer d’une installation minimale du système d’exploitation Windows 10 version 1809 (build 17763).

Pour vous aider à installer et à configurer le client de bureau Outlook, voir Prise en main du nouvel Outlook pour Windows.

Pour obtenir des conseils sur la façon de charger une version test de votre complément, consultez Charger une version test des compléments Outlook.

Conseil

Si vous passez du client Outlook classique sur Windows au nouveau client Outlook, notez que l’emplacement des compléments est différent. Bien que les compléments soient accessibles à partir du ruban ou de la barre de l’application dans le client Outlook classique, l’accès aux compléments dans le nouveau client Outlook varie selon que vous lisez ou composez un élément de courrier. Pour plus d’informations, voir Utiliser des compléments dans Outlook.
Dans le nouvel Outlook sur Windows, vous devez laisser la fenêtre cliente main ouverte pour exécuter des compléments (la fenêtre peut être active ou inactive). Si la fenêtre main est réduite, le complément s’interrompt ou cesse de fonctionner.

Déboguer votre complément

Pour déboguer un complément installé dans le nouveau client de bureau Outlook sur Windows, procédez comme suit :

Fermez le nouveau client Outlook sur Windows si vous l’avez déjà ouvert.
Ensuite, dans une invite de commandes, exécutez la commande suivante pour ouvrir le nouveau client Outlook sur Windows et une instance des DevTools Microsoft Edge.
```
olk.exe --devtools
```
Conseil

Après avoir exécuté la commande, la fenêtre DevTools reste ouverte, ce qui vous permet de déboguer le volet Office d’un complément à mesure que vous l’ouvrez et le fermez. Si vous fermez la fenêtre DevTools, vous devez d’abord fermer votre client Outlook avant de ré-exécuter olk.exe --devtools .
Charger une version test du complément dans Outlook sur le web.
Utilisez Microsoft Edge DevTools pour déboguer votre complément.

Disponibilité du complément en mode hors connexion

Lorsque vous activez le paramètre hors connexion dans le nouvel Outlook sur Windows, vous pouvez continuer à accéder à vos e-mails et à votre calendrier si vous perdez la connexion Internet. Bien que certaines fonctionnalités restent disponibles, les compléments Outlook et le magasin Microsoft 365 et Copilot ne sont pas disponibles hors connexion. Le tableau suivant décrit le comportement de certains types de compléments lorsque votre ordinateur est hors connexion ou dispose d’une connexion intermittente.

Scénario	Compléments de commande de fonction et de volet office	Compléments basés sur les événements
Aucune connexion Internet lors du lancement d’Outlook	Les compléments installés n’apparaissent pas dans le ruban ou la barre d’action.	Étant donné qu’Outlook ne peut pas déterminer quels compléments sont installés en mode hors connexion, les compléments basés sur les événements ne peuvent pas être activés lorsque l’événement qu’ils gèrent se produit. Dans ce scénario, pour s’assurer que les compléments Alertes intelligentes case activée toujours des messages à des fins de conformité avant leur envoi, les administrateurs peuvent configurer la stratégie de boîte aux lettres OnSendAddinsEnabled dans Exchange Online PowerShell. Une fois configurés, les messages sortants sont enregistrés dans le dossier Brouillons au lieu du dossier Boîte d’envoi pour empêcher leur envoi automatique lorsque la machine se reconnecte à Internet. Pour plus d’informations, consultez la section « Hors connexion quand Outlook lance » de Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec des alertes intelligentes.
Une connexion est établie après le lancement d’Outlook en mode hors connexion	Les compléments installés s’affichent sur le ruban et la barre d’action.	Outlook sera en mesure d’identifier les compléments basés sur les événements qui sont installés. Les compléments installés peuvent ensuite s’activer lorsque l’événement qu’ils gèrent se produit. Lorsque vous sélectionnez Envoyer sur un message qui a été bloqué par la stratégie de boîte aux lettres OnSendAddinsEnabled, le complément Alertes intelligentes s’exécute pour case activée de conformité.
L’ordinateur perd la connexion pendant l’utilisation d’Outlook	Si vous perdez la connexion lors de l’utilisation d’Outlook, vos compléments installés ne s’exécuteront pas. Une boîte de dialogue ou une notification s’affiche pour vous avertir que vous êtes hors connexion.	Si vous perdez la connexion lorsqu’un événement se produit, le comportement diffère selon le type de complément basé sur les événements. Compléments d’alertes intelligentes : lorsque vous sélectionnez Envoyer, le comportement varie selon que le complément implémente l’option d’invite utilisateur, de bloc logiciel ou de mode d’envoi de blocage . Pour plus d’informations, consultez la section « Connexion intermittente » de Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec les alertes intelligentes. Autres compléments basés sur les événements : un complément ne s’active pas lorsque l’événement qu’il gère se produit.
Une connexion est rétablie	Les compléments installés peuvent réexécuter des opérations.	Les compléments installés reprennent la gestion des événements lorsqu’ils se produisent. Les messages qui ont été déplacés vers le dossier Boîte d’envoi sont envoyés. Lorsque des messages du dossier Brouillons sont envoyés, les compléments Alertes intelligentes sont activés pour garantir la conformité.

Commentaires sur l’expérience de développement

Lorsque vous testez votre complément web Outlook dans le nouvel Outlook sur Windows, partagez vos commentaires sur votre expérience avec la communauté des développeurs via GitHub.

Partager via