Webhooks mit HubSpot-Workflows verwenden

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

Für Webhooks gibt es viele Verwendungszwecke, z. B. zum Senden von Daten und Übermitteln von Benachrichtigungen per Push. 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.

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

HubSpot reguliert Webhook-Traffic separat von anderen Workflow-Prozessen. Dies geschieht, um die Workflow- und Webhook-Leistung 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. Erfahren Sie mehr über spezielle Fehlercode-Ausnahmen in der Entwicklerdokumentation von HubSpot.

Weitere Informationen zu den technischen Aspekten von Webhooks finden Sie in HubSpots Entwicklerdokumentation.

 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. 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: Die Aktion „Webhook triggern“ 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.

Im folgenden Beispiel wird der Anforderungstext des Webhooks oben angezeigt. Dieser enthält Meta-Daten über einen spezifischen Kontakt, einschließlich Kontaktinformationen, Formulareinsendungen, Listenmitgliedschaften usw. 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.

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.

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