Webhooks mit HubSpot-Workflows verwenden

Verwenden Sie Webhooks in Workflows zum Senden oder Abrufen von Informationen zwischen HubSpot und anderen externen Tools. Es gibt eine Vielzahl von Verwendungszwecken für Webhooks. Beispiele für beliebte Anwendungsfälle für Webhooks:

• Senden von HubSpot-Kontaktdaten an ein anderes System, zum Beispiel CRM, wenn der betreffende Kontakt ein bestimmtes Formular auf Ihrer Website ausfüllt.

• Senden von Deal-Daten an ein Versandabwicklungssystem, um eine Bestellung zu erstellen.

• Abrufen von Daten aus einem anderen System zur Aktualisierung Ihrer HubSpot-Datensätze.

Sie können sowohl POST- als auch GET-Anfragen mithilfe von Workflows senden. HubSpot reguliert Webhook-Traffic separat von anderen Workflow-Prozessen. Dies geschieht, um die Workflow- und Webhook-Performance zu optimieren. Wenn ein Webhook langsam ist oder abläuft, kann die Ausführung der Workflow-Aktion länger als erwartet dauern.

Bitte beachten: HubSpot versucht für bis zu drei Tage, fehlgeschlagene Webhooks erneut auszuführen, und beginnt damit eine Minute nach dem Fehler. Nachfolgende fehlgeschlagene Webhooks werden in größeren Intervallen mit einer maximalen Lücke von acht Stunden versucht, erneut auszuführen. Workflows versuchen es nicht erneut, nachdem sie Antwort-Statuscodes der Serie 4XX erhalten haben.
Eine Ausnahme von dieser Regel sind 429-Ratenbeschränkungsfehler; Workflows versuchen es automatisch erneut, nachdem sie eine 429-Antwort erhalten haben, und beachten die Kopfzeile Retry-After, falls vorhanden. "Retry-After wird in Millisekunden aufgezeichnet. Erfahren Sie mehr über spezielle Fehlercode-Ausnahmen in der Dokumentation für Entwickler von HubSpot.

Erfahren Sie mehr über Webhooks in der Dokumentation für Entwickler. In den HubSpot-Entwicklerforen erhalten Sie Antworten auf Fragen zu Ihrer spezifischen Implementierung von Webhooks in HubSpot.

Einrichten einer POST-Anfrage

1. Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
2. Um einen vorhandenen Workflow zu bearbeiten, klicken Sie auf den Namen des Workflows. Oder erstellen Sie einen neuen Workflow .
3. Klicken Sie im Workflow-Editor auf das + Plus-Symbol, um eine Aktion hinzuzufügen.
4. Wählen Sie im linken Bereich im Abschnitt Data ops die Option Webhook senden.
    

5. Klicken Sie auf das Dropdown-Menü Methode und wählen Sie POST.
6. Geben Sie die Webhook-URL ein.
   • Webhook-URLs sind auf sichere Protokolle beschränkt und müssen mit HTTPS beginnen.
   • Um spezifische Informationen anzufordern, können Sie der Webhook-URL Abfrageparameter wie ?queryparameter=abc hinzufügen.
   • Wenn keine Abfrageparameter hinzugefügt wurden, wird eine generische POST- oder GET-Anfrage gesendet.
7. Richten Sie Ihren Authentifizierungstyp ein, um Anfragen an Ihren Webhook zu authentifizieren. Sie können entweder eine Anfragesignatur in Ihrer Webhook-Kopfzeile oder einen API-Schlüssel verwenden:
   • So verwenden Sie eine Anfragesignatur in Ihrem Webhook-Header:
     • Klicken Sie auf das Dropdown-Menü „Authentifizierungstyp“. Wählen Sie dann Anfragesignatur in Header berücksichtigen aus.
     • Geben Sie dann Ihre HubSpot App-ID ein. Erfahren Sie, wie Sie Anfragesignaturen verifizieren.
   • Zur Verwendung eines API-Schlüssels oder einer öffentlichen App, die über einen Developer Account erstellt wurde, zur Authentifizierung:
     • Bei der Verwendung eines API-Schlüssels zur Authentifizierung hängen der API-Schlüsselname und der Speicherort des API-Schlüssels davon ab, wie der Webhook konfiguriert ist. Aus Sicherheitsgründen wird der API-Schlüssel bei Testanfragen nicht angezeigt. So verwenden Sie einen API-Schlüssel:
       • Klicken Sie auf das Dropdown-Menü „Authentifizierungstyp“. Wählen Sie dann API-Schlüssel aus.
       • Geben Sie den Namen Ihres API-Schlüssels ein.
       • Klicken Sie auf das Dropdown-Menü Speicherort des API-Schlüssels . Wählen Sie dann entweder "Abfrageparameter" oder "Anfrage-Header" aus. Erfahren Sie mehr über die Verwendung von API-Schlüsseln in HubSpot .
     • Wenn Sie eine Anfrage an HubSpot-APIs durchführen:
       • Klicken Sie auf das Dropdown-Menü „API-Schlüssel“ und wählen Sie ein Geheimnis aus. Der Geheimnis-Wert muss das Format Bearer [YOUR_TOKEN] haben.
       • Legen Sie den Wert für den API-Schlüsselnamen auf „Autorisierung“ fest.
       • Legen Sie den Wert für den Speicherort des API-Schlüssels auf Anfrage-Header fest.
