Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # HubSpot Integration Greifen Sie mit natürlicher Sprache direkt von Amazon Quick aus auf Ihre HubSpot CRM-Daten zu. Mit dem HubSpot Action Connector können Sie Kontakte, Unternehmen, Angebote und Tickets abrufen und auflisten, ohne Amazon Quick verlassen zu müssen. HubSpot ist als integrierter Connector in Amazon Quick verfügbar. Um diese Integration einzurichten, führen Sie die folgenden zwei Schritte aus. Bereiten Sie zunächst Ihr HubSpot Konto mit dem erforderlichen Zugriff vor. Erstellen Sie dann den Connector in Amazon Quick und authentifizieren Sie sich mit Ihren HubSpot Anmeldeinformationen. Dieser Connector unterstützt die benutzerdefinierte OAuth-App-Authentifizierung. Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unter[Authentifizierungsmethoden](quick-action-auth.md). ## Voraussetzungen Bevor Sie die Integration einrichten, stellen Sie sicher, dass Sie über die folgenden Ressourcen und den folgenden Zugriff verfügen. + Ein aktives HubSpot Konto mit einer Administratorrolle. + Berechtigungen für den Zugriff auf CRM-Daten wie Kontakte, Unternehmen, Angebote und Tickets in Ihrem HubSpot Konto. + Ein Abonnement, das die unter beschriebenen Anforderungen erfüllt[Integrationen in der Konsole einrichten](integration-console-setup-process.md). ## Verifizieren Sie Ihr Konto HubSpot Bevor Sie Amazon Quick konfigurieren, stellen Sie sicher, dass Ihr HubSpot Konto die folgenden Anforderungen erfüllt. + Ihr HubSpot Konto ist aktiv und Sie können sich auf der [HubSpot Anmeldeseite](https://app.hubspot.com/login) auf der HubSpot Website anmelden. + Die CRM-Daten, auf die Sie zugreifen möchten, einschließlich Kontakte, Unternehmen, Angebote und Tickets, sind für Ihr Konto zugänglich. ## Konfiguration Ihres HubSpot Kontos Für die benutzerdefinierte OAuth-App-Authentifizierungsmethode in Amazon Quick ist eine MCP Auth-App erforderlich, die in Ihren Entwicklereinstellungen konfiguriert ist. HubSpot ### Um eine MCP Auth App zu konfigurieren 1. Loggen Sie sich in Ihr HubSpot Konto ein. 1. Navigieren Sie zu **Development** und dann zu **MCP Auth Apps.** 1. Wählen Sie **Create MCP Auth App**. 1. Füllen **Sie im Fenster Create MCP Auth App die** folgenden Felder aus: + **Name** — Geben Sie einen Namen für Ihre App ein. + **Beschreibung** — Geben Sie eine kurze Beschreibung ein. + **URL umleiten** — Geben Sie ein`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. {{region}}Ersetzen Sie es durch Ihre AWS Region, zum Beispiel`us-east-1`. 1. Wählen Sie **Erstellen**. HubSpot erstellt die App und generiert eine Client-ID und einen geheimen Client-Schlüssel. **Wichtig** Notieren Sie das Client-Geheimnis und die Client-ID. Die Client-ID und der geheime Client-Schlüssel dienen als Client-ID und Client-Geheimnis, wenn Sie den Action-Connector in Amazon Quick mit der benutzerdefinierten OAuth-App-Authentifizierungsmethode konfigurieren. Weitere Informationen finden Sie unter [HubSpot MCP-Server auf der Website](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server). HubSpot ## Einrichtung der Integration in Amazon Quick Nachdem Sie Ihren HubSpot Kontozugriff verifiziert haben, erstellen Sie den Connector in Amazon Quick. 1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus. 1. Wählen Sie den Tab „**Für Ihr Team erstellen**“. 1. Wählen Sie **HubSpot**aus den verfügbaren Optionen. 1. Geben Sie im **HubSpot**Dialogfeld die folgenden Felder ein: + **Name** — Ein beschreibender Name für Ihren HubSpot Connector. + **Beschreibung (optional)** — Wählen Sie **\+ Beschreibung hinzufügen**, um Hinweise zur Verwendung dieses Connectors hinzuzufügen. + **Verbindungstyp** — Wählen Sie **Öffentliches Netzwerk**. 1. Geben Sie für die **benutzerdefinierte OAuth-App-Authentifizierungsmethode** die folgenden Felder ein: + **Basis-URL** — Dieses Feld wird automatisch ausgefüllt als`https://mcp.hubspot.com`. + **Client-ID** — Geben Sie die Client-ID aus Ihrer HubSpot MCP Auth App ein. + **Kundengeheimnis** — Geben Sie den geheimen Client-Schlüssel aus Ihrer HubSpot MCP Auth App ein. + **Token-URL** — Dieses Feld wird automatisch als `https://api.hubapi.com/oauth/v1/token` ausgefüllt. + **Autorisierungs-URL** — Dieses Feld wird automatisch als `https://app.hubspot.com/oauth/authorize` ausgefüllt. + **Weiterleitungs-URL** — Dieses Feld wird automatisch als `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback` ausgefüllt. 1. Wählen Sie **Weiter**, überprüfen Sie die Aktionen für HubSpot und wählen Sie dann erneut **Weiter**. 1. Geben Sie an, wer auf den Connector zugreifen kann: + Um mit einem Team zu teilen, geben Sie einen Teamnamen oder eine Gruppen-E-Mail ein. + Um es privat zu halten, lassen Sie das Feld leer. + Um es für alle Benutzer freizugeben, aktivieren Sie die Option **Jeder in Ihrer Organisation**. 1. Wählen Sie **Publish**. Der Connector wird im Bereich **Verfügbar** mit dem Status **Verbunden** angezeigt. ## Verfügbare Aktionen werden verwendet Nachdem Sie den Connector eingerichtet haben, können Sie die folgenden schreibgeschützten Aktionen verwenden, um auf Ihre HubSpot CRM-Daten zuzugreifen. **HubSpot verfügbare Aktionen** | Action | Description | | --- | --- | | Holen Sie sich CRM-Objekte | Ruft mehrere CRM-Objekte desselben Objekttyps in einer einzigen Anfrage ab. | | Ruft Eigenschaften ab | Ruft Eigenschaften für die CRM-Objekte ab. | | Ruft Benutzerdetails ab | Ruft Benutzerdetails ab. | | Sucht nach CRM-Objekten | Sucht in allen CRM-Objekten. | | Suchen Sie nach Eigentümern | Sucht nach Eigentümern. | | Suchen Sie nach Immobilien | Sucht nach Immobilien. | **Anmerkung** Dieser Konnektor unterstützt schreibgeschützte Aktionen. Die Aktionen, die Sie verwenden können, hängen von den in Ihrer App konfigurierten Bereichen ab. HubSpot ## Fehlerbehebung Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations). ### Lösung von Authentifizierungsproblemen + **Sign-in schlägt fehl** — Stellen Sie sicher, dass Ihr HubSpot Konto aktiv ist und Sie sich auf der [HubSpot Anmeldeseite](https://app.hubspot.com/login) der HubSpot Website anmelden können. Wenn Ihre Organisation Single Sign-On (SSO) verwendet, vergewissern Sie sich, dass Ihr Identitätsanbieter korrekt konfiguriert ist. + **Zugriff verweigert** — Vergewissern Sie sich, dass Ihr HubSpot Benutzer über eine Administratorrolle mit Berechtigungen für den Zugriff auf CRM-Daten verfügt. Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel in Ihrer App korrekt sind und dass die erforderlichen Lesebereiche konfiguriert sind.