UpdateSkillProfileAveragesUsingHistoricalData

POST

https://api.cbf.tcn.com/api/v1alpha1/wfm/updateskillprofileaveragesusinghistoricaldata

Calculates the averages for call characteristics using the historical data of the given @skill_profile_sids, @skill_profile_group_sids and org sending the request.
If no @skill_profile_sids are given, it will calculate the averages for all skill profiles for the org sending the request.
If no @skill_profile_group_sids are given, it will calculate the averages for all skill profile groups for the org sending the request.
Averages will be weighted by the number of calls that each historical data interval has.
Once the averages are calculated, they will be updated in the db for those skill profiles.

If a nil @datetime_range is given then the range used will be @training_data_range_end_datetime - @averages_calculation_range_in_months to the @training_data_range_end_datetime from the forecasting parameters.
If @averages_calculation_range_in_months is 0, it will use the @training_data_range_start_datetime as the start datetime of the range.

If @exclude_skill_profiles_with_manual_averages is true, it will exclude skill profiles and groups that have manual averages from the calculation
even if those skill profiles and groups are in @skill_profile_sids or @skill_profile_group_sids respectively.

Errors:

grpc.Internal: error occurs when calculating the averages from the historical data.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "skill_profile_sids": [
        0
    ],
    "datetime_range": {
        "start_datetime": "1s",
        "end_datetime": "1s"
    },
    "exclude_skill_profiles_with_manual_averages": true,
    "skill_profile_group_sids": [
        0
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.cbf.tcn.com/api/v1alpha1/wfm/updateskillprofileaveragesusinghistoricaldata' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "skill_profile_sids": [
        0
    ],
    "datetime_range": {
        "start_datetime": "1s",
        "end_datetime": "1s"
    },
    "exclude_skill_profiles_with_manual_averages": true,
    "skill_profile_group_sids": [
        0
    ]
}'

Responses

🟢200OK

application/json

Success

Body

Example

{}

🟢200Success

Modified at 2025-09-26 15:44:58

CalculateTrainingDataAveragesForSkillProfile

UpdateCallCenterNode