Feedback empfangen

Wird ausgelöst, wenn ein Leser einen Artikel im Hilfe-Center oder Widget bewertet.

POST feedback.received

Bearer-Token

curl 'https://api.ferndesk.com/v1/feedback.received' \
  --request POST \
  --header 'webhook-id: whevt_01JXYC5R2K9M' \
  --header 'webhook-timestamp: 1752096000' \
  --header 'webhook-signature: v1,K5oT8v...base64...' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "whevt_01JXYC5R2K9M",
  "type": "feedback.received",
  "created_at": "2026-07-09T18:25:43.511Z",
  "data": {
    "id": "artfb_01JXY9AZK4KV",
    "article_id": "art_01JXY9AZK4KV",
    "type": "positive",
    "feedback": "This walkthrough was clear and accurate.",
    "hc_user_id": "hcusr_01JXYB3S2Y8C"
  }
}'

Diese Antwort hat keinen Body.

Zustellung bestätigt; alles andere wird mit Backoff erneut versucht.

Header

· 3

webhook-id string erforderlich

Umschlag-id, für jedes Ereignis eindeutig.

webhook-timestamp string erforderlich

Unix-Sekunden, zu denen die Anfrage signiert wurde; veraltete Werte ablehnen.

webhook-signature string erforderlich

Durch Leerzeichen getrennte v1,-Token — mehrere während der Geheimnisrotation — berechnet wie unter Signaturüberprüfung beschrieben.

Body

erforderlich application/json

id string erforderlich

Ereigniskennung, wiederholt im Header webhook-id.

type string · Enum erforderlich

Ereignistyp dieser Zustellung.

Werte

feedback.received

created_at string erforderlich

Zeitpunkt der Erstellung des Ereignisses.

data object erforderlich

Leserfeedback ohne die E-Mail-Adresse des Absenders; hc_user_id über die Users API auflösen, wenn Kontaktdaten benötigt werden.

Header

Body

Antworten