8. Um alle Eigenschaften zu berücksichtigen, wählen Sie Alle Eigenschaften berücksichtigen [Objekt].
9. So berücksichtigen Sie nur bestimmte Eigenschaften:
   • Wählen Sie Anforderungsstext anpassen.
   • Um den Anforderungstext mithilfe einer HubSpot-Eigenschaft anzupassen, geben Sie den Key ein und wählen Sie eine Eigenschaftaus. Klicken Sie auf „Eigenschaft hinzufügen“, um eine weitere Eigenschaft hinzuzufügen.
   • Um den Anforderungstext über ein statisches Feld anzupassen, geben Sie den Schlüssel und Wertein. Um eine weitere Eigenschaft hinzuzufügen, klicken Sie auf Statischen Wert hinzufügen.
   • Um eine Eigenschaft oder einen statischen Wert zu entfernen, klicken Sie auf das Papierkorb-Symbol delete .
10. Klicken Sie auf Speichern.

Bitte beachten: Um mehrere Ausgaben auszuwählen, sollte die Antwort als JSON-Objekt strukturiert sein.

Setup einer GET-Anfrage

1. Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
2. Um einen vorhandenen Workflow zu bearbeiten, klicken Sie auf den Namen des Workflows. Oder erstellen Sie einen neuen Workflow .
3. Klicken Sie im Workflow-Editor auf das + Plus-Symbol, um eine Aktion hinzuzufügen.
4. Wählen Sie im linken Bereich im Abschnitt Data ops die Option Webhook senden.
    

5. Klicken Sie auf das Dropdown-Menü Methode und wählen Sie GET.
6. Geben Sie die Webhook-URL ein.
   • Webhook-URLs sind auf sichere Protokolle beschränkt und müssen mit HTTPS beginnen.
   • Um spezifische Informationen anzufordern, können Sie der Webhook-URL Abfrageparameter wie ?queryparameter=abc hinzufügen.
   • Wenn keine Abfrageparameter hinzugefügt wurden, wird eine generische POST- oder GET-Anfrage gesendet.
7. Richten Sie Ihren Authentifizierungstyp ein, um Anfragen an Ihren Webhook zu authentifizieren. Sie können entweder eine Anfragesignatur in Ihrer Webhook-Kopfzeile oder einen API-Schlüssel verwenden:
   • So verwenden Sie eine Anfragesignatur in Ihrem Webhook-Header:
     • Klicken Sie auf das Dropdown-Menü „Authentifizierungstyp“. Wählen Sie dann Anfragesignatur in Header berücksichtigen aus.
     • Geben Sie dann Ihre HubSpot App-ID ein. Erfahren Sie, wie Sie Anfragesignaturen verifizieren.
   • Zur Verwendung eines API-Schlüssels oder einer öffentlichen App, die über einen Developer Account erstellt wurde, zur Authentifizierung:
     • Bei der Verwendung eines API-Schlüssels zur Authentifizierung hängen der API-Schlüsselname und der Speicherort des API-Schlüssels davon ab, wie der Webhook konfiguriert ist. Aus Sicherheitsgründen wird der API-Schlüssel bei Testanfragen nicht angezeigt. So verwenden Sie einen API-Schlüssel:
       • Klicken Sie auf das Dropdown-Menü „Authentifizierungstyp“. Wählen Sie dann API-Schlüssel aus.
       • Geben Sie den Namen Ihres API-Schlüssels ein.
       • Klicken Sie auf das Dropdown-Menü Speicherort des API-Schlüssels . Wählen Sie dann entweder "Abfrageparameter" oder "Anfrage-Header" aus. Erfahren Sie mehr über die Verwendung von API-Schlüsseln in HubSpot .
     • Wenn Sie eine Anfrage an HubSpot-APIs durchführen:
       • Klicken Sie auf das Dropdown-Menü „API-Schlüssel“ und wählen Sie ein Geheimnis aus. Der Geheimnis-Wert muss das Format Bearer [YOUR_TOKEN] haben.
       • Legen Sie den Wert für den API-Schlüsselnamen auf „Autorisierung“ fest.
       • Legen Sie den Wert für den Speicherort des API-Schlüssels auf Anfrage-Header fest.
