Fin Agent CSAT Requested Event

REST API Reference

Event fired when Fin asks the user to rate the conversation. Delivered via webhooks or SSE. 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. Over SSE this event arrives after Fin reaches 'complete'. Because a survey is expected, 'complete' does not close the stream: the connection is held open so this event can be delivered, and the token is revoked once it is sent.

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