Verwenden Sie Webhooks in Workflows, um Informationen von HubSpot in eine andere Webanwendung weiterzugeben.
- Webhooks verstehen
- Einen webhook in Ihrem workflow einrichten
- Webhook testen
- Signaturen in workflow-webhooks verifizieren
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.
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:
- Ein Entwicklerkonto besitzen. Wenn Sie keines haben, melden Sie sich für ein Entwicklerkonto an.
- Eine App besitzen Wenn Sie keine App haben, lernen Sie, wie man eine App erstellt.
- Suchen Sie den hash-Wert der Signatur.