La communication avec HubSpot passe par son API REST dont l'authentication à celle-ci est assurée par le protocole OAuth.
Pour connecter Eventmaker à votre instance HubSpot, il faut que possédiez un compte utilisateur avec un profil Administrateur de préférence ; une application héritée doit être créée sur votre instance et celle-ci vous fournira un ID du client et un Secret du Client qui sont primordiaux pour établir la connexion.
Cet article va vous expliquer comment créer l'application héritée et comment effectuer le branchement entre Eventmaker et HubSpot grâce à celle-ci.
Etape 1
Rendez-vous sur l'espace de Configuration de votre instance HubSpot, puis depuis la navigation, ouvrez le menu Intégrations et cliquez sur Applications héritées (vous pouvez également y accéder depuis le menu Développement). Enfin cliquez sur Créer une application héritée et choisissez l'option Public.
Etape 2
Remplissez les informations de base de votre application : nous vous recommandons d'appeler l'application "Eventmaker" pour l'identifier plus facilement ; vous pouvez également lui assigner un logo ainsi qu'une description. Cliquez maintenant sur l'onglet Authentification pour passer à la suite.
Etape 3
Comme vous pouvez le constater, les ID du Client et Secret du Client ne sont pas encore disponibles. Il faut d'abord terminer la configuration.
Scrollez jusqu'à la section URL de redirection et ajoutez https://app.eventmaker.io/oauth/hubspot/callback comme URL de redirection.
Etape 4
Dans la section suivante Domaines, vous allez devoir indiquer ce que Eventmaker va avoir le droit de faire sur le CRM en votre nom au travers de cette application.
Cliquez sur Ajouter un nouveau champ d'application et sélectionnez les domaines suivants en les marquant en obligatoire :
crm.lists.read
crm.lists.write
crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.companies.write
crm.objects.deals.read
crm.objects.deals.write
crm.objects.marketing_events.read
crm.objects.marketing_events.write
oauth
🚨 Attention : il est très important de sélectionner exclusivement les domaines de la liste ci-dessus (ni plus, ni moins), autrement la connexion échouera.
Vous n'avez pas à toucher au reste du formulaire.
Enfin, cliquez sur Créer une application.
Notez que maintenant que l'application est créée, vous avez accès aux ID Client et Secret Client que vous allez devoir copier dans Eventmaker.
🚨 Attention il s'agit d'informations sensibles, ne les partagez pas !
Etape 5
De retour dans Eventmaker, rendez-vous dans la marketplace des outils tiers via l'onglet Intégrations, puis cliquez sur HubSpot.
Il est enfin temps de connecter Eventmaker à votre instance HubSpot. Pour cela entrez les ID et Secret Client récupérés précédemment et cliquez sur le bouton Se connecter à HubSpot.
Une fenêtre de connexion à HubSpot va s'ouvrir, sur laquelle vous devez utiliser le compte utilisateur administrateur pour vous connecter et ensuite vous devez accepter les permissions. Grâce à cela, Eventmaker va être en mesure de récupérer via l'API de HubSpot les autres informations nécessaires à l'authentification, notamment votre token d'accès. Enfin vous êtes redirigé vers le formulaire initial qui indique si l'authentification est valide.
Vous pouvez alors continuer à configurer votre intégration HubSpot.