getChatAssignments
Returns chat assignments for a specified chat.
Input parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ChatID | numeric - ID code | Yes | The identifier of the chat to get assignments for. |
Request format
curl "https://api.boldchat.com/aid/$accountID/data/rest/json/v1/getChatAssignments?auth=$authHash&ChatID=$ChatID"Return values
Parameters are provided in alphabetic order. See Sample code for probable output.
| Parameter | Type | Description |
|---|---|---|
| AccountID | numeric - ID code | Bold360 product account. |
| Answered | date - ISO/UTC | Date and time when the chat was most recently answered. |
| AssignmentByOperatorID | numeric - ID code | The ID of the operator who reassigned the chat. |
| AssignmentNumber | integer | Count of assignments on a specified chat. |
| AssignmentType | integer | The type of Assignment that took place:
|
| ChatAssignmentID | numeric - ID code | Unique ID of the Assignment event. |
| ChatID | numeric - ID code | Bold360-assigned unique identifier for the chat session. |
| ClientType | integer | The type of the Bold360 client used for Chat:
|
| Created | date - ISO/UTC | Date and time when the target resource was created. |
| Data | text - heading | JSON array heading that precedes report data output. |
| Deleted | date - ISO / UTC | Date and time when the item was deleted. The value is null if the item was not deleted. |
| DepartmentID | numeric - ID code | ID of the department. |
| Ended | date - ISO/UTC | Date and time visit or chat ended. |
| EndedOperatorMessageCount | integer | Total number of messages that the agent sent during the chat engagement. |
| EndedVisitorMessageCount | integer | Total number of messages the customer sent during the chat. |
| FolderID | numeric | The ID of the folder. |
| FromAssignmentType | integer | The assignment type of the chat prior to the current assignment. |
| FromDepartmentID | numeric - ID code | ID of the Department where the chat is assigned from. |
| FromOperatorID | numeric - ID code | ID of the operator who assigned the chat. |
| IsAnsweredOnAssignment | integer | In the Operator Activity report, assignments that the operator manually took from the
queue are excluded. This parameter displays whether the chat was
manually taken:
|
| OperatorAnswerChatCount | integer | The number of agent answers within the chat assignment. |
| OperatorEndChatCount | integer | The number of active chats assigned to and accepted by the operator, who is currently assigned to the chat (identified by the ChatID parameter). This value is calculated when the chat ends. Only those chats are included that were accepted by the operator (for example, chats assigned by ACD but not accepted are not included) AND are active at the time of ending the current chat. The current chat is also included in the value. Before the chat ends, this value is zero. |
| OperatorID | numeric - ID code | System-assigned ID of the operator. |
| OperatorMessageCount | integer | The number of operator-sent messages. |
| Started | date - ISO / UTC | Date and time when a chat was started within the chat queue. |
| Status | codes - set values | "Success" when the call completes; "Error" when the call fails. |
| ToAssignmentByOperatorID | numeric - ID code | Internal ID of the agent who initiated the Assignment event of the chat. |
| ToDepartmentID | numeric - ID | ID of the Department who the chat is currently assigned to. |
| ToOperatorID | numeric - ID | ID of the Operator who the chat is currently assigned to. |
| Truncated | Boolean | TRUE if results were shortened to fit the report, FALSE if full results for the report criteria were returned. If TRUE, you can filter down the results set or contact us to try to find a way to get at the data you are looking for. |
| Updated | date - ISO / UTC | Date and time when the <event/record> was most recently modified. |
| VisitorMessageCount | integer | The number of customer-sent messages. |
| WebsiteDefID | numeric - ID code | System-assigned ID of the website associated with the chat. |
Sample code
{
"Status": "success",
"Truncated": false,
"Data": [
{
"ChatAssignmentID": "5071385824664007497",
"AssignmentType": 0,
"OperatorID": "5676748830204723022",
"ChatID": "623452170842000390",
"AssignmentNumber": 1,
"Started": "2019-04-17T15:19:23.000Z",
"Answered": "2019-04-17T15:19:57.000Z",
"Ended": "2019-04-17T15:19:58.000Z",
"OperatorAnswerChatCount": 1,
"OperatorEndChatCount": 1,
"AccountID": "627499986405274345",
"Created": "2019-04-17T15:19:23.143Z",
"Updated": "2019-04-17T15:19:58.947Z",
"Deleted": null,
"FolderID": "622107834138401481",
"WebsiteDefID": "2220273334141714431",
"ClientType": 0,
"FromAssignmentType": 1,
"FromOperatorID": null,
"AssignmentByOperatorID": null,
"FromDepartmentID": null,
"DepartmentID": null,
"ToOperatorID": null,
"ToAssignmentByOperatorID": null,
"ToDepartmentID": null,
"VisitorMessageCount": 0,
"OperatorMessageCount": 0,
"EndedVisitorMessageCount": 0,
"EndedOperatorMessageCount": 0
}
]
}