CallHistory Table

  • Table Type - Historical
  • Last Changed Version - 17.1.0.324
  • Last Changed Reason - Added isAddiionalCall and agentoverride columns for dialer manual outbound followup calls.

Column Definitions

Column Data Type (Size) Is Nullable Contains PII Description Last Change Version Last Change Reason CX Insights Name CX Insights Type CX Insights Folder Name
campaignname varchar (255) False Unknown

The name of the Campaign.

4.0.106.453 4.0 Release
siteid varchar (80) False Unknown

Name of the Outbound Dialer server that will call back the party.

4.0.106.453 4.0 Release
i3_identity bigint True Unknown

An integer value that uniquely identifies each row in the contact list. This field is managed for the customer by Dialer. Customers may continue to insert records that contain I3_ROWID, but they should not populate I3_IDENTITY fields.

When using the Follow Up Call feature, you'll see the same integer value in multiple rows - one for each additional call. To help you track each additional call, the phone numbers will appear in the corresponding phonenumber column. The label assigned to the phone in the contact record will appear in the corresponding phonenumbertype column.

4.0.106.453 4.0 Release
i3_rowid varchar (80) True Unknown

i3_rowid is a customer-managed field used to uniquely identify a row. i3_rowid is no longer a required field, since it was superseded by i3_identity, a Dialer-managed field. However, i3_rowid is supported in the contact list and is propagated to the CallRecordSchedule and CallHistory tables. i3_rowid is also available in Scripter and in policies for backwards compatibility.

4.0.106.453 4.0 Release
callid char (11) True Unknown

The callid number of this call attempt. For more information, see the discussion of callid in the Reporting Data Dictionary.

4.0.106.453 4.0 Release
callidkey char (18) True Unknown

This internal, site-unique key identifies a call in the system. It is an 18 character alphanumeric strings whose format may change from release to release, though the values will always be unique. This field is not referenced in any report, but can be used by customers to cross-reference Dialer calls with the standard call data stored in the CIC database. For more information, see the discussion of callidkey in the Reporting Data Dictionary.

4.0.106.453 4.0 Release
wrapupcategory varchar (80) False Unknown

A code that generally identifies the completion status of the call. Used to provide standardized reporting across multiple campaigns. See the Dialer Manager Help guide for more information.

If you create a custom wrap-up category, this column will contain a GUID that is associated with the display name of the custom wrap-up category. To match the GUID to the display name for reporting purposes, you will have to use the WrapupCategory lookup table. See WrapupCategory Table

4.0.106.453 4.0 Release
wrapupcode varchar (80) False Unknown

A code that more specifically indicates the outcome of the call. Wrap-up codes add granularity to reporting, while wrap-up Categories provide for standardized reporting across multiple campaigns. See the Dialer Manager Help guide for more information.

If you create a custom wrap-up code, this column will contain a GUID that is associated with the display name of the custom wrap-up category. To match the GUID to the display name for reporting purposes, you will have to use the WrapupCode lookup table. See WrapupCode Table

4.0.106.453 4.0 Release
callingmode tinyint True Unknown

Value Meaning
0 Non-Dialer Call
1 Predictive
2 Power
3 Preview
8 Agentless
4.0.106.453 4.0 Release
phonenumber varchar (50) True Unknown

The telephone number dialed for this attempt.

4.0.106.453 4.0 Release
phonenumbertype varchar (80) True Unknown

The customer-defined phone number type associated with the phone number dialed. This is used for reporting purposes.

When using the Follow Up Call feature, you will find the term 'NULL' in the phonenumbertype column if this was an ad-hoc call where the number was manually entered.

4.0.106.453 4.0 Release
agentid varchar (80) True Unknown

The CIC User ID of the Agent who processed the call, as it is defined in Interaction Administrator.

4.0.106.453 4.0 Release
calledpartyoffset int True Unknown

Offset in seconds used to adjust UTC times based on the called party's time zone.

4.0.106.453 4.0 Release
odsoffset int False Unknown

