Workbins
The following operations are allowed on /me/workbins
| Operation Name | HTTP Operation | Description | Permissions |
|---|---|---|---|
| GetWorkbinTypesInfo | GET | Returns a list of workbins and the information associated with the workbins. | Agent |
GetWorkbinTypesInfo
Input
None
Output
Success
{
"status":0,
"workbins": [
{
'workbinId': 'RmFjZWJvb2sgV29ya2JpbiBJblByb2dyZXNzL1ByaXZhdGVWaWV3',
'active': 1,
'workbinName': 'FacebookWorkbinInProgress',
'viewName': 'FacebookWorkbinInProgress/PrivateView',
'workbinType': 1
},
{
'workbinId': 'VHdpdHRlciBXb3JrYmluIERyYWZ0L1ByaXZhdGVWaWV3',
'active': 1,
'workbinName': 'TwitterWorkbinDraft',
'viewName': 'TwitterWorkbinDraft/PrivateView',
'workbinType': 1
},
{
'workbinId': 'VHdpdHRlciBXb3JrYmluIEluUHJvZ3Jlc3MvUHJpdmF0ZVZpZXc=',
'active': 1,
'workbinName': 'TwitterWorkbinInProgress',
'viewName': 'TwitterWorkbinInProgress/PrivateView',
'workbinType': 1
},
{
'workbinId': 'VGVzdFdvcmtiaW4vUHJpdmF0ZVZpZXc=',
'active': 1,
'workbinName': 'TestWorkbin',
'viewName': 'TestWorkbin/PrivateView',
'workbinType': 1
},
{
'workbinId': 'RmFjZWJvb2sgV29ya2JpbiBEcmFmdC9Qcml2YXRlVmlldw==',
'active': 1,
'workbinName': 'FacebookWorkbinDraft',
'viewName': 'FacebookWorkbinDraft/PrivateView',
'workbinType': 1
}
]
}
Failure
{
"status":integer above 0
"description":error-code
}
Operations
In addition, the following operations are allowed:
| Operation Name | HTTP Operation | Description | Permissions |
|---|---|---|---|
| GetWorkbinContent | GET | Returns workbin information and content list. | Agent |
| AddInteractionToWorkbin | POST | Adds an interaction to the specified workbin. | Agent |
| PullInteraction | POST | Pulls an interaction from a workbin. | Agent |
| SubscribeWorkbinEvents | POST | Subscribes the agent to listen to events from the workbin. | Agent |
| UnsubscribeWorkbinEvents | POST | Unsubscribes the agent, so he or she stops receiving events from the workbin. | Agent |
GetWorkbinContent
Returns the content of the specified workbin. URI: /me/workbins/{workbinid}/interactions?fields=*
Input
None
Output
Success
{
"statusCode": 0,
"interactions": [
{
"InQueues": {
"__STOP__": ""
},
"RRequestedSkillCombination": "",
"MediaType": "email",
"InteractionId": "0000Aa8WRME43VG6",
"RTargetAgentGroup": "?:2>1",
"ServiceType": "default",
"IsHeld": 0,
"IsOnline": 0,
"SubmitSeq": "41895540",
"RTenant": "Environment",
"DeliveredAt": "2013-07-20T00:41:33Z",
"_ContainsAttachment": "false",
"RVQID": "",
"_AttachmentsSize": "0",
"PegAG?:2>1": 2,
"SubmittedBy": "es_esj",
"Header_Date": "Sat, 20 Jul 2013 02:02:57 +0300",
"EmailAddress": "qwerty@mcr812trywe",
"Header_Message-ID": "<r4mo20o0o6j1niq.190720131550@mcr812trywe>",
"RTargetRequested": "?:2>1",
"Queue": "Facebook Workbin InProgress/PrivateQueue",
"InteractionType": "Inbound",
"MovedToQueueAt": "2013-07-20T00:41:33Z",
"_AutoReplyCount": 0,
"PlacedInQueueAt": "2013-07-20T00:41:33Z",
"IsLocked": 0,
"CustomerSegment": "default",
"RTargetRuleSelected": "",
"RTargetPlaceSelected": "MaratTest",
"To": "saas54@mcr812trywe",
"ReceivedAt": "2013-07-19T23:03:02Z",
"RTargetObjSelDBID": "",
"RTargetAgentSelected": "MaratTest",
"CBR-contract_DBIDs": "",
"InteractionSubtype": "InboundNew",
"Header_Content-Type": "multipart/mixed; boundary=\"===============0302739529==\"",
"CBR-IT-path_DBIDs": "",
"CBR-actual_volume": "",
"Workbin": "Facebook Workbin InProgress",
"RRequestedSkills": null,
"OutQueues": {
"SimpleEmailOutQueue": ""
},
"RTargetObjectSelected": "?:2>1",
"AssignedAt": "2013-07-20T00:41:33Z",
"_AttachmentFileNames": "",
"Mailbox": "saas54",
"TenantId": 1,
"PegDEF": 188,
"WorkbinAgentId": "MaratTest",
"FirstName": "qwerty",
"RVQDBID": "",
"RStrategyName": "SimpleEmailInStrategy",
"RTargetTypeSelected": "2",
"SubmittedAt": "2013-07-19T23:03:16Z",
"Subject": "test_receive_invite_and_accept_updateproperites",
"ServiceObjective": 0,
"AssignedTo": "MaratTest",
"Origination_Source": "Email",
"PlaceInQueueSeq": "41904672",
"CBR-Interaction_cost": "",
"Header_MIME-Version": "1.0",
"FromAddress": "qwerty@mcr812trywe",
"ContactId": "00001a8QWK4A003P",
"RStrategyDBID": "188",
"FromPersonal": "",
"InteractionState": 0
}
]
}
Failure
{
"statusCode": an integer value above 0,
"statusMessage":details
}
For details on the statusCode value, refer to the All Methods section of the Return Values page.
AddInteractionToWorkbin
Adds interactions to a workbin. URI: /me/workbins/{workbinId}/interactions
Input
{
"interactionId":id
}
Output
Success
{
"status":0
uri":"http://host:port/api/v2/me/workbins/{workbinId}/interactions/{interactionid}"}
}
Failure
{
"statusCode": an integer value above 0,
"statusMessage":details
}
For details on the statusCode value, refer to the All Methods section of the Return Values page.
PullInteraction
This request pulls an interaction from a workbin and assigns the interaction to the user. URI: /me/interactions Upon successful execution, a CometD message will be returned with interaction state "Pulled".
Input
{
"operationName":"PullInteractionFromWorkbin"
"uri":"http://host:port/api/v2/me/workbins/{workbinId}/interactions/{interactionid}"
}
Output
Success
{
"status":0
}
Failure
{
"statusCode": an integer value above 0,
"statusMessage":details
}
For details on the statusCode value, refer to the All Methods section of the Return Values page.
SubscribeWorkbinEvents
This request subscribes the agent to events from the workbin.
Input
{
"operationName":"Subscribe"
}
Output
Success
{
"status":0
}
Failure
{
"statusCode": an integer value above 0,
"statusMessage":details
}
For details on the statusCode value, refer to the All Methods section of the Return Values page.
CometD Notifications
Topic: /v2/me/workbins
Message:
{
'messageType': 'workbinNotificationResource',
'operation': 'Create',
'workbinContentOperation': 'PlacedIn',
'interaction': {
'userData': {
'Sublist': {
'subkey': 'subkeyvalue'
}
},
'currentQueue': 'TestWorkbin/PrivateQueue',
'interactionSubtType': 'InboundNew',
'state': 'Queued',
'parentId': ,
'id': '0000Ba8Y08X9001E',
'channel': 'email',
'interactionType': 'Inbound'
},
'workbinInfo': {
'workbinTypeId': 'TestWorkbin',
'workbinGroupId': None,
'workbinPlaceGroupId': None,
'workbinAgentId': 'Agen1',
'workbinPlaceId': None
},
'actorInfo': {
'agentId': None,
'actorMediaServerId': 'test',
'actorType': 'MediaServer',
'actorPlaceId': None
},
'reasonInfo': {
'reason': 1,
'reasonDescription': abcd,
'reasonName' : ddddd
}
}
}
UnsubscribeWorkbinEvents
This request unsubscribes the agent from events from the workbin.
Input
{
"operationName":"Unsubscribe"
}
Output
Success
{
"status":0
}
Failure
{
"statusCode": an integer value above 0,
"statusMessage":details
}
For details on the statusCode value, refer to the All Methods section of the Return Values page.
