Présentation du développement d'applications

Les applications sont un package pour toute fonctionnalité que vous souhaitez partager avec les utilisateurs HubSpot (ou un autre compte HubSpot). Les applications vous permettent également de développer en utilisant des fonctionnalités telles que les cartes CRM personnalisées, les événements chronologiques et les webhooks. Lors du développement d'une application, HubSpot dispose d'un certain nombre d'outils pour faire fonctionner votre application ou intégration. Découvrez-en davantage sur les composants du développement d'applications. 

Comptes

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

  • Les comptes de développeur sont utilisés pour créer et lister des applications.
  • Les comptes de test* vous permettent de tester nos API ainsi que 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 une clé d'API. 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 ne pourront plus être utilisées comme méthode d'authentification pour accéder aux API HubSpot. En outre, à compter du 15 juillet 2022, les comptes sans clé d'API HubSpot déjà générée ne pourront plus en créer.

Au lieu de cela, vous devrez utiliser un jeton d'accès d'application privée ou OAuth pour authentifier les appels d'API. 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. Cela inclut 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.

Les clés d'API de développeur ne peuvent être utilisées que pour effectuer des appels d'API pour mettre à jour les paramètres d'une application. 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

App ID

Lors du développement de votre application, vous pouvez trouver votre ID d'application à deux endroits : 

  • Sous le nom de votre application dans le tableau de bord Applications de votre compte de développeur :
Screen Shot 2020-01-15 at 2
  • Dans les paramètres Authentification de votre application :

app_auth_id_settings

 

Monitoring app behavior

HubSpot enregistre toutes les demandes effectuées vers ou à partir d'une application connectée, y compris les demandes entrantes utilisant un jeton d'accès OAuth ou les demandes sortantes pour des webhooks ou des cartes de CRM. 

Pour afficher ce journal des demandes :

  • Dans votre compte de développeur d'applications, accédez à Apps dans la barre de navigation.
  • Cliquez sur le nom de l'application.
  • Dans le menu latéral de gauche, accédez à Suivi

app_monitoring

  • Utilisez les onglets pour afficher les différents types de demandes effectuées vers ou à partir de l'application. Lors de l'affichage de ces journaux, vous pouvez cliquer sur une demande pour afficher plus d'informations à son sujet, y compris :
    • pour les requêtes réussies, la méthode de requête, le chemin et la durée ;
    • pour les requêtes infructueuses, des informations d'erreur supplémentaires telles que l'en-tête et le corps de la réponse.

request_details

Découvrez ci-dessous chaque onglet de la page Suivi.

Appels d'API

Le journal des appels d'API répertorie toutes les requêtes concernant votre application via un jeton d'accès OAuth. Il peut être filtré par méthode HTTP, par code de réponse, par période ou par URL de demande.

api_calls_monitoring-1

Webhooks

L'onglet Webhooks affiche les requêtes HubSpot pour les souscriptions aux webhooks de votre application. Filtrez par réponse (y compris les délais d'attente dépassés et les échecs de connexion), par statut (succès, nouvelle tentative ou échec), par type de souscription, par période, par tentative, par lot, par événement ou par ID de compte.

Please note: the attempt ID is a combination of the subscriptionId, eventId, and attemptNumber from a specific request.

webhook_monitoring

Extensions du CRM

Vous trouverez les requêtes HubSpot pour les cartes de CRM dans l'onglet Extensions du CRM. Filtrez par type d'fiche d'informations d'extension, par type d'objet de CRM (contact, entreprise, ticket ou transaction), par type d'erreur ou d'avertissement, par période, par ID de requête ou par ID d'objet de CRM (par exemple, ID de contact spécifique).

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

 

Documents associés

Créer et installer des applications

Créer un compte de développeur

Créer un compte de test

Créer un compte sandbox HubSpot (bêta)