The details API is used to get all the details for an interaction.
UI Reference: The API is called when the details of an interaction are displayed.
URI: webapp-api-History?api=details
Access Rights Required: Agents. Customers use the findanswers API to get their own history.
Name |
Type |
Description |
---|---|---|
interactionID |
String |
This parameter represents the id of interaction to get history details. |
{ |
The response includes all of the details for a single interaction.
Name |
Type |
Description |
---|---|---|
id |
String |
The id of interaction. |
threadID |
String |
The id of the case that the interaction is in. If it's the same as the id, then it's the root interaction. |
date |
String |
The date the interaction was created. |
type |
String |
The type of interaction. See the user guide for examples of interaction types. |
tags |
String |
Tags are used to label interactions for special display. For example, open quote tickets contain a tag to mark them for display in the Open Quotes pages. |
subject |
String |
The subject of the interaction. |
subjectBare |
String |
The subject without the reference number prepended. |
status |
String |
This is the current status of the interaction. See the user guide for examples of statuses. |
customerID |
String |
The id of the contact that owns the interaction (e.g., sender of email). |
customerName |
String |
The name the contact that owns the interaction. |
bodyPlain |
String |
This is body content of message without html format |
bodyHtml |
String |
The HTML version of the interaction body. |
note |
String |
Private comments entered by an agent for the interaction. |
interactionProperties |
Array |
This returns an array of property values, if property values are set in the interaction.See Properties for Display to see the structure of properties. |
caseproperties |
Array |
This returns all an array of case properties and their values if property values are set in the interaction. |
attachments |
Array |
An array of attachments which are included with the interaction. |
statusAudit |
Array |
An array of strings. Status audit records are recorded for every change in status of the interaction. For example, agent assignment, topic change, resolved status, etc. |
statusAudit[].timestamp |
String |
The time the action occured. |
statusAudit[].date |
String |
This returns the date of interaction. |
statusAudit[].action |
String |
The action performed on the interaction, such as assigned via Get Next. |
statusAudit[].modifierID |
String |
The ID of the user that performed the action. |
statusAudit[].modifierName |
String |
The name of the user that performed the action. |
statusAudit[].topicID |
String |
The topic id of the interaction. |
statusAudit[].topicName |
String |
The name of the topic to which the interaction is assigned. |
statusAudit[].assignedToID |
Number |
The id of the agent assigned to the interaction. |
statusAudit[].assignedToName |
Number |
The full name of the agent if the message is assigned to an agent. |
statusAudit[].statusID |
String |
The ID of the status of the interaction |
statusAudit[].statusName |
String |
The short name for the status change. |
segmentID |
String |
This has the value of the segment id in which interaction belongs to. |
segmentName |
String |
This has the value of the segment name in which interaction belongs to. |
topicID |
String |
This has the value of topic id in which interaction belongs to. |
topicName |
String |
This has the value of the topic name in which interaction belongs to. |
assignedToID |
String |
This is the id of the agent if the message is assigned to any agent. |
assignedToName |
String |
This is the full name of the agent if the message is assigned to any agent. |
modifiedByName |
String |
This is the full name of the agent who modified the interaction. |
approvedByName |
String |
This is the full name of the agent who approved the ticket,CM etc. |
resolvedByName |
String |
This is the name of the agent if the message is resolved by any agent. |
fromAddress |
String |
Email address who has initiated the interaction. |
toAddress |
String |
The email address to which the interaction was sent. This will be blank for customer and agent tickets. |
headerFrom |
String |
This shows the email address from which ticket was submitted. |
headerTo |
String |
This shows the email address of the person to whom E-mail is being sent. |
cc |
String |
This is the email address of cc if added in the message. |
bcc |
String |
This is the email address of bcc if added in the message. |
history |
Array |
An array of strings. This provides basic information about the interaction. |
history[].Id |
String |
This returns the id of interaction. |
history[].subject |
String |
This returns the subject of interaction. |
history[].type |
String |
This is a type of interaction like Agent Email or Note or Ticket. |
history[].tag |
Array |
An array of strings. Tags are used to label interactions for special handling in the user interface. |
history[].date |
String |
This returns the date of interaction. |
{ |