Applications publiques

• créer une application publique ;
• installer une application publique dans un compte ;
• gérer l’application, y compris la surveillance de l’utilisation ;
• ajouter un domaine vérifié à l’application.

​

Créer une application publique

• 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.

• 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.

​

Configurer des domaines

​

Types de domaine

• Domaines requis : les domaines qui doivent être autorisés par l’utilisateur et présents dans le paramètre de requête scope dans l’URL d’installation de votre application pour une installation réussie.
• Domaines conditionnellement requis : les domaines qui doivent être autorisés par l’utilisateur uniquement s’ils sont présents dans le paramètre de requête scope dans l’URL d’installation de votre application pour une installation réussie.
  • Ce type de domaine vous permet d’être flexible et de fournir une URL d’installation distincte pour les fonctionnalités hiérarchisées ou les domaines qui ne sont requis que lorsque les utilisateurs activent certaines fonctionnalités dans votre application. Par exemple, vous pouvez proposer deux URL d’installation à vos utilisateurs : une URL d’installation peut inclure le domaine conditionnellement requis dans le paramètre de requête scope pour les utilisateurs ayant accès à une fonctionnalité, et une autre URL d’installation qui omet ce domaine dans le paramètre de requête scope pour les utilisateurs sans accès.
  • Si un domaine conditionnellement requis est présent dans l’URL d’installation de votre application et qu’un utilisateur sans accès à la fonctionnalité associée tente d’installer votre application à l’aide de cette URL, l’installation échouera.
• Domaines facultatifs : les domaines qui ne sont pas nécessaires pour installer votre application avec succès. Ces domaines sont spécifiés dans le paramètre de requête optional_scope dans l’URL d’installation de votre application. Par exemple, si vous souhaitez que votre application puisse récupérer des données d’objet personnalisé (qui ne sont disponibles que pour les comptes Entreprise HubSpot), vous pouvez ajouter le domaine crm.objects.custom.read en tant que domaine facultatif. Ensuite, si un compte a accès aux objets personnalisés, le domaine sera autorisé. Autrement, il pourra toujours installer l’application sans le domaine pour les objets personnalisés.

​

Configurer les domaines de votre application publique

• Pour configurer des domaines conditionnellement requis ou facultatifs, cliquez sur le bouton Activer les paramètres de domaine avancés.

• Dans la section Domaines, cliquez sur Ajouter un nouveau champ d’application.
• Dans le panneau de droite, utilisez la barre de recherche pour rechercher un domaine, puis cochez la case à côté du domaine que vous souhaitez que l’utilisateur autorise. Si vous avez activé les paramètres de domaine avancés, cliquez sur le menu déroulant à côté du domaine et sélectionnez un type de domaine.
• Cliquez sur Mettre à jour.

• Vérifiez vos domaines configurés. Si vous avez activé les paramètres de domaine avancés, vous pouvez changer le type de domaine de n’importe quel domaine en cliquant sur le menu déroulant à côté du domaine. Vous pouvez également cliquer sur Supprimer pour supprimer l’un des domaines de votre application.

• Une fois que vous avez terminé de configurer les paramètres de votre application, cliquez sur Créer une application en bas à gauche.

​

Installer une application

​

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.

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

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

• 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

​

Gérer les applications publiques dans HubSpot

​

Find an app’s ID

• Dans votre compte de développeur, accédez à Applications dans la barre de navigation principale, puis affichez l’ID d’application répertorié sous le nom de votre application.

• Dans votre compte de développeur, accédez à Applications dans la barre de navigation principale, puis cliquez sur le nom de l’application. Sur la page Informations de base, cliquez sur l’onglet Authentification, puis consultez l’ID de l’application.

​

Suivre le comportement de l’application

• Dans votre compte de développeur, 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.
• 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.

• Appels d’API : l’onglet 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.
• 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.

• Extensions de CRM : l’onglet Extensions de CRM affiche les requêtes pour les cartes de CRM de votre application. 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).
• Paramètres de l’application : l’onglet Paramètres de l’application vous permet de configurer la page de paramètres fournie avec votre application.

• Dans la boîte de dialogue, configurez le nombre de jours de données à exporter (jusqu’à 30 jours).
• Cliquez sur Exporter. Une notification par e-mail sera envoyée à l’adresse e-mail associée à votre utilisateur dans vos paramètres HubSpot.

​

Ajouter un domaine vérifié

• Lorsqu’une application n’a pas de domaine vérifié, HubSpot affichera une bannière sur l’écran d’installation indiquant que l’application n’a pas été vérifiée.

• Lorsque l’application a un domaine vérifié mais n’est pas répertoriée sur le marketplace des applications, HubSpot affichera le domaine vérifié ainsi qu’une bannière sur l’écran d’installation indiquant que l’application n’a pas été évaluée ou approuvée par HubSpot.

• Lorsqu’une application est répertoriée sur le marketplace et a passé le processus d’évaluation des applications de HubSpot, HubSpot n’affichera aucune des bannières ci-dessus. Vous n’êtes pas tenu de vérifier le domaine si votre application est répertoriée sur le marketplace des applications.

​

Ajouter un domaine vérifié

• Dans votre compte de développeur d’applications, accédez à Apps.
• Cliquez sur le nom de l’application.
• Dans le menu latéral de gauche, accédez à Contact et support.
• Dans le champ Domaine de l’entreprise, saisissez votre domaine, puis cliquez sur Enregistrer. Un message apparaîtra sous le domaine de l’entreprise indiquant que le domaine n’a pas encore été vérifié.
• Cliquez sur Vérifier maintenant pour commencer le processus de vérification.

• Dans le panneau de droite, confirmez que le domaine a été saisi correctement, puis cliquez sur Suivant.
• Copiez la valeur d’enregistrement TXT requise en cliquant sur Copier dans la colonne Valeur.

• Dans votre fournisseur DNS, créez un enregistrement TXT avec la valeur copiée. Vous trouverez ci-dessous des instructions sur certains fournisseurs DNS courants :
  • GoDaddy
  • BlueHost
  • Namecheap
  • Cloudflare
  • Hover
  • Name
  • United Domains
• Après avoir mis à jour vos paramètres DNS, revenez à HubSpot, puis cliquez sur Suivant dans le panneau de droite. La mise à jour des enregistrements DNS peut prendre jusqu’à 48 heures. Par conséquent, les modifications peuvent ne pas être immédiatement reconnues par HubSpot. Vous pouvez revenir à cet écran à tout moment en sélectionnant à nouveau Vérifier maintenant à partir de la page de paramètres Informations sur l’entreprise.
• Une fois la vérification effectuée, un indicateur de réussite apparaîtra dans le champ Domaine de l’entreprise.

​

Notes supplémentaires

• Pour assurer la propriété continue du domaine, HubSpot continuera de vérifier régulièrement la présence de l’enregistrement TXT. L’avertissement d’installation reviendra si l’enregistrement TXT est supprimé ou modifié.
• Actuellement, vous ne pouvez avoir qu’un seul domaine vérifié par compte de développeur. Toutes les applications d’un compte partagent le domaine vérifié. Le domaine sur la page d’installation sera lié à votre domaine racine.
• Si vous supprimez votre domaine vérifié, toutes les applications de votre compte de développeur recevront à nouveau l’avertissement d’installation. Vous pouvez vérifier un autre domaine, mais le processus prendra quelques heures.