Webhooks – Automatisieren Sie Ihre Workflows
Datengesteuertes Feedback für modernes Produktmanagement
Wie Webhooks in FeedbackFlow funktionieren
Webhooks ermöglichen es Ihnen, Feedback-Ereignisse in Echtzeit an externe Systeme zu senden. Sobald ein Nutzer ein Feedback über das FeedbackFlow-Widget absendet, wird eine HTTPS-POST-Anfrage an Ihre konfigurierte Endpoint-URL ausgelöst — ohne dass Sie Polling einrichten oder manuell synchronisieren müssen.
Jeder Webhook enthält eine signierte Payload mit den vollständigen Metadaten des Feedbacks: Kategorie, Priorität, Screenshot-Daten, Browser-Informationen und die zugehörige Nutzer-ID. FeedbackFlow unterstützt bis zu 10 aktive Webhook-Endpoints pro Projekt und wiederholt fehlgeschlagene Anfragen automatisch bis zu 3 Mal mit exponentiellem Backoff (1 min, 5 min, 30 min).
Echtzeit-Übertragung
Feedbacks erreichen Ihr System innerhalb von 200–800 ms nach dem Absenden. Keine Verzögerung durch Batch-Verarbeitung.
HMAC-Signatur
Jede Anfrage enthält einen Header X-FeedbackFlow-Signature mit einem SHA-256-HMAC, basierend auf Ihrem geheimen Webhook-Token.
Automatische Wiederholung
Bei HTTP-Fehlern (4xx/5xx) oder Timeouts sendet FeedbackFlow bis zu 3 Retry-Anfragen mit steigenden Intervallen.
Webhooks in Drittanbieter-Tools konfigurieren
FeedbackFlow lässt sich nahtlos in Ihre bestehende Workflow-Infrastruktur integrieren. Im Folgenden finden Sie konkrete Anleitungen für die beliebtesten Plattformen.
Zapier
Erstellen Sie einen neuen Zap mit dem Trigger „Webhooks by Zapier → Catch Hook“. Kopieren Sie die_unique_-Zapier-URL in Ihren FeedbackFlow-Dashboard unter Einstellungen → Webhooks → Neuer Endpoint. Geben Sie dem Endpoint einen Namen wie „Zapier – Slack-Benachrichtigung" und speichern Sie. Aktivieren Sie den Zap und testen Sie mit einem Dummy-Feedback.
n8n
Fügen Sie einen „Webhook"-Node zu Ihrem Workflow hinzu und wählen Sie die Methode POST. Aktivieren Sie „Test-URL" für die Entwicklung oder „Production-URL" für den Live-Betrieb. Fügen Sie einen „HTTP Request"-Node hinzu, um die Payload an Ihr Ticketsystem (z. B. Jira oder Linear) weiterzuleiten. Verknüpfen Sie die n8n-Webhook-URL mit FeedbackFlow.
Slack
Richten Sie einen eingehenden Webhook in Slack ein (App „Incoming Webhooks" → Kanalkonfiguration). Die generierte URL (Format: https://hooks.slack.com/services/T02ABCDE/B03FGHIJK/XyZ...) tragen Sie direkt in FeedbackFlow ein. Optional: Nutzen Sie einen Formatierungs-Node in Zapier oder n8n, um die Nachricht als formatierte Block-Message zu senden.
Schritt-für-Schritt im FeedbackFlow-Dashboard: Navigieren Sie zu Projekt → Einstellungen → Webhooks. Klicken Sie auf „Endpoint hinzufügen". Tragen Sie die Ziel-URL ein, wählen Sie die auszulösenden Ereignisse (z. B. feedback.created, feedback.resolved, feedback.tagged) und speichern Sie. Ihr Webhook-Token wird einmalig angezeigt — kopieren und sichern Sie ihn sofort.
Payload-Beispiele
Jeder Webhook wird als HTTPS-POST mit dem Content-Type application/json gesendet. Nachfolgend finden Sie repräsentative Payloads für die drei unterstützten Ereignistypen.
Ereignis: feedback.created
Wird ausgelöst, sobald ein Nutzer ein neues Feedback über das Widget absendet.
{
"event": "feedback.created",
"timestamp": "2025-06-12T14:32:07Z",
"project_id": "proj_9f3k2m1x",
"feedback": {
"id": "fb_a8h7g6f5",
"message": "Die Suchfunktion auf der Produktdetailseite lädt extrem langsam — bei 300+ Artikeln dauert es über 12 Sekunden.",
"category": "bug",
"priority": "high",
"tags": ["performance", "search", "product-detail"],
"browser": "Chrome 126.0.6478.127",
"os": "Windows 11",
"page_url": "https://shop.example.com/products/42183",
"screenshot_url": "https://cdn.feedbackflow.io/screenshots/fb_a8h7g6f5.png",
"user": {
"id": "usr_m4n5o6p7",
"email": "l.krause@beispiel.de",
"plan": "business"
}
}
}
Ereignis: feedback.resolved
Wird ausgelöst, wenn ein Teammitglied ein Feedback als gelöst markiert.
{
"event": "feedback.resolved",
"timestamp": "2025-06-14T09:15:44Z",
"project_id": "proj_9f3k2m1x",
"feedback": {
"id": "fb_a8h7g6f5",
"resolved_by": {
"id": "usr_q8r9s0t1",
"name": "Jan Weber",
"role": "product-manager"
},
"resolution_note": "Suchindex wurde auf Elasticsearch 8.x migriert. Antwortzeiten liegen jetzt bei unter 200 ms.",
"resolved_at": "2025-06-14T09:15:44Z"
}
}
Ereignis: feedback.tagged
Wird ausgelöst, wenn ein oder mehrere Tags zu einem bestehenden Feedback hinzugefügt oder entfernt werden.
{
"event": "feedback.tagged",
"timestamp": "2025-06-13T16:48:22Z",
"project_id": "proj_9f3k2m1x",
"feedback": {
"id": "fb_a8h7g6f5",
"tags_added": ["v2.4-candidate"],
"tags_removed": [],
"current_tags": ["performance", "search", "product-detail", "v2.4-candidate"],
"tagged_by": {
"id": "usr_q8r9s0t1",
"name": "Jan Weber"
}
}
}
Sicherheits-Header: Jede Anfrage enthält zusätzlich folgende Header zur Verifizierung:
X-FeedbackFlow-Signature: sha256=a1b2c3d4e5f6...
X-FeedbackFlow-Timestamp: 1718214727
X-FeedbackFlow-Event: feedback.created
Validieren Sie die Signatur, indem Sie HMAC-SHA256 über den Raw-Body mit Ihrem Webhook-Token berechnen und das Ergebnis mit dem Header-Wert vergleichen.