Get Interaction Analytics

Understand what happened in a specific conversation with AI-powered analysis. See sentiment shifts, detect frustration, identify commercial intent, and get actionable insights.

⚠️ Requires Growth+ plan or higher

Two modes available:

• simple mode: Get just the numbers—sentiment scores, frustration levels, and key metrics. Perfect for dashboards and quick checks. No rate limiting.
• insights mode (default): Dive deeper with detailed keywords, insights, and AI-generated suggestions for improvement. Rate limited based on your plan’s maxAnalysesPerHour.

Returns 404 if the conversation doesn’t exist or hasn’t been analyzed yet.

GET /interactions/{interactionId}/analytics

cURL

cURL

curl --request GET \
  --url https://www.greenflash.ai/api/v1/interactions/{interactionId}/analytics \
  --header 'Authorization: Bearer <token>'

200

{
  "messageCount": 123,
  "summary": "<string>",
  "topic": "<string>",
  "conversationQualityIndex": 123,
  "averageUserSentiment": {
    "label": "<string>",
    "score": 123
  },
  "changeInUserSentiment": {
    "label": "<string>",
    "score": 123
  },
  "mostCommonUserEmotion": "<string>",
  "frustration": {
    "score": 123,
    "label": "<string>"
  },
  "struggle": {
    "score": 123,
    "label": "<string>"
  },
  "commercialIntent": {
    "score": 123,
    "primarySignal": "<string>"
  },
  "rating": 123,
  "keywords": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

interactionId · string<uuid> · required

The interaction ID to get analytics for

Query Parameters

mode · enum<string> · default: insights

Analysis mode: "simple" returns only numeric aggregates (no rate limiting), "insights" includes topics, keywords, and recommendations (rate limited per tenant plan).

Available options: simple, insights

Response

200

application/json

Interaction analytics retrieved successfully

messageCount · number · required

Number of messages in the interaction.

summary · string · required

Summary of the interaction.

topic · string · required

Main topic discussed.

conversationQualityIndex · number | null · required

Quality index score for the interaction.

averageUserSentiment · object · required

Average sentiment across user messages.

Show child attributes

changeInUserSentiment · object · required

How sentiment changed during the interaction.

Show child attributes

mostCommonUserEmotion · string · required

Most common emotion expressed by user.

frustration · object · required

Frustration level detected.

Show child attributes

struggle · object · required

Struggle level detected.

Show child attributes

commercialIntent · object · required

Commercial intent detected.

Show child attributes

rating · number | null · required

User rating for this interaction.

keywords · string[]

Keywords extracted (insights mode only).