assignChat
Sends a specified chat to the specified department, operator, or folder. The chat must be active.
Additional information
If the chat has been answered, it can only be reassigned if the Forced parameter is True.
Generally used with Automatic Chat Distribution (ACD) to ensure a chat is automatically reassigned to an available operator. In this case, the AssignedByOperatorID value is not set. To force the assignment of the chat to an offline operator, you would use the AssignedByOperatorID to override the ACD behavior.
Input parameters
Parameter | Type | Required | Description |
---|---|---|---|
ChatID |
numeric - ID code |
Yes |
The chat identifier of the record to update. |
DepartmentID |
numeric - ID code |
No |
The department to assign the chat to. |
OperatorID |
numeric - ID code |
No |
The agent to assign the chat to. |
AssignedByOperatorID |
numeric - ID code |
No |
The agent who assigns the chat. |
FolderID |
numeric - ID code |
No |
The folder to assign the chat to. |
Forced |
Boolean |
No |
When True, allows the chat to be reassigned. |
Request format
curl "https://api.boldchat.com/aid/$accountID/data/rest/json/v1/assignChat?auth=$authHash&ChatID=$ChatID&Forced=True"
Return values
Parameter | Type | Description |
---|---|---|
Status | code - set values | Success or Error. Error is sent with a Message. |
Message | string | Reason for call assignment. |