Offset in seconds used to adjust UTC times based on ODS's time zone.

4.0.106.453 4.0 Release
previewpoptimeUTC datetime True Unknown

In Preview mode, the time when the call record popped for the Agent to review. This is the time that Preview call data was presented to an Agent (not the actual call time.)

4.0.106.453 4.0 Release
callplacedtimeUTC datetime True Unknown

The time when the call was placed by Telephony Services.

4.0.106.453 4.0 Release
callansweredtimeUTC datetime True Unknown

The time when the call was answered by the remote party or a device.

4.0.106.453 4.0 Release
messageplaytimeUTC datetime True Unknown

The time that a message was played to the contact, due to the campaign type or due to the absence of available agents.

4.0.106.453 4.0 Release
callconnectedtimeUTC datetime True Unknown

The time that the call was connected to the Agent.

4.0.106.453 4.0 Release
calldisconnectedtimeUTC datetime False Unknown

The time when Dialer stopped tracking the call. This can occur when the call is disconnected or the call is completed upon a disposition being received from either by an agent or the system.

4.0.106.453 4.0 Release
length int True Unknown

Length of the call in seconds. The length column in the Call History table does not always match the call duration. The callplacedtimeUTC and calldisconnectedtimeUTC accumulators are tracked internally by Dialer and may not match Interaction Summary information for the call. The length field is calculated from the Completed time minus the Start time. The completed time is set when the call is completed and the wrapup code is written. That happens after policy evaluations and agent finalization. The start time occurs when the call is placed. The length field can match the (Disconnected - Placed) time when the disconnect was a result of the wrapup and finalization of the interaction. This can occur if you disposition an interaction while the call is still live.

4.0.106.453 4.0 Release
caresult tinyint True Unknown

Value Meaning
0 Represents an unknown call result. Call analysis could not determine what the remote party was, but the call did succeed and connect. Dialer treats this as live voice.
1 Voice detected. A human answered the call.
2 The carrier sent a SIT tone or a SIT message.
3 A Fax machine answered.
4 An Answering Machine answered the call.
5 The call failed with an ISDN Cause Code returned from the carrier.
6 Failure. The call failed in Telephony Services for some reason other than the above.
4.0.106.453 4.0 Release
cadetail varchar (255) True Unknown

Call Analysis results for each call are written to the CallHistory table along with the other information about the call, such as Wrap-up Codes and Categories, call id, and so forth. This allows reporting to be done not just on disposition, but also on call analysis results. This is important for customers whose call analysis is performed by Media Servers.

Two columns in CallHistory table facilitate this:

  • caresult indicates the result of call analysis.
  • cadetail provides a textual description of the call analysis result.

The cadetail (call analysis detail) column is text field up to 255 characters in length that contains extra information that supplements the caresult value.

For example, if caresult is 2 (SIT), cadetail would contain a description of the SIT tone/message. For a caresult of 5 (ISDN Cause Code) cadetail would contain a description of the ISDN cause code. For caresult 6 (Failure) cadetail would contain a description of the error returned from MakeCall. Null values are allowed, since some caresult codes do not generate detail information.

4.0.106.453 4.0 Release
isabandoned bit True Unknown

This flag indicates whether the call was abandoned (1=Yes, 0=No). This value can be set by Dialer or by a script. See Interaction Scripter Developer Guide for details.

4.0.106.453 4.0 Release
iscontact bit True Unknown

This flag indicates whether the call reached a live contact (1=Yes, 0=No). Contacts are defined in the Dialer configuration. Specifically, the 'Interaction Connected to an Actual Person' checkbox in Wrap Up Categories affects the 'iscontact' field.

4.0.106.453 4.0 Release
isdetect bit True Unknown

Signifies whether call analysis detected that the call was answered by a person. If call analysis is turned off, the value will always be 1 (true) since those calls are treated as live voice.

4.0.106.453 4.0 Release
isrpc bit True Unknown

Signifies whether the call was a right party contact.

4.0.106.453 4.0 Release
issuccess bit True Unknown

