Webhooks – Echtzeit-Events
Echtzeit-Kundenfeedback für deutsche Webshops
Configure Webhook URL Read API DocsTrigger Actions on Customer Behavior
FeedBackPro pushes structured JSON payloads to your endpoint the moment a visitor interacts with a widget. Choose which signals route into your pipeline.
new_feedback
Fires when a customer submits an open-text comment via the slide-in widget. Includes customer email, browser locale, and session duration.
rating_submitted
Triggers on 1–5 star scale submissions. Payload contains the numeric score, associated product SKU, and timestamp in ISO 8601 format.
nps_calculated
Dispatched after a Net Promoter Score survey closes. Returns the calculated segment (Promoter, Passive, Detractor) and raw response ID.
widget_dismissed
Sends a signal when a user closes the feedback panel without submitting. Useful for tracking drop-off rates and optimizing placement.
Setup Guide: Register & Validate
Connect your backend in three steps. FeedBackPro uses HTTPS POST requests with signature verification to guarantee payload integrity.
Navigate to Settings > Webhooks and paste your endpoint URL (e.g., https://api.yourshop.de/webhooks/feedback). Click "Send Test Event" to trigger a dry-run payload. Your server must respond with a 200 OK status within 5 seconds. FeedBackPro includes an X-FeedbackPro-Signature header; verify it using your shared secret key via HMAC-SHA256 before processing the JSON body.
Open Webhook Dashboard Download Postman CollectionPayload Structure
Every webhook follows a consistent schema. Fields are strictly typed and documented in our developer portal.
Envelopes wrap the event type and a unique request identifier. The data object contains customer metadata, interaction context, and timestamps. Example structure for rating_submitted:
{ "event": "rating_submitted", "id": "evt_8f3a2c91", "timestamp": "2024-06-15T14:32:00Z", "data": { "customer_id": "cus_9021", "email": "anna.mueller@webshop.de", "score": 4, "product_sku": "BW-440-RED", "session_page": "/checkout/thank-you" } }
All payloads are UTF-8 encoded. Nullable fields return null instead of empty strings to simplify parsing in Node.js, Python, and PHP environments.
Retry Policy & Failure Handling
Network hiccups happen. FeedBackPro automatically retries failed deliveries without duplicating events in your database.
If your endpoint returns a 4xx or 5xx status, or fails to respond within the 5-second window, we apply an exponential backoff schedule: 15 seconds, 2 minutes, 10 minutes, 1 hour, and 6 hours. After five attempts, the event is marked as failed and routed to your configured Dead Letter Queue. You can manually re-send failed payloads from the dashboard or set up a cron job to poll the /webhooks/failed endpoint. Idempotency keys are included in every retry to prevent duplicate processing.
View Retry Configuration