Jump to: navigation, search

Workbins

file:important.png Pre-Release Notice: The information contained on this page is not considered final and is managed under the terms and conditions found in the Pre-release Agreement. This page provides the most up-to-date reference information available for this pre-release version and is restricted for use by those who have signed the Pre-release Agreement with Genesys to acquire an early version of the software.

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": [
  {
      u'workbinId': u'RmFjZWJvb2sgV29ya2JpbiBJblByb2dyZXNzL1ByaXZhdGVWaWV3',
      u'active': 1,
      u'workbinName': u'FacebookWorkbinInProgress',
      u'viewName': u'FacebookWorkbinInProgress/PrivateView',
      u'workbinType': 1
  },
  {
      u'workbinId': u'VHdpdHRlciBXb3JrYmluIERyYWZ0L1ByaXZhdGVWaWV3',
      u'active': 1,
      u'workbinName': u'TwitterWorkbinDraft',
      u'viewName': u'TwitterWorkbinDraft/PrivateView',
      u'workbinType': 1
  },
  {
      u'workbinId': u'VHdpdHRlciBXb3JrYmluIEluUHJvZ3Jlc3MvUHJpdmF0ZVZpZXc=',
      u'active': 1,
      u'workbinName': u'TwitterWorkbinInProgress',
      u'viewName': u'TwitterWorkbinInProgress/PrivateView',
      u'workbinType': 1
  },
  {
      u'workbinId': u'VGVzdFdvcmtiaW4vUHJpdmF0ZVZpZXc=',
      u'active': 1,
      u'workbinName': u'TestWorkbin',
      u'viewName': u'TestWorkbin/PrivateView',
      u'workbinType': 1
  },
  {
      u'workbinId': u'RmFjZWJvb2sgV29ya2JpbiBEcmFmdC9Qcml2YXRlVmlldw==',
      u'active': 1,
      u'workbinName': u'FacebookWorkbinDraft',
      u'viewName': u'FacebookWorkbinDraft/PrivateView',
      u'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, please refer to the All Methods sub-section of the Return Values section.

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, please refer to the All Methods sub-section of the Return Values section.

PullInteraction

This request will pull an interaction from a workbin and assign 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, please refer to the All Methods sub-section of the Return Values section.

SubscribeWorkbinEvents

This request will subscribe 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, please refer to the All Methods sub-section of the Return Values section.

CometD Notifications

Topic: /v2/me/workbins

Message:

{
   u'messageType': u'workbinNotificationResource',
   u'operation': u'Create',
   u'workbinContentOperation': u'PlacedIn',
   u'interaction': {
       u'userData': {
           u'Sublist': {
               u'subkey': u'subkeyvalue'
           }
       },
       u'currentQueue': u'TestWorkbin/PrivateQueue',
       u'interactionSubtType': u'InboundNew',
       u'state': u'Queued',
       u'parentId': u,
       u'id': u'0000Ba8Y08X9001E',
       u'channel': u'email',
       u'interactionType': u'Inbound'
   },
   u'workbinInfo': {
       u'workbinTypeId': u'TestWorkbin',
       u'workbinGroupId': None,
       u'workbinPlaceGroupId': None,
       u'workbinAgentId': u'Agen1',
       u'workbinPlaceId': None
   },
   u'actorInfo': {
       u'agentId': None,
       u'actorMediaServerId': u'test',
       u'actorType': u'MediaServer',
       u'actorPlaceId': None
   },
   u'reasonInfo': {
       u'reason': 1,
       u'reasonDescription': abcd,
       u'reasonName' : ddddd     
       }
   }
}

UnsubscribeWorkbinEvents

This request will unsubscribe 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, please refer to the All Methods sub-section of the Return Values section.

This page was last edited on September 6, 2013, at 16:54.
Comments or questions about this documentation? Contact us for support!