Get telephony agent performance metrics

`GET /report/telephonyAgentPerformance/{agentId}`

Returns performance metrics for a specific telephony agent over time. Similar to telephonyPerformance, returns 5 metrics: answered calls, missed calls, answer rate, average wait time, and average handling time.

Path parameters

agentIdintegerpathrequired

The ID of the telephony agent (user)

Query parameters

lastDaysenumquery

Number of days to look back

granularityenumquery

Time bucket size for the time-series data. When omitted, defaults to 'day' (dd.mm keys, same as before).

hour: one bucket per clock-hour (YYYY-MM-DD HH:00 keys); only allowed with lastDays ≤ 31
day: one bucket per calendar day (dd.mm keys)
week: one bucket per ISO week (YYYY-WNN keys)
month: one bucket per calendar month (YYYY-MM keys)

Responses

200 — Successful operation

Response Example

{
  "answeredCalls": {
    "data": {
      "28.11": {
        "Answered Calls": 12
      },
      "29.11": {
        "Answered Calls": 15
      }
    },
    "description": "Number of answered calls per day in the selected period.",
    "filters": {
      "lastDays": "7"
    },
    "summary": {
      "total": 512
    }
  },
  "missedCalls": {
    "data": {
      "28.11": {
        "Missed Calls": 2
      },
      "29.11": {
        "Missed Calls": 1
      }
    },
    "description": "Number of missed calls per day in the selected period.",
    "filters": {
      "lastDays": "7"
    },
    "summary": {
      "total": 49
    }
  },
  "answerRate": {
    "data": {
      "28.11": {
        "Answer Rate": 89
      },
      "29.11": {
        "Answer Rate": 91
      }
    },
    "description": "Answer rate percentage per day (answered / total calls).",
    "filters": {
      "lastDays": "7"
    },
    "summary": {
      "average": 89
    }
  },
  "averageWaitTime": {
    "data": {
      "28.11": {
        "Average Wait Time": 8
      },
      "29.11": {
        "Average Wait Time": 7
      }
    },
    "description": "Average wait time in seconds before call was answered per day.",
    "filters": {
      "lastDays": "7"
    },
    "summary": {
      "average": 8
    }
  },
  "averageHandlingTime": {
    "data": {
      "28.11": {
        "Average Handling Time": 97
      },
      "29.11": {
        "Average Handling Time": 102
      }
    },
    "description": "Average handling time in seconds per day.",
    "filters": {
      "lastDays": "7"
    },
    "summary": {
      "average": 97
    }
  }
}

403 — Unauthorized

404 — Telephony agent not found

500 — Internal error