Revision as of 19:43, October 23, 2015 by Jumunn (talk | contribs) (Update with the copy of version: 8.5.2DRAFT)
Jump to: navigation, search

Call Resource

This resource is part of the Voice API section of the Genesys Web Services REST API.

Overview

The call resource includes properties that describe the current state of the call and the available operations given the current state. A full description of the properties included on the call resource and their possible values can be found here.

Sample Data

{  
   "id":"01RCC3N118B1V0SL8O7GK2LAES000010",
   "state":"Established",
   "callUuid":"01RCC3N118B1V0SL8O7GK2LAES000010",
   "connId":"0071027198180020",
   "deviceUri":"http://127.0.0.1:8080/api/v2/devices/631608b3-ceb1-472b-ba05-2ae39555b0d1",
   "participants":[  
      {  
         "e164Number":"",
         "formattedPhoneNumber":"15001",
         "phoneNumber":"15001",
         "digits":"15001"
      }
   ],
   "dnis":"15001",
   "callType":"Internal",
   "capabilities":[  
      "UpdateUserData",
      "SendDtmf",
      "InitiateConference",
      "Hold",
      "SingleStepTransfer",
      "InitiateTransfer",
      "AttachUserData",
      "DeleteUserDataPair",
      "SingleStepConference",
      "DeleteUserData",
      "Hangup",
      "StartCallRecording"
   ],
   "userData":{  
      "AccountNumber":"12345678"
   },
   "duration":"7",
   "mute":"Off",
   "recordingState":"Stopped",
   "supervisorListeningIn":false,
   "monitoredUserMuted":false,
   "monitoring":false,
   "uri":"http://127.0.0.1:8080/api/v2/me/calls/01RCC3N118B1V0SL8O7GK2LAES000010",
   "path":"/calls/01RCC3N118B1V0SL8O7GK2LAES000010"
}

Resource Details

Field Description
id The ID of the call.
state The current call state (Dialing, Held, Established, and so on).
callUuid The universally unique identifier associated with the call.
connId The connection ID for the call. This value comes from the Tlib event.
deviceUri Link to the device for which this state is applicable.
participants A collection of participants and their information. If the participant number contains +country_code, then the participant contains the following list of structures:
  • "country" — country infromation of the phone number in the JSON format: "country":{"name":"United States","code":"US","callingCode":"1"}
  • "location" — region of the phone number
  • "localPhoneNumber" — phone number in domestic format.
  • "E164digits" — phone number in e.164 format
dnis The "DNIS" attribute of the call, as sent by T-Server.
callType The type of call, such as Internal, Inbound, Outbound, Consult.
capabilities A list of capabilities for the current state. For example, if the current state is "Dialing", the list might be ["HangUp", "Hold"].
userData A map of custom values attached to the call.
duration The duration of the call, in seconds.
mute Shows whether the call is muted.
recordingState Shows the recording state of the call. Possible values are Recording, Paused, Stopped.
supervisorListeningIn Specificies whether a supervisor is listening to the call.
monitoredUserMuted This attribute indicates the mute state of the user monitored by the supervisor.
monitoring Specifies whether the user is monitoring the call.
uri The call's resource identifier.
path The path to the call resource.
Comments or questions about this documentation? Contact us for support!