Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# HubSpot intégration
Accédez à vos données HubSpot CRM directement depuis Amazon Quick en langage naturel. Grâce au connecteur HubSpot d'action, vous pouvez récupérer et répertorier des contacts, des entreprises, des offres et des tickets sans quitter Amazon Quick.
HubSpot est disponible sous forme de connecteur intégré dans Amazon Quick. Pour configurer cette intégration, effectuez les deux étapes suivantes. Tout d'abord, préparez votre HubSpot compte avec les accès requis. Créez ensuite le connecteur dans Amazon Quick et authentifiez-vous à l'aide de vos HubSpot informations d'identification.
Ce connecteur prend en charge l'authentification personnalisée des applications OAuth. Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultez[Méthodes d’authentification](quick-action-auth.md).
## Conditions préalables
Avant de configurer l'intégration, vérifiez que vous disposez des ressources et des accès suivants.
+ Un HubSpot compte actif doté d'un rôle d'administrateur.
+ Autorisations pour accéder aux données CRM, y compris les contacts, les entreprises, les offres et les tickets de votre HubSpot compte.
+ Un abonnement qui répond aux exigences décrites dans[Configuration des intégrations dans la console](integration-console-setup-process.md).
## Vérification de votre HubSpot compte
Avant de configurer Amazon Quick, vérifiez que votre HubSpot compte répond aux exigences suivantes.
+ Votre HubSpot compte est actif et vous pouvez vous connecter à la [page de HubSpot connexion](https://app.hubspot.com/login) du site HubSpot Web.
+ Les données CRM auxquelles vous souhaitez accéder, y compris les contacts, les entreprises, les offres et les tickets, sont accessibles sur votre compte.
## Configuration de votre HubSpot compte
La méthode d'authentification personnalisée de l'application OAuth dans Amazon Quick nécessite une application MCP Auth configurée dans vos paramètres de développement. HubSpot
### Pour configurer une application d'authentification MCP
1. Connectez-vous à votre HubSpot compte.
1. Accédez à **Développement**, puis à **MCP Auth** Apps.
1. Choisissez **Créer une application d'authentification MCP**.
1. Dans la fenêtre **Create MCP Auth App**, renseignez les champs suivants :
+ **Nom** — Entrez le nom de votre application.
+ **Description** — Entrez une brève description.
+ **URL de redirection** — Entrez`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. Remplacez {{region}} par votre AWS région, par exemple,`us-east-1`.
1. Choisissez **Create**. HubSpot crée l'application et génère un identifiant client et un secret client.
**Important**
Enregistrez le secret du client et son identifiant.
L'ID client et le secret client servent d'ID client et de secret client lorsque vous configurez le connecteur d'action dans Amazon Quick avec la méthode d'authentification de l'application OAuth personnalisée.
Pour plus d'informations, consultez la section [Serveur HubSpot MCP](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) sur le HubSpot site Web.
## Configuration de l'intégration dans Amazon Quick
Après avoir vérifié l'accès à votre HubSpot compte, créez le connecteur dans Amazon Quick.
1. Dans la console Amazon Quick, choisissez **Connectors**.
1. Choisissez l'onglet **Créer pour votre équipe**.
1. Choisissez **HubSpot**parmi les options disponibles.
1. Dans la **HubSpot**boîte de dialogue, entrez les champs suivants :
+ **Nom : nom** descriptif de votre HubSpot connecteur.
+ **Description (facultatif)** — Choisissez **\+ Ajouter une description** pour ajouter des notes sur la façon dont ce connecteur sera utilisé.
+ **Type de connexion** — Choisissez **Réseau public**.
1. Pour la méthode d'authentification **personnalisée de l'application OAuth**, entrez les champs suivants :
+ **URL de base** — Ce champ est rempli automatiquement sous `https://mcp.hubspot.com` la forme.
+ **ID client** — Entrez l'ID client depuis votre application HubSpot MCP Auth.
+ **Secret du client** — Entrez le secret du client depuis votre application HubSpot MCP Auth.
+ **URL du jeton** — Ce champ est rempli automatiquement sous `https://api.hubapi.com/oauth/v1/token` la forme.
+ **URL d'autorisation** — Ce champ est rempli automatiquement sous `https://app.hubspot.com/oauth/authorize` la forme.
+ **URL de redirection** — Ce champ est rempli automatiquement sous `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback` la forme.
1. Choisissez **Suivant**, passez en revue les actions pour HubSpot, puis sélectionnez à nouveau **Suivant**.
1. Spécifiez qui peut accéder au connecteur :
+ Pour partager avec une équipe, entrez le nom de l'équipe ou l'e-mail du groupe.
+ Pour qu'il reste privé, laissez le champ vide.
+ Pour partager avec tous les utilisateurs, sélectionnez **Tous les membres de votre organisation**.
1. Choisissez **Publier**.
Le connecteur apparaît dans le panneau **Disponible** avec l'état **Connecté**.
## Utilisation des actions disponibles
Après avoir configuré le connecteur, vous pouvez utiliser les actions en lecture seule suivantes pour accéder à vos données HubSpot CRM.
**HubSpot actions disponibles**
| Action | Description |
| --- | --- |
| Obtenir des objets CRM | Récupère plusieurs objets CRM du même type en une seule demande. |
| Obtenir des propriétés | Récupère les propriétés des objets CRM. |
| Obtenir les informations de l'utilisateur | Récupère les détails de l'utilisateur. |
| Rechercher des objets CRM | Effectue des recherches dans les objets CRM. |
| Propriétaires de recherche | Recherches auprès des propriétaires. |
| Propriétés de recherche | Effectue des recherches dans les propriétés. |
**Note**
Ce connecteur prend en charge les actions en lecture seule. Les actions que vous pouvez utiliser dépendent des étendues configurées dans votre HubSpot application.
## Résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).
### Résolution des problèmes d'authentification
+ **Sign-in échoue** — Vérifiez que votre HubSpot compte est actif et que vous pouvez vous connecter à la [page de HubSpot connexion](https://app.hubspot.com/login) sur le HubSpot site Web. Si votre organisation utilise l'authentification unique (SSO), vérifiez que votre fournisseur d'identité est correctement configuré.
+ **Accès refusé** — Vérifiez que votre HubSpot utilisateur possède un rôle d'administrateur autorisé à accéder aux données CRM. Vérifiez que l'ID client et le secret client de votre application sont corrects et que les étendues de lecture requises sont configurées.