Signifies whether the campaign result was achieved, governed by the 'interaction was successful' setting on the wrap-up Category.

4.0.106.453 4.0 Release
successresult float True Unknown

This column is populated with the value of the successresult column on the contact.

Successresult is a customer-managed column in both the ContactList and CallHistory tables. Customers can use successresult to maintain running counters, such as a money counter for example. The value of 'successresult' can be NULL when records are added or updated.

The value of successresult in a CallHistory row will contain whatever was in the successresult column of the associated contact at the time the history row was written (when the record was dispositioned).

4.0.106.453 4.0 Release
customdata1 varchar (255) True Unknown

Provided for customer use. Not used by Dialer.

4.0.106.453 4.0 Release
customdata2 varchar (255) True Unknown

Provided for customer use. Not used by Dialer.

4.0.106.453 4.0 Release
campaignfilterid smallint True Unknown

The ID assigned to the filter that is applied to the campaign.

4.0.106.453 4.0 Release
previewtimerinit bit True Unknown

This flag indicates whether a Preview call was initiated manually or automatically through a campaign configured preview timer.

  • If it is a 1, then the call was initiated automatically through a campaign configured preview timer.
  • If it is a 0, then the call was initiated manually.
  • If it is null, then the call was made using a dialing mode other than Preview.
4.0.106.453 4.0 Release
rulegroupid smallint True Unknown

The ID assigned to the Rule Group that was set. You can find more details about the RuleGroupID, such as the name of the Rule Group, in the CallHistory_RuleGroup table.

15.3.0.384 Added for reporting on a campaign with context information from the rule group.
callscheduletime datetime True Unknown

When a scheduled callback occurs, this field will show the date and time that the call was scheduled. (Based on CCS time)

More specifically, when a call results in a scheduled callback, a record is added the CallHistory table for that call and both the wrapupcategory and wrapupcode entries will contain the word Scheduled. The callscheduletime entry will be set to NULL at this point.

When the scheduled callback actually occurs, a second record will added to the CallHistory table for that call; only this time the callscheduletime entry will show the date and time when the call was scheduled and the wrapupcategory and wrapupcode entries will contain appropriate values.

Keep in mind that the callscheduletime entry will NOT indicate when the actual call occurred - just the time that the call was scheduled to occur. If you wish to determine the elapsed time between when the call was scheduled and when the call was actually made, you will need to check the callplacedtimeUTC entry in the record.

4.0.106.453 4.0 Release
isAdditionalCall bit True Unknown

This flag indicates whether the call is one of the additional calls made to the same contact using the Follow Up Call feature or an standard call.

  • If it is a 1, the then call was one of several additional calls made to the same contact.
  • If it is a 0, then the call was a standard call.
4.0.106.453 4.0 Release
agentoverride smallint True Unknown

If the agent chose an override option while using the Follow Up Call feature, there will be a code number in this column that indicates what type of override that occurred. To find out what type of override the code number indicates, you'll need to check the AgentComplianceOverrides table. By performing an SQL join of the CallHistory table and the AgentComplianceOverrides table, a database administrator can extract the pertinent data.

4.0.106.453 4.0 Release
callhistory_id bigint False Unknown

Correlates this record with a row in the CallHistory table

18.4.0.000 Added column for joining the record to the Call History Details table.
Column Data Type (Size) Is Nullable Contains PII Description Last Change Version Last Change Reason CX Insights Name CX Insights Type CX Insights Folder Name
campaignname varchar2 (255) False Unknown

The name of the Campaign.

4.0.106.453 4.0 Release
siteid varchar2 (80) False Unknown

Name of the Outbound Dialer server that will call back the party.

4.0.106.453 4.0 Release
i3_identity number True Unknown

An integer value that uniquely identifies each row in the contact list. This field is managed for the customer by Dialer. Customers may continue to insert records that contain I3_ROWID, but they should not populate I3_IDENTITY fields.

