This API allows you to assign or update skill assignments and weights for agents within a specific Queue.
It is typically used for routing optimization, ensuring that agents receive leads based on their skill level and priority.
Use Cases
- Adjust routing priority for high-performing agents
- Balance lead distribution across teams
- Dynamically update agent skill profiles
- Optimize queue performance based on campaign needs
Endpoint
POST https://api.convoso.com/v1/queues/update
🔒 Authentication
- Parameter Name: auth_token
- Required: Yes
🔎 Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| auth_token | string | Yes | API authentication token |
| queue_id | integer | Yes | Queue ID to update |
| Updates | |||
| agent_id | integer | Yes | Agent ID(s), comma-separated (e.g.,1021,1045) |
| skill | integer | Yes | Skill level(s), comma-separated (range: -9 to 9) |
| weight | integer | Yes | Weight(s) for each skill, comma-separated |
Request Example
POST https://api.convoso.com/v1/queues/update
auth_token=abc123
&queue_id=111
&agent_id=1234,5678
&skill=0,1
&weight=1,2
Response Example
{
"success": true,
"code": 200,
"data": {}
}Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Indicates if the request was successful |
| code | integer | HTTP status code |
| data | object | Response payload (empty on success) |
Error Codes
| Code | Description |
|---|---|
7247 | Invalid or missing Queue ID |
7248 | Missing Agent ID |
7249 | Invalid or missing Weight |
7250 | Invalid or missing Skill |
7251 | Invalid Agent ID |
7252 | Duplicate Agent ID |
7253 | Skill and Weight are out of range |
7254 | Skill out of range |
7255 | Weight out of range |
7256 | Only one Queue ID can be updated per request |
Please sign in and vote to let us know if you found this article helpful!
👇