From Bright Pattern Documentation
Jump to: navigation, search
(Created page with "<translate> = Agent State = Agent State is used to request an agent's state and interaction information, as well as to change an agent's state. Use either the ''getState'' or...")
 
(Updated via BpDeleteTranslateTags script)
 
(19 intermediate revisions by one other user not shown)
Line 1: Line 1:
−
<translate>
 
−
= Agent State =
 
−
Agent State is used to request an agent's state and interaction information, as well as to change an agent's state. Use either the ''getState'' or ''setStatus'' method.
 
  
−
== getState ==
+
= getState =
−
''getState'' can be called any time to request information about an agent's current state and interactions.
+
Requests information about an agent's current state and interactions. getState uses a callback function with command GET_STATE to request agent state and interaction data.
  
−
=== Request ===
+
Note that the agent must be logged in to Agent Desktop in order to use ''getState''. See this specification's [[Embedded-agent-desktop-sdk-specification/UseCases/GetAgentStateInteractionInfo |  Use Cases]] section for ways to use this method.
 +
 
 +
== Request ==
 +
=== Syntax ===
 
  window.bpspat.api.getState(callback)
 
  window.bpspat.api.getState(callback)
−
 
−
=== Object-Type ===
 
−
data (JSON)
 
−
 
−
=== Response ===
 
 
  callback = function(data) {
 
  callback = function(data) {
−
data.agent_id: "john.smith";
 
−
data.status: "Not Ready";
 
−
data.reason: "Lunch"
 
−
data.interactions: [ {
 
−
data.item_id: "123123123";
 
−
data.global_id: "asd234asdf234df"
 
−
data.phone_number: "55511122233"
 
−
data.service: "Customer Support"
 
−
data.screenpop_data: "Case: 123123"
 
−
data.attached_data: {a:b, c:d}
 
−
data.service: "Customer Support";
 
−
  }, ...
 
−
]
 
 
  }
 
  }
  
−
== setStatus ==
+
=== Parameters ===
−
Use the ''setStatus'' method to request an agent routing state change (with or without a reason code).
+
{|border="1" style="border-collapse:collapse" cellpadding="5"
 +
| '''Parameter'''
 +
| '''Type'''
 +
| '''Description'''
 +
|-
 +
| callback
 +
| function
 +
| JavaScript method executed when API method request is completed
 +
|}
  
−
=== Example ===
 
−
window.bpspat.api.setStatus(status, reason_code="")
 
  
 +
== Response ==
 +
The following is an example of the response you may get when you call ''getState''. Every time the state changes, the logs display the updated agent state:
  
 +
Logs...
 +
{"command":"STATE_CHANGED","data":{"agent_id":"jeffery.lozada","status":"ready","reason":""}}
 +
{"command":"STATE_CHANGED","data":{"agent_id":"jeffery.lozada","status":"not_ready","reason":"Not ready"}}
 +
{"command":"GET_STATE","data":{"agent_id":"jeffery.lozada","interactions":[{"item_id":"5B07EFE4-0658-45E0-AA6E-23AA042C1F0E","screenpop_data":{}}],"status":"ready","reason":""},"request_id":"2"}
  
  
−
</translate>
+
=== Response Fields ===
 +
{|border="1" style="border-collapse:collapse" cellpadding="5"
 +
| '''Name'''
 +
| '''Data Type'''
 +
| '''Description'''
 +
| '''Example'''
 +
|-
 +
| agent_id
 +
| string
 +
| agent username
 +
| "john.smith"
 +
|-
 +
| status
 +
| string
 +
| agent state
 +
| "Not ready"
 +
|-
 +
| reason
 +
| string
 +
| Not Ready reason
 +
| "Lunch"
 +
|-
 +
|interactions
 +
| array
 +
| List of interaction data, including data items below
 +
| "item_id":"5B07EFE4-0658-45E0-AA6E-23AA042C1F0E","screenpop_data":{}
 +
|-
 +
| item.id
 +
| string
 +
| Interaction ID
 +
| "5B07EFE4-0658-45E0-AA6E-23AA042C1F0E"
 +
|-
 +
| global_id
 +
| string
 +
| Global interaction ID (GIID)
 +
| "0CB4F48D-C4D8-4C9F-94F5-770AD5002C40"
 +
|-
 +
| phone_number
 +
| string
 +
| Phone number dialed (either extension number or full number)
 +
| "1012"
 +
|-
 +
| recording_url
 +
| string
 +
| URL of the call recording
 +
| "/msgplayback?tenant_id=1F64161D-C1C4-4A57-8DC4-B6B2ED7412C8&rtp_processor_id=7C0DCA41-F507-42B9-9D40-0E3B9F302B9F&message=recordings/<tenant>.brightpattern.com/2019-02-09/72E82ED8-769D-4267-85D3-EC890D653240&key_id=D811EFBA-5F8A-4AE5-A80C-8F07B7372BEF&CRC=aaadd10b9dbee5e52dcf60fe104982dd"
 +
|-
 +
| request_id
 +
| number
 +
| Indicates how many times you have made the getState request
 +
| "3" (e.g., this is the third time requesting agent status information)
 +
|-
 +
| service
 +
| string
 +
| Name of the service handling the interaction
 +
| "Maintenance Renewal"
 +
|-
 +
| screenpop_data
 +
| string
 +
| Information shown on screen-pop
 +
| -
 +
|-
 +
| attached_data
 +
| object
 +
| Data attached to a call
 +
| -
 +
|}