When using the Follow Up Call feature, you'll see the same integer value in multiple rows - one for each additional call. To help you track each additional call, the phone numbers will appear in the corresponding phonenumber column. The label assigned to the phone in the contact record will appear in the corresponding phonenumbertype column.

4.0.106.453 4.0 Release
i3_rowid varchar2 (80) True Unknown

i3_rowid is a customer-managed field used to uniquely identify a row. i3_rowid is no longer a required field, since it was superseded by i3_identity, a Dialer-managed field. However, i3_rowid is supported in the contact list and is propagated to the CallRecordSchedule and CallHistory tables. i3_rowid is also available in Scripter and in policies for backwards compatibility.

4.0.106.453 4.0 Release
callid char (11) True Unknown

The callid number of this call attempt. For more information, see the discussion of callid in the Reporting Data Dictionary.

4.0.106.453 4.0 Release
callidkey char (18) True Unknown

This internal, site-unique key identifies a call in the system. It is an 18 character alphanumeric strings whose format may change from release to release, though the values will always be unique. This field is not referenced in any report, but can be used by customers to cross-reference Dialer calls with the standard call data stored in the CIC database. For more information, see the discussion of callidkey in the Reporting Data Dictionary.

4.0.106.453 4.0 Release
wrapupcategory varchar2 (80) False Unknown

A code that generally identifies the completion status of the call. Used to provide standardized reporting across multiple campaigns. See the Dialer Manager Help guide for more information.

If you create a custom wrap-up category, this column will contain a GUID that is associated with the display name of the custom wrap-up category. To match the GUID to the display name for reporting purposes, you will have to use the WrapupCategory lookup table. See WrapupCategory Table

4.0.106.453 4.0 Release
wrapupcode varchar2 (80) False Unknown

A code that more specifically indicates the outcome of the call. Wrap-up codes add granularity to reporting, while wrap-up Categories provide for standardized reporting across multiple campaigns. See the Dialer Manager Help guide for more information.

If you create a custom wrap-up code, this column will contain a GUID that is associated with the display name of the custom wrap-up category. To match the GUID to the display name for reporting purposes, you will have to use the WrapupCode lookup table. See WrapupCode Table

4.0.106.453 4.0 Release
callingmode number True Unknown

Value Meaning
0 Non-Dialer Call
1 Predictive
2 Power
3 Preview
8 Agentless
4.0.106.453 4.0 Release
phonenumber varchar2 (50) True Unknown

The telephone number dialed for this attempt.

4.0.106.453 4.0 Release
phonenumbertype varchar2 (80) True Unknown

The customer-defined phone number type associated with the phone number dialed. This is used for reporting purposes.

When using the Follow Up Call feature, you will find the term 'NULL' in the phonenumbertype column if this was an ad-hoc call where the number was manually entered.

4.0.106.453 4.0 Release
agentid varchar2 (80) True Unknown

The CIC User ID of the Agent who processed the call, as it is defined in Interaction Administrator.

4.0.106.453 4.0 Release
calledpartyoffset number True Unknown

Offset in seconds used to adjust UTC times based on the called party's time zone.

4.0.106.453 4.0 Release
odsoffset number False Unknown

Offset in seconds used to adjust UTC times based on ODS's time zone.

4.0.106.453 4.0 Release
previewpoptimeUTC date True Unknown

In Preview mode, the time when the call record popped for the Agent to review. This is the time that Preview call data was presented to an Agent (not the actual call time.)

4.0.106.453 4.0 Release
callplacedtimeUTC date True Unknown

The time when the call was placed by Telephony Services.

4.0.106.453 4.0 Release
callansweredtimeUTC date True Unknown

The time when the call was answered by the remote party or a device.

4.0.106.453 4.0 Release
messageplaytimeUTC date True Unknown

The time that a message was played to the contact, due to the campaign type or due to the absence of available agents.

4.0.106.453 4.0 Release
callconnectedtimeUTC date True Unknown

The time that the call was connected to the Agent.

4.0.106.453 4.0 Release
calldisconnectedtimeUTC timestamp False Unknown

