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.
Workflows

Webhooks mit HubSpot-Workflows verwenden

Zuletzt aktualisiert am: April 17, 2019

Produkte/Lizenzen

Marketing Hub  Enterprise
Sales Hub  Enterprise
Service Hub  Enterprise

Verwenden Sie Webhooks in Workflows, um Informationen von HubSpot in eine andere Webanwendung weiterzugeben.

Bitte beachten: Marketing Hub Professional Konten oder Sales Hub Professional Sitze, die vor dem 1. November 2018 gekauft wurden, haben Legacy-Zugriff auf den Trigger a webhook wworkflow action. 


Webhooks verstehen

Webhooks senden Daten von einer Webanwendung zur anderen, nachdem eine Aktion in der Quellanwendung abgeschlossen wurde. Mit Webhooks können Sie Daten, Benachrichtigungen, Warnungen oder sonstige Echtzeit-Aktualisierungen senden.

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 Kontaktdaten an ein externes System, das eine Testversion der Software für den Kontakt erstellt.

  • Chat-Warnungen, die von Ihrem externen System an den Chat-Stream Ihres Unternehmens gesendet werden, damit die Mitarbeiter damit über ein wichtiges Geschehnis informiert werden.

 

 Einen webhook in Ihrem workflow einrichten

  • Gehen Sie in Ihrem HubSpot-Account zu Automatisierung > Workflows.
  • Klicken Sie auf den Namen des Workflow.
  • Klicken Sie auf das Plus-Symbol (+), um eine Aktion hinzuzufügen.
  • Klicken Sie im rechten Fenster auf Webhook auslösen.
  • Geben Sie die Webhook-URL ein.

Bitte beachten: Webhook-URLs sind auf sichere Protokolle beschränkt und müssen mit HTTPS beginnen.

  • Aktivieren Sie das Kontrollkästchen Use Request Signature, um alle Anfragen an Ihren Webhook zu authentifizieren, und geben Sie Ihre App ID ein. Erfahren Sie, wie man Anfragesignaturen überprüft.
  • Klicken Sie auf Speichern.

Bitte beachten: das Trigger a webhook action unterstützt nur die POST-Methode.

 

Webhook testen

Nachdem Sie Ihren Workflow mit einer Webhook-Aktion erstellt haben, können Sie einen Schnelltest mit einem Webhook-URL-Dummy durchführen. Gehen Sie In Ihrem Browser zu https://webhook.site und kopieren Sie die eindeutige URL, die automatisch erstellt wird. Fügen Sie in der Webhook-Aktion im Feld Webhook-URL die URL ein.

Das folgende Beispiel zeigt den Request Body des obigen Webhook, der Metainformationen über den spezifischen Kontakt enthält, einschließlich Kontaktinformationen, Formularvorlagen, Listenmitgliedschaften, etc. Wenn die Workflow-Aktion ausgelöst wurde, hat HubSpot den gesamten Datensatz des Kontakts in JSON in der angegebenen URL gesendet.

Beispielscreenshot

Das empfangene System kann die JSON-Daten dann analysieren und für seine eigene Anwendung verwenden.

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.

 

Überprüfen von Antragssignaturen in Workflow-Webhooks

Wenn Sie Signatur anfordern im Abschnitt Authentifizierung für Ihre Aktion Trigger a webhook ausgewählt haben, füllt HubSpot den Webhook mit einem X-HubSpot-Signatur-Header mit einem SHA-256-Hash der Verkettung des App-Secrets für Ihre Anwendung, die HTTP-Methode, die URI und den unverparten Body. Erfahren Sie mehr darüber in der Entwickler-Dokumentation.

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