Zum Hauptinhalt
Hinweis: Dieser Artikel wird aus Kulanz zur Verfügung gestellt. Er wurde automatisch mit einer Software übersetzt und unter Umständen nicht korrekturgelesen. Die englischsprachige Fassung gilt als offizielle Version und Sie können dort die aktuellsten Informationen finden. Hier können Sie darauf zugreifen.

Anpassen der Webhooks (BETA)

Zuletzt aktualisiert am: Juni 20, 2023

Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):

Operations Hub Professional, Enterprise

Wenn Sie Webhooks in Workflows verwenden, um POST- oder GET-Anfragen aus Ihren Workflows zu senden, können Sie Ihre Webhooks anpassen, um die gesendeten und empfangenen Daten zu steuern.

In Ihren POST-Anforderungen können Sie die Eigenschaften angeben, die an externe Systeme, wie z. B. ein CRM, gesendet werden. In ähnlicher Weise können Sie in Ihren GET-Anfragen die gewünschten Eigenschaften durch Abfrageparameter angeben. 

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

Bitte beachten Sie: HubSpot wird fehlgeschlagene Webhooks bis zu drei Tage lang wiederholen, beginnend eine Minute nach dem Fehlschlag. Nachfolgende fehlgeschlagene Webhooks werden in größeren Intervallen mit einer maximalen Lücke von acht Stunden versucht, erneut auszuführen. Erfahren Sie mehr über spezielle Fehlercode-Ausnahmen in der Entwicklerdokumentation von HubSpot.

Einrichten Ihres Webhooks

Zum Erstellen und Anpassen Ihrer Webhooks:

  • Klicken Sie in Ihrem HubSpot-Account auf Automatisierung und dann auf Workflows.
  • Klicken Sie auf den Namen des Workflows.
  • Klicken Sie auf das Plus-Symbol (+), um eine Aktion hinzuzufügen.
  • Wählen Sie im rechten Bereich „Webhook senden“ aus.
  • Klicken Sie auf das Dropdown-Menü „Methode“ und wählen Sie dann POST oder GET aus. 
  • 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 Abfrageparameter wie ?queryparameter=abc zur Webhook-URLhinzufügen. Wenn keine Abfrageparameter hinzugefügt wurden, wird eine generische POST- oder GET-Anfrage gesendet. 
  • Richten Sie Ihren Authentifizierungstyp ein, um Anfragen an Ihren Webhook zu authentifizieren: 
    • 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 man Anfragesignaturen überprüft.
    • Sie können auch einen API-Schlüssel zur Authentifizierung verwenden. 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ü für den API-Schlüssel. Wählen Sie dann entweder „Abfrageparameter“ oder „Anfrage-Header“ aus. Erfahren Sie mehr über die Verwendung von API-Schlüsseln in HubSpot.

POST-Anfrage anpassen

Wenn Sie eine POST-Anfrage einrichten, können Sie wählen, ob Sie alle Eigenschaften des CRM-Datensatzes einbeziehen oder nur bestimmte Eigenschaften senden möchten:
  • Um alle Eigenschaften einzubeziehen, wählen Sie unter dem Abschnitt „Anfragetext anpassen“ die Option „Alle Eigenschaften berücksichtigen“
  • So berücksichtigen Sie nur bestimmte Eigenschaften:
    • Wählen Sie unter dem Abschnitt „Anfragetext anpassen“ die Option „Spezifische Eigenschaften auswählen“ aus.
    • Klicken Sie auf das Dropdown-Menü „Eigenschaft auswählen“. Klicken Sie dann auf „[Objekt] in diesem Workflow“ und wählen Sie eine Eigenschaft aus.
    • Um den Namen einer Eigenschaft im Webhook zu ändern, bearbeiten Sie das Textfeld „Eigenschaftsname“. Dadurch wird nur der Eigenschaftsname in der POST-Anfrage aktualisiert, nicht aber der Eigenschaftsname oder der interne Name in HubSpot. 
    • Klicken Sie auf „Eigenschaft hinzufügen“, um eine weitere Eigenschaft hinzuzufügen.
    • Um eine Eigenschaft zu entfernen, klicken Sie auf das delete Papierkorb-Symbol.
       


Ihre GET-Anfragen anpassen

Wenn Sie eine GET-Anfrage einrichten, können Sie Eigenschaften als Abfrageparameter verwenden, um bestimmte Daten abzurufen: 
  • Klicken Sie unter dem Abschnitt „Abfrageparameter“ auf das Dropdown-Menü „Eigenschaft auswählen“. Klicken Sie dann auf „[Objekt] in diesem Workflow“ und wählen Sie eine Eigenschaft aus.
  • Um den Namen einer Eigenschaft im Abfrageparameter zu ändern, bearbeiten Sie das Textfeld „Eigenschaftsname“. Dadurch wird nur der Eigenschaftsname in der GET-Anfrage aktualisiert, nicht aber der Eigenschaftsname oder der interne Name in HubSpot. 
  • Klicken Sie auf „Abfrageparameter hinzufügen“, um eine weitere Eigenschaft hinzuzufügen.
  • Um eine Eigenschaft zu entfernen, klicken Sie auf das delete Papierkorb-Symbol
  • Klicken Sie auf „Speichern“.


War dieser Artikel hilfreich?
Dieses Formular wird nur verwendet, um Feedback zur Dokumentation zu sammeln. Erfahren Sie, wie Sie Hilfe bei Fragen zu HubSpot erhalten können.