The time when Dialer stopped tracking the call. This can occur when the call is disconnected or the call is completed upon a disposition being received from either by an agent or the system.

4.0.106.453 4.0 Release
length number True Unknown

Length of the call in seconds. The length column in the Call History table does not always match the call duration. The callplacedtimeUTC and calldisconnectedtimeUTC accumulators are tracked internally by Dialer and may not match Interaction Summary information for the call. The length field is calculated from the Completed time minus the Start time. The completed time is set when the call is completed and the wrapup code is written. That happens after policy evaluations and agent finalization. The start time occurs when the call is placed. The length field can match the (Disconnected - Placed) time when the disconnect was a result of the wrapup and finalization of the interaction. This can occur if you disposition an interaction while the call is still live.

4.0.106.453 4.0 Release
caresult number True Unknown

Value Meaning
0 Represents an unknown call result. Call analysis could not determine what the remote party was, but the call did succeed and connect. Dialer treats this as live voice.
1 Voice detected. A human answered the call.
2 The carrier sent a SIT tone or a SIT message.
3 A Fax machine answered.
4 An Answering Machine answered the call.
5 The call failed with an ISDN Cause Code returned from the carrier.
6 Failure. The call failed in Telephony Services for some reason other than the above.
4.0.106.453 4.0 Release
cadetail varchar2 (255) True Unknown

Call Analysis results for each call are written to the CallHistory table along with the other information about the call, such as Wrap-up Codes and Categories, call id, and so forth. This allows reporting to be done not just on disposition, but also on call analysis results. This is important for customers whose call analysis is performed by Media Servers.

Two columns in CallHistory table facilitate this:

  • caresult indicates the result of call analysis.
  • cadetail provides a textual description of the call analysis result.

The cadetail (call analysis detail) column is text field up to 255 characters in length that contains extra information that supplements the caresult value.

For example, if caresult is 2 (SIT), cadetail would contain a description of the SIT tone/message. For a caresult of 5 (ISDN Cause Code) cadetail would contain a description of the ISDN cause code. For caresult 6 (Failure) cadetail would contain a description of the error returned from MakeCall. Null values are allowed, since some caresult codes do not generate detail information.

4.0.106.453 4.0 Release
isabandoned number True Unknown

This flag indicates whether the call was abandoned (1=Yes, 0=No). This value can be set by Dialer or by a script. See Interaction Scripter Developer Guide for details.

4.0.106.453 4.0 Release
iscontact number True Unknown

This flag indicates whether the call reached a live contact (1=Yes, 0=No). Contacts are defined in the Dialer configuration. Specifically, the 'Interaction Connected to an Actual Person' checkbox in Wrap Up Categories affects the 'iscontact' field.

4.0.106.453 4.0 Release
isdetect number True Unknown

Signifies whether call analysis detected that the call was answered by a person. If call analysis is turned off, the value will always be 1 (true) since those calls are treated as live voice.

4.0.106.453 4.0 Release
isrpc number True Unknown

Signifies whether the call was a right party contact.

4.0.106.453 4.0 Release
issuccess number True Unknown

Signifies whether the campaign result was achieved, governed by the 'interaction was successful' setting on the wrap-up Category.

4.0.106.453 4.0 Release
successresult float (8) True Unknown

This column is populated with the value of the successresult column on the contact.

Successresult is a customer-managed column in both the ContactList and CallHistory tables. Customers can use successresult to maintain running counters, such as a money counter for example. The value of 'successresult' can be NULL when records are added or updated.

The value of successresult in a CallHistory row will contain whatever was in the successresult column of the associated contact at the time the history row was written (when the record was dispositioned).

4.0.106.453 4.0 Release
customdata1 varchar2 (255) True Unknown

Provided for customer use. Not used by Dialer.

4.0.106.453 4.0 Release
customdata2 varchar2 (255) True Unknown

Provided for customer use. Not used by Dialer.

4.0.106.453 4.0 Release
campaignfilterid number True Unknown

