The startagentmail API is used to get details for Agent Email forms.
UI Reference: The API is called when the Agent Email form is loaded. This API endpoint is only used to prepare the Agent Email form for submission. The interaction is created using the createemail endpoint.
URI: webapp-api-History?api=startagentmail
Access Rights Required: All agents
Name |
Type |
Description |
---|---|---|
topicID |
String |
This parameter represents the id of the topic. |
interactionID |
String |
This parameter represents the id of interaction. |
segmentID |
String |
This parameter represents the id of segment. |
customerID |
String |
This parameter represents the id of the customer. |
{ |
The response data provides all the information needed to populate the Agent Email form. Agent Emails can be initiated as the beginning of a new case, or in response to an existing interaction.
Name |
Type |
Description |
---|---|---|
errors |
Array |
An array of strings. Returns the error message if an error is encountered, otherwise a blank array if there is no error. |
errorsDetails |
Array |
An array of strings. Provides detailed information about the error encountered, otherwise returns a blank array if no error is encountered. |
interactionProperties |
Array |
This returns all properties and their values if property value set in interaction. |
caseProperties |
Array |
This returns all case properties and their values if property value set in interaction. |
caseProperties[].name |
String |
This represents the name of the property. |
caseProperties[].properties |
Array |
Array of Property details.see property data structure. |
caseProperties[].logins |
Number |
This property has a list of objects with login details including name and type of property value. |
caseProperties[].canModifyLogins |
Boolean |
This property represents rights of modification in logins. |
quotedBody |
String |
|
attachments |
Array |
This has all the attachments which are added in interaction. |
mailboxes |
Array |
This has a list of saved mailboxes. |
mailboxes[].Id |
String |
This returns the id of interaction. |
mailboxes[].name |
String |
This represents the name of the property. |
mailboxes[].replyTo |
String |
Email address of mailbox. |
addresses |
Array |
All email addresses of users. |
responsesAgent |
Array |
List of all default responses saved by Agent. |
responsesAgent[].id |
String |
This returns the id of interaction. |
responsesAgent[].name |
String |
This represents the name of the property. |
responsesAgent[].description |
String |
Description about response. |
responsesAgent[].bodyHtml |
String |
This is body content of message with html format |
responsesSegment |
Array |
List of all default responses saved under segment. |
responsesSegment[].id |
String |
This has the value of the segment id in which interaction belongs to. |
responsesSegment[].name |
String |
This has the value of the segment name in which interaction belongs to. |
responsesSegment[].description |
String |
Description about response. |
responsesSegment[].bodyHtml |
String |
This is body content of message with html format |
notifications |
Array |
List of all default notifications. |
notifications[].id |
String |
This returns the id of interaction. |
notifications[].name |
String |
This represents the name of the property. |
notifications[].segmentID |
String |
This has the value of the segment id in which interaction belongs to. |
notifications[].isSecuredNotification |
Boolean |
List of all default notifications. |
{ |