Présentation de la création d'applications

Les applications vous permettent d'authentifier les appels d'API vers votre compte HubSpot, de vous abonner aux événements avec des webhooks et d'étendre l'interface utilisateur HubSpot, par exemple avec des cartes personnalisées. HubSpot propose plusieurs types d'applications et d'extensions en fonction des besoins de votre intégration. Découvrez ci-dessous les types d'applications et d'extensions que vous pouvez créer avec HubSpot, comment commencer à les créer et comment les gérer dans HubSpot.

Types d'applications

Selon le type d'intégration que vous souhaitez créer, vous devrez choisir le bon type d'application. Découvrez ci-dessous les types d'applications que vous pouvez créer et les fonctionnalités prises en charge.

Pour la création d'extensions, consultez le tableau de référence ci-dessous pour un aperçu des extensions pouvant être créées selon les types d'applications.

Applications privées

Les applications privées peuvent être créées pour un seul compte HubSpot et sont mieux adaptées aux scripts uniques ou aux extensions à usage unique. Par exemple, vous pouvez créer une application privée pour votre compte HubSpot pour :

  • créer un nouvel objet personnalisé via l'API ;
  • importer des fiches d'informations de CRM à partir d'un fichier CSV ;
  • authentifier les demandes d'API dans des actions d'automatisation personnalisées et des chatbots.
  • Créez et modifiez des abonnements de webhook.

En général, les applications privées sont plus simples à mettre en œuvre que les applications publiques. Les applications privées s'authentifient avec des jetons d'accès et ne peuvent pas être répertoriées sur le marketplace des applications HubSpot. Découvrez-en davantage sur les situations dans lesquelles créer des applications privées.

Si ce type d'application correspond à vos besoins, commencez à créer une application privée dans votre compte HubSpot.

Applications privées dans des projets (BÊTA)

Les applications privées créées avec des projets permettent de créer des extensions d'interface utilisateur pour les fiches d'informations de CRM. La différence lors de la création d'une application privée via cette méthode est que les projets ne prennent en charge que la création d'extensions d'interface utilisateur, que les applications privées en dehors des projets ne peuvent pas créer.

Si ce type d'application répond à vos besoins, consultez le guide de démarrage rapide des projets pour commencer à créer une application et un projet privés à l'aide de l'ILC.

Applications publiques

Les applications publiques peuvent être installées dans plusieurs comptes. Outre les types d'extensions que vous pouvez créer avec une application privée, les applications publiques prennent en charge des fonctionnalités avancées, telles que :

  • l'abonnement à des événements à l'échelle du compte à l'aide de l'API des webhooks ;  
  • la création d'événements de chronologie personnalisés sur des fiches d'informations de CRM à l'aide de l'API d'événements de chronologie ; 
  • la création de pages de paramètres d'application personnalisées dans HubSpot. 

Les applications publiques s'authentifient avec OAuth et peuvent être répertoriées sur le marketplace des applications HubSpot. Découvrez-en davantage sur les situations dans lesquelles créer des applications publiques.

Si ce type d'application répond à vos besoins, commencez à créer une application publique dans votre compte de développeur d'applications.

Extensions prises en charge par type d'application

Type d'application Extensions prises en charge
Application privée
Application publique
Application privée créée avec des projets (BÊTA)
* Les cartes CRM que vous pouvez créer avec des applications publiques sont différentes des cartes personnalisées que vous pouvez créer en tant qu'extensions d'interface utilisateur avec des projets (BÊTA). Les extensions d'interface utilisateur offrent des fonctionnalités plus avancées et des composants personnalisables.

Types de comptes pour le développement d'applications

Bien que les comptes de développeur et de test fonctionnent ensemble, leurs objectifs sont différents.

  • Les comptes de développeurs d'applications servent à créer à répertorier des applications sur le marketplace des applications.
  • Testez les comptes destinés à tester les API et les applications que vous créez sans impacter les données réelles d'un compte HubSpot. Il s'agit d'un compte distinct d'un compte sandbox que vous pouvez créer dans les comptes HubSpot standard.

Découvrez-en davantage sur les types de compte HubSpot.

Authentification

Si vous souhaitez créer une intégration personnalisée avec un seul compte HubSpot, vous pouvez créer une application privée et utiliser son jeton d'accès pour authentifier les appels d'API ou utiliser OAuth avec une application publique. Toute application conçue pour une installation par plusieurs comptes HubSpot ou pour un listing sur le marketplace des applications doit utiliser OAuth.

Remarque : À compter du 30 novembre 2022, les clés d'API HubSpot sont obsolètes et ne sont plus prises en charge. L'utilisation continue des clés d'API HubSpot constitue un risque pour la sécurité de votre compte et de vos données. Pendant cette phase, HubSpot peut désactiver votre clé à tout moment.

Veillez plutôt à vous authentifier à l'aide d'un jeton d'accès d'application privée ou d'OAuth. Découvrez-en davantage sur cette modification et sur la migration d'une intégration de clé d'API pour utiliser une application privée à la place.

Si vous souhaitez vous abonner à des webhooks ou configurer OAuth pour votre application, vous devez créer un compte de développeur. Avec les comptes de développeur, vous pouvez également lister vos applications sur le marketplace des applications ou créer un compte de test.

Clés d'API des comptes de développeur

Pour gérer les paramètres de votre application via l'API, vous pouvez utiliser une clé d'API de développeur. Cette clé d'API se distingue des clés d'API standard, qui sont obsolètes. Les clés d'API de développeur peuvent être utilisées pour la gestion des abonnements pour l'API des webhooks et la création ou la mise à jour des types d'événements pour la fonctionnalité des événements chronologiques. Tous les autres appels d'API doivent être effectués à l'aide d'un jeton d'accès d'application privée ou d'OAuth.

Pour accéder à votre clé d'API de compte de développeur d'applications :

  • Dans votre compte de développeur d'applications, accédez à Applications dans la barre de navigation supérieure.
  • Dans l'angle supérieur droit, cliquez sur Obtenir la clé d'API HubSpot.
  • Dans la boîte de dialogue, cliquez sur Afficher la clé. La clé sera révélée et vous pourrez ensuite cliquer sur Copier à côté de la clé.
  • Vous pouvez également désactiver la clé d'API précédente et en générer une nouvelle en cliquant sur Générer la clé.

show_dev_api_key

Delete a developer account

Vous pouvez supprimer des comptes de développeur s'ils ne contiennent plus d'applications avec des installations ou des listings de marketplace actifs. Si votre compte contient des applications ou des listings de marketplace actifs et que vous souhaitez le supprimer, veuillez contacter le support pour obtenir de l'aide.

Une fois votre compte supprimé, vous ne pourrez plus y accéder. Si vous pouvez basculer entre plusieurs comptes HubSpot, le compte supprimé n'apparaîtra plus.

Dans votre compte de développeur HubSpot, cliquez sur le nom de votre compte figurant dans l'angle supérieur droit, puis sur Compte.

account

Cliquez sur Supprimer le compte. Si votre compte contient des applications ou des listings de marketplace actifs, ce bouton sera désactivé.

Account2

Dans la boîte de dialogue, saisissez votre ID de compte, puis cliquez sur Supprimer le compte de développeur.

Confirm2

 


Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.