Anpassen der Webhooks (BETA)

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:

• Gehen Sie in Ihrem HubSpot-Account zu Automatisierungen > 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

• 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

• 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“.