Skip to main content

SubmitRating submits a post-call rating.

POST 
/api/v1/voice/ratings

Called by IVR after a call ends to record customer feedback.

Parameters​

  • call_id: Required, unique call identifier
  • rating: Required, rating value (within scale range)
  • scale_type: Required, rating scale type
  • queue_id: Optional, queue that handled the call
  • agent_id: Optional, agent who handled the call
  • dtmf_input: Raw DTMF digits entered by caller
  • caller_number: Caller's phone number
  • call_duration: Call duration in seconds

Response​

  • rating_id: Created rating record ID
  • normalized_score: Rating normalized to 0-1 scale
  • sentiment: positive, neutral, or negative

Errors​

  • INVALID_ARGUMENT: Invalid scale_type or rating value
  • NOT_FOUND: Call not found

Request​

Responses​

A successful response.