8. Wenn Sie eine GET-Anfrage einrichten, können Sie entweder HubSpot-Eigenschaften verwenden oder statische Werte als Abfrageparameter hinzufügen: 

9. So verwenden Sie eine HubSpot-Eigenschaft als Abfrageparameter:
   • Geben Sie im Abschnitt Abfrageparameter den Schlüssel ein und wählen Sie dann eine Eigenschaft aus.
   • Klicken Sie auf „Eigenschaft hinzufügen“, um eine weitere Eigenschaft hinzuzufügen.
   • Um eine Eigenschaft zu entfernen, klicken Sie auf das delete Papierkorb-Symbol.
10. Um einen statischen Wert als Abfrageparameter zu verwenden:
    • Geben Sie unter dem Abschnitt Abfrageparameter den Schlüssel ein, und geben Sie dann einen Wert ein.
    • Um eine weitere Eigenschaft hinzuzufügen, klicken Sie auf Statischen Wert hinzufügen.
    • Um eine Eigenschaft zu entfernen, klicken Sie auf das delete Papierkorb-Symbol.
11. Klicken Sie auf Speichern.

Festlegen einer Ratenbegrenzung für für Ihren Webhook (BETA)

Legen Sie eine Ratenbegrenzung fest, um zu bestimmen, wie schnell die Webhook-Aktion ausgeführt werden soll. Die Ratenbegrenzung wirkt sich auch auf alle folgenden Aktionen im Workflow aus.

1. Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
2. Klicken Sie auf den Namen des Workflows.
3. Klicken Sie im Workflow-Editor auf die Aktion Einen Webhook senden.
4. Klicken Sie im linken Bereich auf Ratenbegrenzung konfigurieren, um den Abschnitt zu erweitern.
5. Klicken Sie auf den Schalter Ratenbegrenzung aktivieren , um ihn zu aktivieren. Standardmäßig ist diese Einstellung deaktiviert. 
6. Richten Sie Ihre API-Ratenbegrenzung ein: 
   • Aktionsausführungen: Legen Sie die maximale Anzahl von Ausführungen pro Zeitraum fest. 
   • Zeitrahmen: Legen Sie den Zeitrahmen für Ihre Ratenbegrenzung fest. Sie können diesen Zeitraum auf Sekunden, Minuten oder Stunden festlegen. 

Testen Sie Ihren Webhook in HubSpot

Wenn Sie Ihren POST- oder GET-Webhook einrichten, können Sie einen Test ausführen, um die Webhook-Antwort anzuzeigen. Während des Tests werden zwar Daten an einen Dritten gesendet und von diesem abgerufen, bestehende Datensätze in HubSpot sind davon jedoch nicht betroffen. Wenn Sie einen API-Schlüssel zur Authentifizierung verwenden, wird der API-Schlüssel in Testanfragen nicht angezeigt.

Nachdem Sie Ihren Webhook getestet haben, können Sie auswählen, welche Felder Sie ausgeben möchten, um sie später in Ihrem Workflow als Eingaben zu nutzen. Wählen Sie nur Ausgänge aus, die in jeder Antwort verfügbar sind. Wenn die Ausgabe in einer späteren Aktion verwendet wird, in der Antwort jedoch nicht verfügbar ist, schlägt die Aktion fehl.

1. Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
2. Klicken Sie auf den Namen des Workflows.
3. Klicken Sie im Workflow-Editor auf die Aktion Einen Webhook senden.
4. Klicken Sie im linken Bereich auf Aktion testen, um den Abschnitt zu erweitern.
5. Wenn Sie eine POST-Anfrage testen, unterscheidet sich die Einrichtung des Webhook-Tests je nachdem, ob Sie Anfragetext anpassen oder die Aktion Alle [Objekt]-Eigenschaften in den Webhook einbeziehen gewählt haben.
   • Wenn Sie Anfragetext anpassen ausgewählt haben, geben Sie die Testwerte für die Eigenschaft für Ihren Test ein.
   • Wenn Sie Alle [Objekt]-Eigenschaften berücksichtigen ausgewählt haben, klicken Sie auf das [ Objekt ]-Dropdown-Menü und wählen Sie dann einen Datensatz aus, mit dem getestet werden soll.
