Informationen zu den unterstützten Connectors für Application Integration.

HubSpot-Trigger

Vorschau — HubSpot trigger

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Der HubSpot-Trigger ist ein Connector-Ereignistrigger, mit dem Sie eine Integration basierend auf den benutzerdefinierten HubSpot-Ereignissen aufrufen können, die Sie in Ihrer HubSpot-Instanz definiert haben.

Wichtig:Integration Connectors ist eine kostenpflichtige Komponente von Google Cloud. Informationen zu den Kosten und Gebühren für die Verwendung von Integrations-Connectors finden Sie unter Preise für Integrations-Connectors.

Hinweise

Wenn Sie eine neue Verbindung für den HubSpot-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle (Identity and Access Management) für das Projekt:

• Connector-Administrator (roles/connectors.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den HubSpot-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Unterstützte Ereignistypen

Mit Webhook-Abos können Sie auswählen, welche Ereignisse Ihre App erhalten soll. Die folgenden Abotypen werden unterstützt:

• deal.creation
• deal.propertyChange
• deal.deletion
• contact.creation
• contact.propertyChange
• contact.deletion

Eine vollständige Liste der Ereignistypen finden Sie unter Webhook-Abos.

HubSpot-Trigger hinzufügen

So fügen Sie Ihrer Integration einen HubSpot-Trigger hinzu:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

   1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
      Hinweis:Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um eine Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element HubSpot-Trigger und platzieren Sie es im Integrationseditor.

Sie können den HubSpot-Trigger entweder mit einer vorhandenen HubSpot-Verbindung konfigurieren, die in Integration Connectors verfügbar ist, oder eine neue HubSpot-Verbindung mit der Option zum Erstellen einer Inline-Verbindung erstellen.

HubSpot-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den HubSpot-Trigger mit einer vorhandenen HubSpot-Verbindung in Integration Connectors konfigurieren. Der HubSpot-Trigger ist ein Connector-Ereignistrigger. Sie können den Trigger daher nur mit einer HubSpot-Verbindung mit aktiviertem Ereignisabo konfigurieren.

Informationen zum Konfigurieren eines HubSpot-Triggers mit einer neuen HubSpot-Verbindung finden Sie unter HubSpot-Trigger mit einer neuen Verbindung konfigurieren.

So konfigurieren Sie einen HubSpot-Trigger mit einer vorhandenen HubSpot-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element HubSpot-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Konfigurationsdetails an:
   1. Region:Wählen Sie die Region Ihrer HubSpot-Verbindung aus.
   2. Verbindung:Wählen Sie die HubSpot-Verbindung aus, die Sie verwenden möchten.

      In der Anwendungsintegration werden nur die HubSpot-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

   3. Ereignistyp:Wählen Sie den Ereignistyp aus, mit dem Sie die Integration auslösen möchten. Eine Liste der unterstützten Ereignistypen finden Sie unter Unterstützte Ereignistypen.
   4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den HubSpot-Trigger aus.
4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

HubSpot-Trigger mit einer neuen Verbindung konfigurieren

So konfigurieren Sie den HubSpot-Trigger mit einer neuen HubSpot-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element HubSpot-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Überspringen Sie das Feld Region.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
   1. Wählen Sie im Schritt Standort den Standort für die neue HubSpot-Verbindung aus:
      1. Region:Wählen Sie eine Region aus der Drop-down-Liste aus.
      2. Klicken Sie auf Weiter.
   2. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
      1. Connector: Wählen Sie HubSpot aus der Drop-down-Liste der verfügbaren Connectors aus.
      2. Connector-Version: Wählen Sie die Connector-Version aus der Drop-down-Liste der verfügbaren Versionen aus.
      3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein.

         Verbindungsnamen müssen die folgenden Kriterien erfüllen:

         • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
         • Buchstaben müssen Kleinbuchstaben sein.
         • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
         • Verbindungsnamen dürfen maximal 49 Zeichen haben.
         • Bei Konnektoren, die Ereignisanmeldungen unterstützen, dürfen die Verbindungsnamen nicht mit dem Präfix „goog“ beginnen.
      4. Geben Sie optional unter Beschreibung eine Beschreibung für die Verbindungsinstanz ein.
      5. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
      6. Wenn Sie die Verbindung für Ereignisabos verwenden möchten, wählen Sie Ereignisabo aktivieren aus. Wenn Sie diese Option auswählen, werden die folgenden Optionen angezeigt:
         • Ereignisabo mit Entität und Aktionen aktivieren: Wählen Sie diese Option aus, um die Verbindung sowohl für Ereignisabos als auch für Connector-Vorgänge (Entitäten und Aktionen) zu verwenden.
         • Nur Ereignisabo aktivieren: Wählen Sie diese Option aus, wenn Sie die Verbindung nur für das Ereignisabo verwenden möchten. Wenn Sie diese Option auswählen, klicken Sie auf Weiter und dann auf Ereignisanmeldung konfigurieren.
      7. Schema: Geben Sie die zu verwendende HubSpot API-Version an. HubSpotV4 ist die neue API.
      8. BrowsableSchemas: Dieses Attribut schränkt die Schemas ein, die auf eine Teilmenge der verfügbaren Schemas gemeldet werden. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.
      9. Kontakteigenschaften: Geben Sie die kommagetrennten Feldnamen der Contacts-Entität ein, die Sie aus dem List-Entitätsvorgang auswählen möchten. Beispiel: fieldA, fieldB, fieldC
      10. Unternehmenseigenschaften: Geben Sie die kommagetrennten Feldnamen der Companies-Entität ein, die Sie aus dem List-Entitätsvorgang auswählen möchten. Beispiel: fieldA, fieldB, fieldC
      11. Deals-Properties: Geben Sie die kommagetrennten Feldnamen der Deals-Entität ein, die Sie aus dem List-Entitätsvorgang auswählen möchten. Beispiel: fieldA, fieldB, fieldC
      12. Proxy verwenden: Klicken Sie dieses Kästchen an, um einen Proxyserver für die Verbindung zu konfigurieren.
      13. Proxy Auth Scheme: Der Authentifizierungstyp, der für die Authentifizierung beim ProxyServer-Proxy verwendet werden soll.
      14. Proxy-Nutzer: Ein Nutzername, der für die Authentifizierung beim ProxyServer-Proxy verwendet werden soll.
      15. Proxy-Passwort: Ein Passwort, das für die Authentifizierung beim ProxyServer-Proxy verwendet wird.
      16. Proxy-SSL-Typ: Der SSL-Typ, der beim Herstellen einer Verbindung zum ProxyServer-Proxy verwendet werden soll.
      17. Optional: Konfigurieren Sie die Verbindungsknoteneinstellungen:
          • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
          • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

          Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

      Hinweis: Sie können die Verbindungsknotenwerte nur anpassen, wenn Sie ein „Pay as you go”-Kunde sind.
      18. Klicken Sie optional auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      19. Klicken Sie auf Weiter.
   3. Geben Sie im Abschnitt Ziele die Details zum Remote-Host (Backend-System) ein, zu dem Sie eine Verbindung herstellen möchten.
      1. Zieltyp: Sie können die Zieldetails entweder als Hostadresse oder als Dienstanhang angeben. Wählen Sie einen der folgenden Zieltypen aus:
         • Hostadresse: Wenn Sie den Hostnamen oder die IP-Adresse des Ziels angeben möchten.
         • Dienstanhang: Wenn Sie den privaten Endpunkt für Ihre internen IP-Adressen angeben möchten. Mit dem Dienstanhang können Sie Ihre internen IP-Adressen vor dem externen Netzwerk verbergen. Mit dem Private Service Connect-Feature haben Sie die Möglichkeit, in Google Cloud einen Dienstanhang zu erstellen. Informationen zum Konfigurieren von Private Service Connect finden Sie unter Verwaltete Dienste veröffentlichen.

         Geben Sie je nach ausgewähltem Zieltyp die Hostadresse oder den Namen des Dienstanhangs ein.

         Wenn Sie weitere Ziele eingeben möchten, klicken Sie auf + Ziel hinzufügen.

      2. Klicken Sie auf Weiter.
   4. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
      1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

         Die folgenden Authentifizierungstypen werden von der HubSpot-Verbindung unterstützt:

         • Zugriffstoken für private App : Wählen Sie das Secret Manager-Secret mit dem Zugriffstoken für die private App aus.

           Mit privaten Apps können Sie über die APIs von HubSpot auf bestimmte Daten in Ihrem HubSpot-Konto zugreifen. Sie können zulassen, was jede private App in Ihrem Konto anfordern oder ändern darf. Dadurch wird ein Zugriffstoken generiert, das nur für Ihre private App gilt. Achten Sie darauf, dass Sie in Ihrer privaten App die Leseberechtigung für mindestens die folgenden Bereiche angegeben haben:

           • crm.schemas.line_items.read
           • crm.schemas.quotes.read
           • crm.schemas.deals.read
           • crm.schemas.companies.read
           • crm.schemas.custom.read
           • crm.schemas.contacts.read

           Weitere Informationen finden Sie unter Private Apps.

      2. Klicken Sie auf Weiter.
   5. Wenn Sie das Ereignisabo aktiviert haben, wird auf der Seite zum Erstellen einer Verbindung der Abschnitt Details zum Ereignisabo angezeigt. Geben Sie im Schritt Details zum Ereignisabo die Authentifizierungsdetails an, die zum Validieren der HubSpot-Tokennutzlast verwendet werden:
      1. Client-Secret:Optional. Wählen Sie das Secret Manager-Secret des Client-Secrets Ihrer privaten App und die entsprechende Secret-Version aus dem Drop-down-Menü Secret-Version aus.

      Weitere Informationen finden Sie unter Private Apps.

      2. Wählen Sie Private Konnektivität aktivieren für eine sichere Verbindung zwischen Ihrer Backend-Anwendung und Ihrer Verbindung aus. Wenn Sie diese Option auswählen, müssen Sie nach dem Erstellen der Verbindung zusätzliche Konfigurationsschritte ausführen. Weitere Informationen finden Sie unter Private Verbindung für Ereignisabonnements.
      3. Geben Sie die Konfiguration für den Postfach-Alias ein. Wenn Sie ein Dead-Letter-Thema konfigurieren, schreibt die Verbindung die nicht verarbeiteten Ereignisse in das angegebene Pub/Sub-Thema. Geben Sie die folgenden Informationen ein:
         1. Dead-Letter-Projekt-ID : Die Google Cloud-Projekt-ID, in der Sie das Dead-Letter-Pub/Sub-Thema konfiguriert haben.
         2. Dead-Letter-Thema : Das Pub/Sub-Thema, in das Sie die Details des nicht verarbeiteten Ereignisses schreiben möchten.
      4. Klicken Sie auf Weiter.
   6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
   7. Klicken Sie auf Erstellen.

Webhook-Abos erstellen und bearbeiten

Um die Konfiguration des Ereignisabos abzuschließen, müssen Sie die Webhook-URL in Ihrer HubSpot-Anwendung registrieren. Führen Sie daher nach dem Erstellen der Verbindung die folgenden zusätzlichen Schritte aus:

1. Rufen Sie die Seite mit den Verbindungsdetails der neu erstellten Verbindung auf und kopieren Sie die Webhook-URL für das Ereignisabo. Die Webhook-URL ist erforderlich, wenn Sie im nächsten Schritt ein Webhook-Abo erstellen.

   Die folgende Abbildung zeigt das Feld Ereignis-Listener-Endpunkt auf der Seite mit den HubSpot-Verbindungsdetails:

   
2. Weitere Informationen zum Erstellen und Bearbeiten von Webhook-Abos in HubSpot

Trigger-Ausgabe

Bei Verwendung des HubSpot-Triggers dauert es einige Minuten, bis die Konfiguration des Ereignisabonnements abgeschlossen ist. Den Status Ihres Ereignisabonnements finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabonnement.

Der HubSpot-Trigger gibt den Status eines Ereignis-Abos anhand der folgenden Status an:

• Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• Active: Gibt an, dass für den Trigger ein Ereignisabo abonniert wurde.
• Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Im Bereich Details zum Ereignisabo werden neben dem Status des Ereignisabos auch weitere Details wie die Verbindungsregion, der Verbindungsname und der Name des Ereignisabos angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout für den Konfigurationsbereich für HubSpot-Trigger:

Trigger-Ausgabevariable

Für jedes Ereignis generiert der HubSpot-Trigger eine ConnectorEventPayload-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable ist im JSON-Format und enthält das HubSpot-Nutzlastschema.

Ereignisabos ansehen

So rufen Sie alle Ereignisabonnements auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

1. Rufen Sie die Seite Integration Connectors > Verbindungen auf.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, für die Sie die Abos ansehen möchten.
3. Klicken Sie auf den Tab Ereignisabos.

   Daraufhin werden alle Ereignisabonnements für die Verbindung angezeigt.

HubSpot-Trigger bearbeiten

Sie können einen HubSpot-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignisabo zu ändern oder zu aktualisieren.

Wichtig:Wenn Sie einen HubSpot-Trigger bearbeiten oder ändern, können Sie das zuvor konfigurierte Ereignisabo, das mit dem Trigger verknüpft ist, entweder beibehalten oder löschen. Das Löschen eines Ereignisabos wirkt sich auf alle veröffentlichten Integrationen aus, die dieses Ereignisabo verwenden.

So bearbeiten Sie einen HubSpot-Trigger:

1. Klicken Sie im Integrationseditor auf das Element HubSpot-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf HubSpot-Trigger konfigurieren.
3. Führen Sie auf der Seite Connector-Ereignistrigger-Editor die folgenden Schritte aus:
   1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
      Warnung:Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, die das Ereignisabo verwenden. Diese Aufgabe kann nicht rückgängig gemacht werden.
   2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignisabo nach Bedarf.
   3. Klicken Sie auf Fertig.

Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.