Retour d’avis reçu

Se déclenche lorsqu’un lecteur évalue un article dans le centre d’aide ou le widget.

POST feedback.received

Jeton Bearer

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"
  }
}'

Cette réponse n’a pas de corps.

Livraison confirmée ; toute autre réponse entraîne une nouvelle tentative avec temporisation progressive.

En-têtes

· 3

webhook-id string requis

id de l’enveloppe, unique pour chaque événement.

webhook-timestamp string requis

Secondes Unix auxquelles la requête a été signée ; rejetez les valeurs obsolètes.

webhook-signature string requis

Jetons v1, séparés par des espaces — plusieurs peuvent être présents lors de la rotation du secret — calculés comme indiqué dans la section Vérification de la signature.

Corps

requis application/json

id string requis

Identifiant de l’événement, répété dans l’en-tête webhook-id.

type string · énumération requis

Type d’événement associé à cette livraison.

valeurs

feedback.received

created_at string requis

Date et heure de création de l’événement.

data object requis

Retour du lecteur sans son adresse e-mail ; résolvez hc_user_id via l’API users si vous avez besoin de ses coordonnées.

En-têtes

Corps

Réponses