Connecter HubSpot à Goodweek – Guide de configuration

⚠️ Note sur la gouvernance

Goodweek n'excédera jamais les niveaux d'accès accordés à l'utilisateur dans HubSpot, garantissant ainsi l'alignement avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations propres à chaque utilisateur et selon son accès authentifié.

📋 Prérequis

Avant qu'un utilisateur puisse voir et connecter l'intégration HubSpot, l'administrateur de votre organisation doit d'abord l'activer depuis le panneau d'administration Goodweek, dans l'onglet Intégrations.

Les utilisateurs qui connectent des applications via OAuth doivent être Super Admin ou disposer de l'autorisation HubSpot App Marketplace Access. Sans l'une de ces deux conditions, ils rencontreront l'erreur :

" Vous ne disposez pas des autorisations nécessaires pour installer Composio "

⚙️ Configuration administrateur

Selon la configuration de votre compte HubSpot, l'un des trois scénarios suivants s'appliquera.

Scénario 1 – Par défaut (le Super Admin se connecte en premier) ✅ Recommandé

L'approche recommandée consiste à ce qu'un Super Admin HubSpot soit le premier à finaliser la connexion depuis Goodweek. Cela garantit que l'application est autorisée au niveau du compte et réduit les frictions pour les utilisateurs suivants.

Connectez-vous à Goodweek avec n'importe quel compte.
Rendez-vous dans Intégrations et recherchez HubSpot.
Cliquez sur Connecter. Vous serez redirigé vers HubSpot.
Connectez-vous avec vos identifiants Super Admin HubSpot et autorisez la connexion.
Une fois la connexion établie par le Super Admin, les autres utilisateurs peuvent procéder de manière autonome.

Scénario 2 – Utilisateurs non Super Admin se connectant individuellement

Les utilisateurs qui ne sont pas Super Admin peuvent connecter HubSpot s'ils disposent de l'autorisation App Marketplace Access. Pour accorder cette autorisation :

Dans HubSpot, allez dans Paramètres > Utilisateurs et équipes.
Sélectionnez l'utilisateur et ouvrez ses Autorisations.
Activez App Marketplace Access dans les autorisations du compte.
Si l'erreur persiste, activez également Edit property settings dans la même section.

Une fois l'autorisation accordée : Goodweek → Intégrations → HubSpot → Connecter.

Scénario 3 – L'utilisateur reste bloqué malgré App Marketplace Access

Certaines portées OAuth (scopes) HubSpot sont réservées aux Super Admin. Si un utilisateur reste systématiquement bloqué :

Demandez à un Super Admin de finaliser la connexion à sa place.
Si l'utilisateur a déjà échoué lors d'une tentative OAuth, son état peut être mis en cache. La seule réinitialisation fiable consiste à lui accorder temporairement des autorisations plus élevées, ou à utiliser un nouveau compte utilisateur n'ayant jamais tenté la connexion.

🔗 Connexion utilisateur

Une fois les autorisations nécessaires en place, chaque utilisateur connecte son propre compte HubSpot individuellement :

Dans Goodweek, rendez-vous dans Intégrations.
Recherchez HubSpot et cliquez sur Connecter.
Vous serez redirigé vers HubSpot : connectez-vous et sélectionnez le compte HubSpot souhaité.
Vérifiez les autorisations demandées et cliquez sur Connecter l'application pour revenir à Goodweek.

Points importants

Chaque utilisateur doit connecter son propre compte individuellement.
Goodweek ne peut accéder qu'aux données HubSpot que votre compte est autorisé à consulter.
Si vous gérez plusieurs portails HubSpot, veillez à sélectionner le bon lors de la connexion.
Vous pouvez déconnecter Goodweek à tout moment depuis Paramètres HubSpot > Intégrations > Applications connectées.

🪛 Dépannage

Erreur «Vous ne disposez pas des autorisations nécessaires pour installer Composio »

Il s'agit du problème le plus courant. Suivez ces étapes dans l'ordre :

Demandez à votre Super Admin HubSpot d'aller dans HubSpot > Paramètres > Utilisateurs et équipes > [votre nom] > Autorisations > Compte, puis d'activer App Marketplace Access. Essayez ensuite de vous reconnecter depuis Goodweek.
Si l'erreur persiste, demandez au Super Admin d'activer également Edit property settings dans la même section.
Si l'erreur persiste toujours, demandez au Super Admin de finaliser la connexion HubSpot depuis Goodweek avec son propre compte. Une fois connecté, vous devriez pouvoir connecter votre compte sans difficulté.
Si aucune solution ne fonctionne, le problème peut provenir d'une tentative précédente échouée (état mis en cache). Demandez au Super Admin de se connecter à votre place, ou essayez avec un compte utilisateur n'ayant jamais tenté la connexion.

L'utilisateur reste bloqué après l'attribution d'App Marketplace Access

Certaines portées HubSpot sont réservées aux Super Admin. Si l'utilisateur a déjà tenté la connexion sans succès, son état peut être mis en cache. Demandez à un Super Admin de finaliser la connexion, ou essayez avec un compte utilisateur n'ayant jamais tenté de connecter HubSpot.

Intégration non visible dans Goodweek

Assurez-vous que l'administrateur de votre organisation a bien activé l'intégration HubSpot depuis le panneau d'administration Goodweek > onglet Intégrations. Si elle n'est pas activée, l'intégration n'apparaîtra pour aucun utilisateur.