Webhooks – Automatisieren Sie Ihre Workflows

Datengesteuertes Feedback für modernes Produktmanagement

Grundlagen

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.

Einrichtung

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.

Zum Dashboard Webhook-Tester öffnen
Referenz

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.