Guide pratique · Microsoft 365
Guide Intégration HubSpot Sales — OWA / Exchange Online
Guide complet de déploiement et dépannage du complément HubSpot Sales pour Outlook Web App (OWA) sur Microsoft 365 / Exchange Online.
GiGaRuN — Guide de déploiement
Intégration HubSpot Sales
sur Outlook Web App
Guide de déploiement & dépannage · Microsoft 365 / Exchange Online
Sommaire
01 Prérequis & droits nécessaires
Avant de commencer
- ✓Accès Global Admin ou Exchange Admin sur le tenant Microsoft 365
- ✓Module PowerShell
ExchangeOnlineManagementinstallé (v3.x minimum) - ✓Compte HubSpot avec licence Sales Hub (Starter, Pro ou Enterprise)
- ✓Les utilisateurs cibles utilisent Outlook Web App (outlook.office.com) ou le nouveau Outlook desktop
Si le module PowerShell n'est pas installé :
Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser
02 Configurer la politique Exchange Online
Pourquoi cette étape est critique
Par défaut sur certains tenants, la politique OWA bloque les compléments tiers (comme HubSpot). Même si le déploiement affiche « OK » dans le M365 Admin Center, les utilisateurs ne verront rien. Cette étape doit être faite AVANT le déploiement du complément.
Connexion & diagnostic
// Se connecter à Exchange Online
Connect-ExchangeOnline
// Vérifier l'état actuel de la politique OWA
Get-OwaMailboxPolicy -Identity "OwaMailboxPolicy-Default" |
Select Name, WacOMEXEnabled, OnSendAddinsEnabled
Select Name, WacOMEXEnabled, OnSendAddinsEnabled
Si
WacOMEXEnabled = False, les compléments tiers sont bloqués pour tous les utilisateurs soumis à cette politique. Activer les compléments tiers
Set-OwaMailboxPolicy -Identity "OwaMailboxPolicy-Default"
-WacOMEXEnabled $true
-OnSendAddinsEnabled $true
-WacOMEXEnabled $true
-OnSendAddinsEnabled $true
| Paramètre | Rôle | Valeur requise |
|---|---|---|
WacOMEXEnabled | Autorise l'affichage des compléments tiers (AppSource) dans OWA | True |
OnSendAddinsEnabled | Autorise l'exécution des compléments au moment de l'envoi d'email (tracking HubSpot) | True |
Vérification post-configuration
Get-OwaMailboxPolicy -Identity "OwaMailboxPolicy-Default" |
Select Name, WacOMEXEnabled, OnSendAddinsEnabled
# Résultat attendu :
Name WacOMEXEnabled OnSendAddinsEnabled
---- -------------- -------------------
OwaMailboxPolicy-Default True True
Select Name, WacOMEXEnabled, OnSendAddinsEnabled
# Résultat attendu :
Name WacOMEXEnabled OnSendAddinsEnabled
---- -------------- -------------------
OwaMailboxPolicy-Default True True
// Déconnexion propre
Disconnect-ExchangeOnline -Confirm:$false
03 Déployer le complément HubSpot Sales
Méthode 1 — Déploiement centralisé (recommandé)
1
Se connecter au M365 Admin Center → Paramètres → Applications intégrées.
2
Cliquer sur Obtenir des applications → rechercher « HubSpot Sales » dans AppSource.
3
Cliquer Obtenir maintenant → accepter les autorisations demandées.
4
Choisir le périmètre de déploiement : Toute l'organisation, utilisateurs spécifiques ou groupes.
5
Valider le déploiement. Le statut doit passer à « Déployé » sous quelques minutes.
La propagation Microsoft peut prendre 15 à 30 minutes (parfois jusqu'à 24h dans de rares cas).
Méthode 2 — Installation individuelle par l'utilisateur
1
Ouvrir outlook.office.com → ouvrir un email.
2
Cliquer sur les trois points
··· en haut de l'email → Obtenir des compléments.3
Rechercher « HubSpot Sales » → Ajouter.
Cette méthode nécessite que
WacOMEXEnabled = True ET que l'option « Obtenir des compléments » soit visible (non bloquée par la politique). 04 Vérification du déploiement
Points de contrôle
- ✓M365 Admin Center → Applications intégrées → HubSpot Sales : statut OK / Déployé
- ✓WacOMEXEnabled et OnSendAddinsEnabled : True (vérifié en PowerShell)
- ✓Test avec un compte utilisateur standard (pas un Global Admin)
- ✓L'icône HubSpot apparaît dans la barre d'actions en ouvrant un email dans OWA
Piège classique : ne jamais valider le déploiement avec un compte Global Admin. Les admins peuvent bénéficier d'exemptions sur les politiques OWA et voir le complément alors qu'il est invisible pour les utilisateurs standards.
05 Actions côté utilisateur
Après déploiement — à communiquer aux utilisateurs
1
Fermer complètement la session OWA (se déconnecter).
2
Vider le cache du navigateur : Ctrl + Shift + Del → tout cocher → Effacer.
3
Se reconnecter sur outlook.office.com.
4
Ouvrir un email reçu → l'icône HubSpot Sales doit apparaître dans la barre d'actions en haut de l'email.
Si HubSpot n'apparaît pas immédiatement, patientez 15 à 30 minutes (délai de propagation Microsoft) puis recommencez depuis l'étape 1.
06 Dépannage & problèmes connus
Problème : HubSpot invisible dans OWA malgré un déploiement « OK »
①
Symptômes : Le complément n'apparaît pas dans la barre d'actions. L'option « Obtenir des compléments » est absente du menu
···. La section Compléments n'existe pas dans les paramètres OWA.②
Cause :
WacOMEXEnabled = False sur la politique OWA du tenant. Cette restriction est invisible pour l'utilisateur final.③
Solution : Appliquer la commande PowerShell de la section 02 ci-dessus. Patienter 15-30 min pour la propagation.
Problème : l'admin voit HubSpot mais pas les utilisateurs
Comportement trompeur : le compte Global Admin peut bénéficier d'exemptions sur certaines politiques OWA, ou d'une policy distincte. Sa visibilité de HubSpot ne valide pas le déploiement pour les utilisateurs standards.
Vérification : Toujours tester avec un compte utilisateur standard sans rôle admin. Si le complément est invisible pour cet utilisateur, vérifier
WacOMEXEnabled.
Problème : Viva Insights visible mais pas HubSpot
Normal. Viva Insights est un complément natif Microsoft qui ne passe pas par le même canal que les compléments tiers. Il n'est pas soumis à
WacOMEXEnabled. Problème : le complément apparaît puis disparaît
①
Vérifier que le déploiement est toujours actif dans M365 Admin Center → Applications intégrées.
②
Vérifier qu'aucune politique de sécurité conditionnelle (Conditional Access) ne bloque l'accès aux applications tierces pour ce groupe d'utilisateurs.
③
Vérifier s'il existe plusieurs politiques OWA sur le tenant : certains utilisateurs peuvent être soumis à une politique différente de
OwaMailboxPolicy-Default. # Lister toutes les politiques OWA du tenant
Get-OwaMailboxPolicy | Select Name, WacOMEXEnabled, OnSendAddinsEnabled
# Vérifier quelle politique est appliquée à un utilisateur
Get-CASMailbox -Identity "[email protected]" | Select OwaMailboxPolicy
Get-OwaMailboxPolicy | Select Name, WacOMEXEnabled, OnSendAddinsEnabled
# Vérifier quelle politique est appliquée à un utilisateur
Get-CASMailbox -Identity "[email protected]" | Select OwaMailboxPolicy
Problème : erreur « AddinEnabled » introuvable
Le paramètre
AddinEnabled a été retiré des versions récentes du module ExchangeOnlineManagement. Il n'est plus nécessaire. Seuls WacOMEXEnabled et OnSendAddinsEnabled comptent. Problème : HubSpot ne track pas les emails envoyés
①
Vérifier que
OnSendAddinsEnabled = True (nécessaire pour le tracking à l'envoi).②
Vérifier côté HubSpot que l'utilisateur a bien connecté sa boîte mail dans HubSpot → Paramètres → Général → Email.
③
Vérifier que le tracking est activé dans les paramètres HubSpot Sales de l'utilisateur.
07 Référence : paramètres & types de compléments
Compléments natifs vs tiers
| Type de complément | Soumis à WacOMEXEnabled | Exemple |
|---|---|---|
| Natif Microsoft | Non | Viva Insights, Suggested Replies |
| Tiers AppSource | Oui | HubSpot Sales, Salesforce, Zoom |
| Tiers — compte Global Admin | Exempté (possible) | Exemption implicite, ne pas s'y fier |
Paramètres PowerShell — récapitulatif
| Paramètre | Valeur requise | Impact si False |
|---|---|---|
WacOMEXEnabled | True | Aucun complément tiers visible dans OWA |
OnSendAddinsEnabled | True | Pas de tracking/enrichissement au moment de l'envoi |
AddinEnabled | Obsolète | Retiré des versions récentes du module Exchange |
Bonnes pratiques post-déploiement
R1
Documenter les politiques OWA dans votre CMDB ou base de gestion de configuration.
R2
Lors de tout déploiement d'add-in tiers, valider systématiquement
WacOMEXEnabled avant livraison.R3
Ne jamais utiliser un compte Global Admin pour valider la visibilité d'un add-in — préférer un compte utilisateur standard de test.
R4
Activer le suivi d'utilisation dans M365 Admin Center → Applications intégrées → HubSpot Sales → Utilisation, pour confirmer l'adoption.