CX Score
CX Score evaluates a closed or expired conversation and returns a structured assessment of customer experience. It considers text, available audio transcriptions, and correlated reactions. The output is an AI assessment for review; it should not be treated as a customer survey or a verified outcome.
Call it with an application API key for a session owned by that application:
curl -X POST 'https://app.chatt2.me/v1/agent/sessions/SESSION_UUID/cx-score' \
-H 'x-api-key: YOUR_APPLICATION_API_KEY'
A 200 response always includes sessionId, eligible, ineligibleReason, score, sentiment, resolved, serviceQuality, and generatedAt. For an eligible conversation, score and serviceQuality are integers from 1 to 5. sentiment is positive, neutral, negative, or mixed; resolved is yes, partial, no, or unknown.
If there is not enough usable conversation or it is off topic, the response still uses 200: eligible is false, ineligibleReason is not_enough_messages or off_topic, and the ratings are null. Handle this as a valid result, rather than a failed request.
| Status | Meaning |
|---|---|
404 | Session does not exist for this application. |
409 | Session is still open (SESSION_NOT_CLOSED). |
422 | Conversation context is too large (CX_SCORE_CONTEXT_TOO_LARGE). |
429 | Rate limit reached; respect the Retry-After header when present. |
502/503/504 | Generation failed, Agent service is unavailable, or the request timed out. |
Repeated calls can recalculate the assessment and return different results. Successful assessment, including an ineligible result, uses AiChat once per session across Agent, Session Assist, and CX Score; an already charged session does not create another AiChat debit. See application wallet history and the API reference for the full contract.