Fin Agent CSAT Requested Event

REST API Reference

Event fired when Fin asks the user to rate the conversation. Delivered via webhooks. Carries the rating options to present to the user; submit the user's choice with POST /fin/csat. Unlike the reply events it has no message — a rating survey is a set of options to choose from, not readable text.

event_namestringrequired

The name of the event.

Value:"csat_requested"

Example:"csat_requested"

conversation_idstringrequired

The ID of the conversation.

Example:"123456"

user_idstringrequired

The ID of the user.

Example:"7891"

csatobjectrequired

The rating survey to present to the user.

Example:

{
  "options": [
    { … },
    { … }
  ]
}

created_at_msstring, (date-time)required

The timestamp the event was created at, with millisecond precision.

Example:"2025-01-24T10:00:00.123Z"

{
  "event_name": "csat_requested",
  "conversation_id": "123456",
  "user_id": "7891",
  "csat": {
    "options": [ … ]
  },
  "created_at_ms": "2025-01-24T10:00:00.123Z"
}