Créer et installer des applications

Dans HubSpot, une application est un type d'intégration qui peut être installé sur les comptes de clients ou listé sur le marketplace des applications. Elle nécessite une authentification via OAuth. Une fois qu'un utilisateur installe votre application sur son compte HubSpot, vous pourrez effectuer des appels d'API vers ce compte en utilisant un jeton d'accès OAuth. Votre application apparaîtra également dans les paramètres Applications connectées du compte.

Les applications connectées peuvent également tirer parti de l'abonnement aux modifications via les webhooks et de la création d'événements chronologiques personnalisés. 

Créer une application

Lorsque vous créez une application dans HubSpot, vous associez principalement une application que vous avez conçue à un compte de développeur d'applications. Pour commencer à créer votre application HubSpot :

  • Dans votre compte de développeur d'applications, accédez à Apps dans la barre de navigation. 
  • Cliquez sur Créerdans l'angle supérieur droit.
  • Ensuite, vous devrez renseigner certaines informations et paramètres de base pour votre application. Lorsque les utilisateurs authentifient votre application avec leurs comptes HubSpot, ils verront le nom, la description, le logo et toute coordonnée de support que vous fournissez sur cette page.

Remarque : Le nom de l'application sera utilisé partout où votre application s'affichera dans HubSpot. C'est le cas notamment lors de l'installation de l'application ainsi que dans le pied de page Géré par pour les cartes CRM et les événements de chronologie.

  • Cliquez sur l'onglet Authentification pour afficher votre ID et votre secret client ainsi que les périmètres attribués à l'application. Vous aurez besoin de ces informations pour lancer une connexion OAuth entre votre application et HubSpot.

  • Dans l'onglet Authentification, cliquez sur le menu déroulant Périmètres en bas de la page pour ajouter de nouveaux périmètres à votre application. Ces périmètres d'accès obligatoires doivent être inclus dans le paramètre scope= de votre URL d'autorisation. Sinon, les utilisateurs recevront une erreur lorsqu'ils essayeront d'autoriser votre application. Consultez la documentation sur OAuth pour plus d'informations sur la création de votre URL d'autorisation et l'utilisation des périmètres d'accès.

app_scopes

  • Tenez compte du champ URL de redirection. C'est vers cette URL que les utilisateurs seront renvoyés après l'octroi de l'accès de votre application à leurs comptes HubSpot. Si vous n'incluez pas d'URL de redirection, les utilisateurs recevront une erreur de connexion. Les URL de redirection doivent utiliser HTTPS, sauf si elles se trouvent sur localhost.

Une fois votre application créée, vous pourrez suivre le processus d'installation.

Installer une application

L'installation d'une application peut être divisée en deux étapes : l'autorisation et la génération d'un jeton.

Remarque : Avant d'installer votre application, tenez compte des éléments suivants.

  • Une application ne s'affiche pas sur la page Applications connectées d'un compte tant que l'accès initial et les jetons d'actualisation ne sont pas créés.
  • Seuls les utilisateurs disposant d'un accès aux périmètres d'accès requis de l'application peuvent installer une application.
  • Les applications ne peuvent pas être installées sur des comptes de développeur. Pour tester votre application, vous devez créer un compte de test dans votre compte de développeur d'applications et l'installer dessus.

Autoriser votre application avec un compte client 

  • Pour autoriser votre application avec un compte HubSpot, vous devez créer une URL d'autorisation. Pour cela, vous devez obtenir l'ID de client pour votre application etlancer le processus OAuth.
  • Une fois que votre URL est prête, ouvrez-la dans votre navigateur pour afficher une liste de tous vos comptes HubSpot C'est également cela que les utilisateurs verront une fois que vous aurez commencé à les rediriger vers cette URL.
  • Sélectionnez le compte sur lequel vous souhaitez installer votre application.

select_account-1

  • Après avoir choisi un compte, vous disposerez d'une liste de périmètres d'accès en fonction des paramètres &scopes= et &optional_scope= définis pour l'URL d'autorisation.

Remarque : Si vous ajoutez un optional_scope et que le compte sélectionné n'y a pas accès (comme la portée de contenu pour un compte CRM uniquement), il ne sera pas répertorié.

  • Cliquez sur Accorder l'accès pour autoriser la connexion.

approve_scopes-1

  • Après avoir autorisé l'accès, vous serez redirigé en fonction du paramètre &redirect_uri= dans l'URL d'autorisation d'origine et un paramètre ?code= sera ajouté à l'URL. Utilisez ce code à l'étape suivante pour générer un jeton d'accès.

Générer les jetons OAuth initiaux 

Pour générer les jetons d'actualisation et d'accès initiaux, vous aurez besoin du code du paramètre ?code= de l'URL d'autorisation, de redirect_url ainsi que de l'ID et du secret de client. Des instructions détaillées sont disponibles ici

Étapes suivantes

Une fois que vous avez autorisé votre application et généré les jetons initiaux, l'installation est terminée. L'application sera répertoriée sur votre page Applications connectées et vous commencerez à obtenir des demandes d'indexation (fetch) de webhook et de cartes CRM.

connected_apps-1


Ressources associées

Outils et comptes de développeur

Comptes de test

Lister votre application