Quality Management API - calibratorId not found

[Malick]

Hi,

I need to get the evaluations from a specific calibration. To do this, I have to call /api/v2/quality/calibrations/{calibrationId}

However, it requires a calibrator id

So I used /api/v2/quality/conversations/{conversationId}/evaluations/{evaluationId} but it does not seem to return the calibrator id. See below for an example (truncated). Note that the "calibration" section does not contain the "calibrator id" like the documentation suggests for this API query, it only returns the calibration id, averageScore, highScore, lowScore and selfUri. But no information on the calibrator.

{
    "id": "c46c8856-a050-43ab-8c99-4c08c3f444a7",
    "conversation": {
        "id": "3c9c9c53-8fce-4033-bcaa-683b17ac8749",
        "selfUri": "/api/v2/conversations/3c9c9c53-8fce-4033-bcaa-683b17ac8749"
    },
    "evaluationForm": {
        "id": "aaaccbd0-ecbd-4d1e-83c6-58b3a5c39961",
        "name": "Sandbox - Qualité d'accueil téléphonique",
        "published": true,
        "selfUri": "/api/v2/quality/publishedforms/aaaccbd0-ecbd-4d1e-83c6-58b3a5c39961"
    },
    "evaluator": {
        "id": "867e637f-bbdb-4990-ad5f-3e08077163cf",
        "selfUri": "/api/v2/users/867e637f-bbdb-4990-ad5f-3e08077163cf"
    },
    "agent": {
        "id": "dfbaa845-e075-45dc-a1a2-a5923f74f37b",
        "selfUri": "/api/v2/users/dfbaa845-e075-45dc-a1a2-a5923f74f37b"
    },
    "calibration": {
        "id": "89820ea6-13d7-4341-8a51-51aaa519bd4b",
        "averageScore": 0,
        "highScore": 0,
        "lowScore": 0,
        "selfUri": "/api/v2/quality/calibrations/89820ea6-13d7-4341-8a51-51aaa519bd4b"
    },
    "status": "FINISHED",

How can I get the calibrator id?

[tim.smith]

Calibration IDs can be obtained from GET /api/v2/quality/calibrations. Each result in the set will have the calibration Id (id) and the calibrator ID (calibrator.id).

[Malick]

So I have to look at the list of calibrations. Ok thanks

[Malick]

Mr Smith,
The resource GET /api/v2/quality/calibrations requires a calibratorId and I am looking for that calibratorId !

Here's a portion of the response :

body: { status: 400, code: 'bad request', message: 'You must enter a calibrator id', contextId: 'd24a4e6b-5455-455b-9699-54461437db08', details: [], errors: [] } }

[tim.smith]

Sorry, I missed that the calibratorId parameter was required. You can use GET /api/v2/users to retrieve the list of users and then get the calibrations for each one.

I'm checking with the dev team to see if there's a better way or if calibratorId can be made optional.

[Malick]

Ok I think it is possible to have a better way by making calibratorId optional in /api/v2/quality/calibrations/{calibrationId} or in /api/v2/quality/calibrations. I have more than 300 users in my organization.
Thank you for your investigation.

[tim.smith]

I've checked with the dev team and it was intentionally designed this way. You must know the ID of the user that created the calibration in order to access it.

If you can describe your use case for accessing calibrations without knowing the user, I can submit it as an enhancement request.

[Malick]

Ok thank you, I see...

In fact, I develop a program that gather the entire daily conversations of our organization and store it with all its related informations (segments, sessions, participants, evaluations, users, queues, ...) in a relational database. The use case here is to be able to distinguish real evaluations from ones related to a calibration in order to note and remunerate correctly agents of our call center. So as we have many calibrators (and their role can change), we design a new table that stores daily calibrations data :

• calibrationId,
• evaluationId,
• calibratorId,
• averageScore
• highScore,
• lowScore

The problem is that I am enable to use GET /api/v2/quality/conversations/{conversationId}/evaluations/{evaluationId} to have the JSON response as described in the online documentation with particularily the calibratorId.

I need it in order to feed automatically my relational database table named calibrations.

Hoping I have described clearly the situation, I am available for any further question.

Thanks and Regards,
Malick