Latest revision as of 04:02, 29 May 2024

• 5.19 • 5.3 • 5.8


getState

Requests information about an agent's current state and interactions. getState uses a callback function with command GET_STATE to request agent state and interaction data.

Note that the agent must be logged in to Agent Desktop in order to use getState. See this specification's Use Cases section for ways to use this method.

Request

Syntax

window.bpspat.api.getState(callback)
callback = function(data) {
}

Parameters

Parameter Type Description
callback function JavaScript method executed when API method request is completed


Response

The following is an example of the response you may get when you call getState. Every time the state changes, the logs display the updated agent state: 

Logs...
{"command":"STATE_CHANGED","data":{"agent_id":"jeffery.lozada","status":"ready","reason":""}}
{"command":"STATE_CHANGED","data":{"agent_id":"jeffery.lozada","status":"not_ready","reason":"Not ready"}}
{"command":"GET_STATE","data":{"agent_id":"jeffery.lozada","interactions":[{"item_id":"5B07EFE4-0658-45E0-AA6E-23AA042C1F0E","screenpop_data":{}}],"status":"ready","reason":""},"request_id":"2"}


Response Fields

Name Data Type Description Example
agent_id string agent username "john.smith"
status string agent state "Not ready"
reason string Not Ready reason "Lunch"
interactions array List of interaction data, including data items below "item_id":"5B07EFE4-0658-45E0-AA6E-23AA042C1F0E","screenpop_data":{}
item.id string Interaction ID "5B07EFE4-0658-45E0-AA6E-23AA042C1F0E"
global_id string Global interaction ID (GIID) "0CB4F48D-C4D8-4C9F-94F5-770AD5002C40"
phone_number string Phone number dialed (either extension number or full number) "1012"
recording_url string URL of the call recording "/msgplayback?tenant_id=1F64161D-C1C4-4A57-8DC4-B6B2ED7412C8&rtp_processor_id=7C0DCA41-F507-42B9-9D40-0E3B9F302B9F&message=recordings/<tenant>.brightpattern.com/2019-02-09/72E82ED8-769D-4267-85D3-EC890D653240&key_id=D811EFBA-5F8A-4AE5-A80C-8F07B7372BEF&CRC=aaadd10b9dbee5e52dcf60fe104982dd"
request_id number Indicates how many times you have made the getState request "3" (e.g., this is the third time requesting agent status information)
service string Name of the service handling the interaction "Maintenance Renewal"
screenpop_data string Information shown on screen-pop -
attached_data object Data attached to a call -
< Previous | Next >
Retrieved from "https://help.brightpattern.com/index.php?title=5.19:Embedded-agent-desktop-sdk-specification/Methods/getState&oldid=145156"