The ID assigned to the filter that is applied to the campaign.

4.0.106.453 4.0 Release
previewtimerinit number True Unknown

This flag indicates whether a Preview call was initiated manually or automatically through a campaign configured preview timer.

  • If it is a 1, then the call was initiated automatically through a campaign configured preview timer.
  • If it is a 0, then the call was initiated manually.
  • If it is null, then the call was made using a dialing mode other than Preview.
4.0.106.453 4.0 Release
rulegroupid number True Unknown

The ID assigned to the Rule Group that was set. You can find more details about the RuleGroupID, such as the name of the Rule Group, in the CallHistory_RuleGroup table.

15.3.0.384 Added for reporting on a campaign with context information from the rule group.
callscheduletime date True Unknown

When a scheduled callback occurs, this field will show the date and time that the call was scheduled. (Based on CCS time)

More specifically, when a call results in a scheduled callback, a record is added the CallHistory table for that call and both the wrapupcategory and wrapupcode entries will contain the word Scheduled. The callscheduletime entry will be set to NULL at this point.

When the scheduled callback actually occurs, a second record will added to the CallHistory table for that call; only this time the callscheduletime entry will show the date and time when the call was scheduled and the wrapupcategory and wrapupcode entries will contain appropriate values.

Keep in mind that the callscheduletime entry will NOT indicate when the actual call occurred - just the time that the call was scheduled to occur. If you wish to determine the elapsed time between when the call was scheduled and when the call was actually made, you will need to check the callplacedtimeUTC entry in the record.

4.0.106.453 4.0 Release
isAdditionalCall number True Unknown

This flag indicates whether the call is one of the additional calls made to the same contact using the Follow Up Call feature or an standard call.

  • If it is a 1, the then call was one of several additional calls made to the same contact.
  • If it is a 0, then the call was a standard call.
4.0.106.453 4.0 Release
agentoverride number True Unknown

If the agent chose an override option while using the Follow Up Call feature, there will be a code number in this column that indicates what type of override that occurred. To find out what type of override the code number indicates, you'll need to check the AgentComplianceOverrides table. By performing an SQL join of the CallHistory table and the AgentComplianceOverrides table, a database administrator can extract the pertinent data.

4.0.106.453 4.0 Release
callhistory_id number False Unknown

Correlates this record with a row in the CallHistory table

18.4.0.000 Added column for joining the record to the Call History Details table.

Constraints

Primary Key Name Type Column Name (sort order)
PK_CALLHISTORY_ID Non-clustered callhistory_id (Ascending)

Primary Key Name Column Name (sort order)
PK_CALLHISTORY_ID callhistory_id (Ascending)


Index Name Type Column Name (sort order)
IX_CallHistory_CampAgtPlaced Non-clustered campaignname (Ascending)
agentid (Ascending)
callplacedtimeUTC (Ascending)
IX_CallHistory_Campaign_Date Non-clustered campaignname (Ascending)
callconnectedtimeUTC (Ascending)
IX_CallHistory_CampPlaced Non-clustered campaignname (Ascending)
callplacedtimeUTC (Ascending)
IX_CallHistory_Date Clustered callconnectedtimeUTC (Ascending)
UX_CallHistory Unique non-clustered calldisconnectedtimeUTC (Ascending)
callidkey (Ascending)
campaignname (Ascending)
i3_identity (Ascending)

Index Name Column Name (sort order)
IX_CallHistory_CampAgtPlaced campaignname (Ascending)
agentid (Ascending)
callplacedtimeUTC (Ascending)
IX_CallHistory_Campaign_Date campaignname (Ascending)
callconnectedtimeUTC (Ascending)
IX_CallHistory_CampPlaced campaignname (Ascending)
callplacedtimeUTC (Ascending)
IX_CallHistory_Date callconnectedtimeUTC (Ascending)
UX_CallHistory calldisconnectedtimeUTC (Ascending)
callidkey (Ascending)
campaignname (Ascending)
i3_identity (Ascending)