CallData object
For a comparison with the new model for MCS media, see Comparison with CallData object.
This object is available to all call types.
|
Property name |
Type |
Description |
|---|---|---|
|
CallData.AgentDeliveryInitiated |
Boolean |
Only valid in MusicOnHoldInQueue script for incoming calls. Indicates whether a current call is already in the process of being delivered to an agent. |
|
CallData.AnsweringAgentFirstName |
String |
The agent's first name. |
|
CallData.AnsweringAgentGuid |
Integer |
The agent's Global User ID. This is the ID the agent receives during a logged on session. |
|
CallData.AnsweringAgentId |
Integer |
The agent's ID. |
|
CallData.AnsweringAgentLastName |
String |
The agent's last name. |
|
CallData.ArrivalTimeBias |
Time |
The current arrival time bias. Arrival time bias is used to offset TQOS by adding bias to the arrival time. |
|
CallData.CallAssignedPriority |
Integer |
A priority in the range from 0 through 99 can be assigned to a call from a script. A call with priority 99 has the highest priority in its queue. A call with priority 0 has the lowest priority in its queue. The default is 49. This property can be assigned to calls through the Call Maturity/Priority and Assign CCaaS Designer blocks. Call priority takes precedence over call maturity within a particular queue. |
|
CallData.CallDirection |
Integer |
The values are:
|
|
CallData.CallerMessage |
String |
The caller's message to display to the agent. |
|
CallData.CallerName |
String |
The caller's name to display to the agent. |
|
CallData.CallerURL |
String |
The caller's URL to display to the agent. |
|
CallData.calloutAgentName |
String |
The calling agent's user name. |
|
CallData.CallRejectedCounter |
Integer |
How many times the call was rejected. |
|
CallData.CallSetName |
String |
The name of the queue for this call. |
|
CallData.CampaignName |
String |
For outbound dialing campaigns only. Can be used to display the name of the outbound dialing campaign to the agent. |
|
CallData.DirectExtension |
Integer |
The direct extension that was called. |
|
CallData.DirectExtensionCall |
Boolean |
True if the call is to a direct extension. False if it is not. |
|
CallData.DirectRouteAgentID |
Integer |
The agent's ID. Allows calls to be directly routed to an agent via a script. |
|
CallData.Disconnect_Code |
Integer |
The IVR disconnect reason code logged to the Call Data Records. If this is non-zero when the IVR completes, the Call Matcher does not queue the call. |
|
CallData.EstimatedWaitTime |
Integer |
Estimated time until agent pickup while call is in queue. Value is equal to the average wait for the queue minus the time waited so far. If the value is negative, zero is reported. The value is in seconds. The measurement interval for the waiting time is estimated for at least 5 minutes and at least 10 calls, as follows: If there are more than 10 calls during the last 5 min., the waiting time is calculated based on all the calls. If there are less than 10 calls during the last 5 min., the waiting time is calculated based on 10 calls in a time interval greater than the last 5 min. |
|
CallData.HasSkill("SkillName") |
Boolean |
Tests if the supplied skill is attached to the call. |
|
Calldata.HideAniFromAgent |
Boolean |
Whether the ANI should be hidden from an agent in response to the network presentation indicator. See Determining the Calldata.HideAniFromAgent value. |
|
Calldata.IsCallback |
Boolean |
True if call is callback type. False if it is not. |
|
CallData.MediaType |
Integer |
The media type for the current call. Possible values are:
|
|
CallData.Option("Parameter") |
String |
Parameter is the name of a previously set optional parameter. This is used to access any optional parameters that are set using the Optional Parameters block. |
|
CallData.PickUpFailurescounter |
Integer |
How many times Pickup Timeout occurred for one call. |
|
CallData.RefusingAgentId |
Integer |
The ID of the agent refusing to accept the call. |
|
CallData.RefusingAgentName |
String |
The logon name of the agent refusing to accept the call. |
|
CallData.Skills |
String |
The skills to display to the agent. |
|
CallData.SkillsCount |
Integer |
The current number of skills attached to call. |
|
CallData.TenantID |
Integer |
The CCaaS tenant ID for the current call. |
|
CallData.TtsCounter |
Integer |
How many times the call was transferred to system (all media). |
Properties from SIP headers
Session Initiation Protocol (SIP) is a procedure, called a protocol, used in the setting up of telephone calls between two systems that serve a caller and the called party. The header provides information used in managing a call and does not carry content, such as voice signals.
|
Property name |
Type |
Description |
|---|---|---|
|
CallData.line.SIPPhoneContext |
String |
Phone-context parameter from incoming call P-Asserted-Identity (PAISIP) header. The information extracted supplements the phone URI (tel URI) in the SIP header. The tel URI may have purely local significance. The context can provide information about the remote end point of a call so that the tel URI can be properly interpreted. For example, if the tel URI is 640-1234, the context can be 001-631 where the country code of the United States is followed by a Long Island area code. |
|
CallData.line.SIPPrivacyList |
String |
Values from incoming call SIP Privacy header. This data indicates whether the caller identifying information is to be revealed to the called party. The list is a string extracted from the INVITE message. For example, if the Privacy header is present in the INVITE message and contains "user" or "id," then the caller's identity is expected to be hidden from the called party. The treatment of this information depends on your system administrator's settings for privacy in your network. See SIP privacy parameters in the CCaaS Tenant Administrator Help. |
|
CallData.line.SIPPAISIP |
String |
Value from incoming call PAISIP header in SIP format. |
|
CallData.line.SIPPAITEL |
String |
Value from incoming call PAITEL header. It is the PAI in phone URI format. |
|
CallData.line.SIPPANILocationAreaCode |
String |
Value from incoming call P-Access-Network-Info (PANI) header. The PANI supplements the PAITEL or PAISIP with sending service provider location information. It is typically used for billing between service providers and between service providers and their subscribers. |
|
CallData.line.SIPPANIOperatorCode |
String |
Value from incoming call PANI header. One of the components of the PANI header. |
|
CallData.line.SIPPANIAcessType |
String |
Value from incoming call PANI header. One of the components of the PANI header. |
|
CallData.line.SIPMediasList |
String |
List of media selected in the Session Description Protocol (SDP) part of the SIP INVITE message. Note SDP describes multimedia sessions for the purposes of session announcement, session invitation, and other forms of multimedia session initiation. |
Playback-related properties
The properties shown below are only available for Playback-enabled contact centers.
|
Note
|
|
Property name |
Type |
Description |
|---|---|---|
|
CallData.Recording |
Integer |
Values can be 0 or 1. |
|
CallData.SelectiveRecording |
Integer |
Values can be 0 or 1. |
|
CallData.ShowRecording |
Integer |
Values can be 0 or 1. |
The Playback implementation allows the addition of a recording button to CCaaS UI to allow the agent to selectively record a partial call if SelectiveRecording is turned on. If ShowRecording is turned on, this button shows the current status of the recording. This button is not shown when the agent is not in call unless the agent is a supervisor and he or she has selected to monitor a call. The state of this button depends on how the CallData parameters shown below are set for the call. The table below may help to clarify the choices that are available.
|
Recording |
SelectiveRecording |
ShowRecording |
Description |
|---|---|---|---|
|
0 |
0 |
0 |
Recording is not active for this call. Think of this scenario as if there is no recording installed at all on the agent application machines. |
|
1 |
0 |
0 |
Record the entire call. |
|
0 |
1 |
0 |
Do not record this call. The agent can start recording and stop recording at any time during the call. |
|
0 |
0 |
1 |
Do not record this call, but show the status of the recording button. The status of the recording button should indicate that this call is not being recorded. |
|
1 |
1 |
0 |
Record the entire call and the agent can play around with the recording button, but it does not do anything. That is, the agent thinks that he or she can turn recording off, but in fact, the entire call is recorded no matter what the agent does with the recording button. |
|
0 |
1 |
1 |
Do not record this call. The agent can start recording at any time during the call. The status of the recording button should show whether the call is currently being recorded or if recording is stopped. |
|
1 |
0 |
1 |
The entire call is recorded. The agent cannot play around with the recording button. The recording button shows that this call is currently being recorded. |
|
1 |
1 |
1 |
The entire call is recorded. The agent can play around with the recording button, but it does not do anything. The recording button shows that this call is currently being recorded. |
Determining the Calldata.HideAniFromAgent value
The value of the HideAniFromAgent property can be verified by checking the $calldata.HideAniFromAgent$ expression, which can be true or false. The value is defined by a combination of two conditions:
- The VCS DWORD presentationIndicatorSupported registry key
- The H323 presentation indicator value received from the gateway
The following table displays the value of this property depending upon these two conditions.
|
presentationIndicatorSupported |
H323 presentation indicator |
HideAniFromAgent |
|---|---|---|
|
0 or absent |
clear (no ANI restrict) |
false |
|
0 or absent |
restricted (ANI restrict) |
false |
|
1 or greater |
clear (no ANI restrict) |
false |
|
1 or greater |
restricted (ANI restrict) |
true |