6. Klicken Sie auf „Testen“.
7. Um die Details des Webhooks zu überprüfen, wählen Sie die Registerkarte „Antwort“ oder „Anfrage“ aus. Auf jeder Registerkarte können Sie auf Alle öffnen , um alle Abschnitte zu erweitern, oder auf Alle einklappen , um alle Abschnitte auszublenden, klicken.
   • Klicken Sie auf der Registerkarte „Antwort“ auf headers: oder body:, um die einzelnen Abschnitte zu erweitern.
   • Klicken Sie auf der Registerkarte „Anfrage“ auf httpHeaders:, um den Abschnitt zu erweitern.
     
     

Webhook extern testen

Nachdem Sie Ihren Workflow mit einer Webhook-Aktion erstellt haben, können Sie einen Schnelltest mit einem Webhook-URL-Dummy durchführen.

1. Gehen Sie in Ihrem Browser zu https://Webhook.site und kopieren Sie die eindeutige URL.
2. Fügen Sie in der Webhook-Aktion im Feld Webhook-URL die URL ein.
3. Sobald Ihr Workflow aktiviert ist, können Sie manuell einen Testkontakt aufnehmen.
   
   

4. Wenn Sie Ihren Webhook extern testen:
   • Wird eine Webhook-Aktion mit einer POST-Anfrage ausgelöst, wird ein JSON-Antworttext an den Webhook gesendet, der alle Informationen zum Kontakt enthält, einschließlich Formulareinsendungen, Listenmitgliedschaften und alle Kontakteigenschaftswerte. Das empfangene System kann die JSON-Daten dann analysieren und für seine eigene Anwendung verwenden.
   • Wenn eine Webhook-Aktion mit einer GET-Anfrage ausgelöst wird, wird eine generische GET-Anfrage gesendet, sofern keine zusätzlichen Abfrageparameter angegeben wurden.

Bitte beachten: Vorherige Eigenschaftswerte werden nur in kontaktbasierten Workflows zurückgegeben. In allen anderen Workflow-Typen verwendete Webhooks geben nur den letzten Wert zurück.

Anfragesignaturen in Workflow-Webhooks verifizieren

Wenn Sie im Abschnitt Authentifizierung für Ihre Aktion "Eine Webhook auslösen " die Option "Anfragesignatur " ausgewählt haben, füllt HubSpot die Webhook mit einem X-HubSpot-Signatur-Header mit einem SHA-256-Hash der Verkettung des App-Geheimnisses für Ihre Anwendung, der HTTP-Methode, dem URI und dem ungeparsten Text aus. Erfahren Sie mehr darüber in der Entwicklerdokumentation.

Um zu überprüfen, ob die unter Ihrer URL empfangenen Anfragen von HubSpot stammen:

• Ein Entwicklerkonto besitzen. Wenn Sie keines haben, melden Sie sich für einen Entwickler-Account an.
• Eine App besitzen Wenn Sie keine App haben, lernen Sie, wie man eine App erstellt.
• Überprüfen Sie den Hash-Wert der Signatur.

Workflows von Webhooks triggern

Webhooks können zum Triggern von Workflows verwendet werden. Wenn sich Daten in einer Drittanbieter-App ändern, kann dies einen Workflow auslösen. Erfahren Sie mehr über Triggern von Workflows über Webhooks.

Webhook-Daten im Daten-Panel verwenden

Daten aus dem mit Ihrem Account verbundenen Webhook können für bestimmte Aktionen im Datenpanel verwendet werden.

So verwenden Sie Daten aus dem mit verbundenen Webhook:

1. Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
2. Klicken Sie auf den Namen Ihres Workflows.
3. Klicken Sie auf das + Plus-Symbol, um eine Aktion hinzuzufügen.
4. Wählen Sie im linken Bereich eine Aktion aus, die den Datenbereich verwendet.
5. Klicken Sie im Daten-Panel auf Eigenschaften oder Aktionsausgänge aus dem Dropdown-Menü anzeigen und wählen Sie Webhook triggern. Sie können dann Eigenschaften aus dem verbundenen Webhook verwenden.