Get all conversation messages
get
/crmRestApi/resources/11.13.18.05/conversationMessages
Request
Query Parameters
-
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
finder: string
Used as a predefined finder to search the collection.
Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>
The following are the available finder names and corresponding finder variables- AllInquiryMessages Finds conversation messages associated with a channel for inquiry.
Finder Variables - AllUnlinkedSalesMessages Finds conversation messages associated with a sales channel but not associated with any sales objects such as leads or activities.
Finder Variables - ConversationMessageByObject Finds the list of conversation messages associated with given objects such as service, leads, or activities.
Finder Variables- BindObjectId; integer; The unique identifier of the business object, such as help desk request or sales lead.
- BindObjectTypeCd; string; The type of object record that's stored for OBJECT_ID, such as SVC_SERVICE_REQUESTS.
- MessageByNumber Finds a conversation message with the specified message number.
Finder Variables- MessageNumber; string; The alternate key identifier of the message.
- MyInboundMessages Finds inbound conversation messages with the specified finder variable.
Finder Variables- BindRecipientPartyId; string; The party identifier of the recipient to search for.
- MyInboundMessagesToReply Finds new inbound conversation messages where the logged in user is one of the recipients.
Finder Variables- BindRecipientPartyId; string; The party identifier of the recipient to search for.
- MyMessages Finds conversation messages where the logged in user is one of the recipients.
Finder Variables- BindRecipientPartyId; string; The party identifier of the recipient to search for.
- MyMessagesToReply Finds new conversation messages where the logged in user is one of the recipients.
Finder Variables- BindRecipientPartyId; string; The party identifier of the recipient to search for.
- PastMessages Finds past messages in the conversation thread of a given message.
Finder Variables- BindMessageId; string; The unique identifier of the message for which to find past messages.
- PrimaryKey Finds a conversation message with the specified primary key.
Finder Variables- MessageId; integer; The unique identifier of the conversation message.
- AllInquiryMessages Finds conversation messages associated with a channel for inquiry.
-
limit: integer
This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
-
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
offset: integer
Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
-
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
-
orderBy: string
This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
-
q: string
This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY
Format: ?q=expression1;expression2
You can use these queryable attributes to filter this collection resource using the q query parameter:- AssignedToPartyId; integer; The unique identifier of the resource party to whom the conversation message is assigned. This isn't used currently and reserved for future.
- AssignedToPartyNumber; string; The alternate key identifier of the resource party to whom the conversation message is assigned. This isn't used currently and reserved for future.
- AssignedToPersonName; string; The name of the resource assigned to the conversation message. This isn't used currently and reserved for future.
- ChannelId; integer; The unique identifier of the channel associated with the conversation message.
- ChannelTypeCd; string; The code indicating the type of channel associated with the conversation message.
- ChannelTypeCdMeaning; string; The name of the channel type associated with the conversation message, such as Email or Social.
- ConversationBUOrgId; integer; The unique identifier of the business unit organization associated with the conversation.
- ConversationId; integer; The unique identifier of the conversation to which the message is associated.
- ConversationNumber; string; The alternate key identifier of the conversation to which the message is associated.
- ConversationStripeCd; string; The code indicating the application stripe of the conversation, such as CRM, HRHD, or ISR.
- ConversationTypeCd; string; The code indicating the type of the conversation, such as Customer or Collaboration.
- CreatedBy; string; The user who created the conversation message.
- CreationDate; string; The date when the conversation message was created.
- InboundStatusCd; string; The status code of an inbound or internal collaboration message.
- InboundStatusCdMeaning; string; The display value of the status of an inbound or internal collaboration message
- LastUpdateDate; string; The date when the conversation message was last updated.
- LastUpdateLogin; string; The login details of the user who last updated the conversation message.
- LastUpdatedBy; string; The user who last updated the conversation message.
- MessageAlternateId; string; The alternate identifier of the message.
- MessageCount; string; The total number of messages associated with a conversation.
- MessageId; integer; The unique identifier of the conversation message.
- MessageNumber; string; The alternate key identifier of the conversation message.
- MessageSendDate; string; The date when an outbound message should be sent.
- MessageStatusCd; string; The status code of a message, such as DRAFT or COMMITTED.
- MessageTemplate; string; The name of the template associated with the conversation message.
- MessageTemplateObjTypeCd; string; The object type for which the conversation message was created, such as Service Request, Opportunities, Sales Lead.
- MessageTitle; string; The title of the conversation message.
- MessageTypeCd; string; The code indicating the type of the conversation message, such as INBOUND or OUTBOUND.
- MessageTypeCdMeaning; string; The value of conversation message type, such as Inbound, Outbound, Internal Note, System Response, or System Note.
- MsgTemplateObjectId; integer; The unique identifier of the object associated with the message template.
- OriginalSystemReference; string; The original application reference of an imported conversation message.
- ParentMessageId; integer; The unique identifier of the parent message of the current conversation message. When a user replies to a message the original message becomes the parent message of the reply.
- ParentMessageNumber; string; The alternate key identifier of the parent message.
- ProcessingAPPCd; string; The code indicating the application that will be processing the message such as Oracle Marketing Cloud or CX Sales. Typically, this is used for outbound messages.
- ProcessingAPPContentReferenceId; string; The reference ID of the message's content in the application processing the message. This is used when an application other than CX Sales processes the outbound message such as Oracle Marketing Cloud.
- ProcessingAPPMsgId; string; The processing application's message identifier. This is used when an application other than CX Sales processes the outbound message such as Oracle Marketing Cloud.
- ProcessingStatusCd; string; The code indicating the processing status of the conversation message, such as WAITING, READY, ERROR, or SUCCESS.
- ProcessingStatusDetail; string; The details of the conversation message processing status.
- QueueId; integer; The unique identifier of the queue that the conversation message is assigned to. This isn't used currently and reserved for future.
- QueueName; string; The name of the queue that the conversation message is assigned to. This isn't used currently and reserved for future.
- QueueNumber; string; The alternate key identifier of the queue that the conversation message is assigned to. This isn't used currently and reserved for future.
- ReportedDate; string; The date when the conversation message was reported. Typically this date would be the same as the created date unless the message was imported.
- SenderAlternateId; integer; The alternate identifier of the message sender.
- SenderFreeFormAddress; string; The free form address of the sender of the message. For example, the email address of the sender.
- SenderPartyId; integer; The unique identifier of the sender party.
- SenderPartyName; string; The name of the sender party.
- SenderPartyNumber; string; The alternate key identifier of the sender party.
- SenderPartyTypeCd; string; The party type code of the message sender such as ORA_SVC_BUSINESS_CONTACT, ORA_SVC_RESOURCE.
- SentDate; string; The date when the message was sent by the sender. This field isn't populated when a message is automatically created via channels like email, social, and so on.
- SourceCd; string; The code indicating the source of the conversation message, such as ORA_SVC_AGENT_UI, API, or ORA_SVC_INBOUND_MSG.
-
totalResults: boolean
The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : conversationMessages
Type:
Show Source
object-
count(required): integer
The number of resource instances returned in the current range.
-
hasMore(required): boolean
Indicates whether more resources are available on the server than the subset returned in the response. If the value is true, then there are more resources to retrieve from the server. The default value is false.
-
items: array
Items
Title:
ItemsThe items in the collection. -
limit(required): integer
The actual paging size used by the server.
-
links(required): array
Links
Title:
LinksThe link relations associated with the resource instance. -
offset(required): integer
The offset value used in the current page.
-
totalResults: integer
The estimated row count when "?totalResults=true", otherwise the count is not included.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : conversationMessages-item-response
Type:
Show Source
object-
AssignedToPartyId: integer
(int64)
Title:
Assigned ToThe unique identifier of the resource party to whom the conversation message is assigned. This isn't used currently and reserved for future. -
AssignedToPartyNumber: string
Title:
Assigned to Party NumberRead Only:trueMaximum Length:30The alternate key identifier of the resource party to whom the conversation message is assigned. This isn't used currently and reserved for future. -
AssignedToPersonName: string
Title:
Assigned to Party NameRead Only:trueMaximum Length:360The name of the resource assigned to the conversation message. This isn't used currently and reserved for future. -
attachments: array
Attachments
Title:
AttachmentsThe attachments resource is used to view, create, and update attachments. -
ChannelId: integer
(int64)
Title:
Channel IDThe unique identifier of the channel associated with the conversation message. -
ChannelTypeCd: string
Title:
Channel TypeMaximum Length:30The code indicating the type of channel associated with the conversation message. -
ChannelTypeCdMeaning: string
Title:
Channel Type ValueRead Only:trueMaximum Length:255The name of the channel type associated with the conversation message, such as Email or Social. -
ConversationBUOrgId: integer
(int64)
Title:
Conversation Business UnitThe unique identifier of the business unit organization associated with the conversation. -
ConversationId: integer
(int64)
Title:
Conversation IDThe unique identifier of the conversation to which the message is associated. -
ConversationNumber: string
Title:
Conversation NumberMaximum Length:30The alternate key identifier of the conversation to which the message is associated. -
ConversationStripeCd: string
Title:
Conversation StripeMaximum Length:255The code indicating the application stripe of the conversation, such as CRM, HRHD, or ISR. -
ConversationTypeCd: string
Title:
Conversation TypeMaximum Length:255The code indicating the type of the conversation, such as Customer or Collaboration. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the conversation message. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the conversation message was created. -
InboundStatusCd: string
Title:
Inbound Message StatusMaximum Length:30The status code of an inbound or internal collaboration message. -
InboundStatusCdMeaning: string
Title:
StatusRead Only:trueMaximum Length:255The display value of the status of an inbound or internal collaboration message -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the conversation message was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the conversation message. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the conversation message. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MessageAlternateId: string
Title:
Message Alternate IDMaximum Length:100The alternate identifier of the message. -
MessageContent: string
(byte)
Title:
Message ContentThe content of the conversation message, such as the contents of an email. -
MessageCount: string
Title:
Message CountRead Only:trueMaximum Length:80The total number of messages associated with a conversation. -
MessageId: integer
(int64)
Title:
Message IDRead Only:trueThe unique identifier of the conversation message. -
MessageNumber: string
Title:
Message NumberMaximum Length:30The alternate key identifier of the conversation message. -
MessageSendDate: string
(date-time)
Title:
Message Send DateThe date when an outbound message should be sent. -
MessageStatusCd: string
Title:
Message StatusMaximum Length:30The status code of a message, such as DRAFT or COMMITTED. -
MessageTemplate: string
Title:
Message TemplateMaximum Length:320The name of the template associated with the conversation message. -
MessageTemplateObjTypeCd: string
Title:
Message Template Object TypeMaximum Length:30The object type for which the conversation message was created, such as Service Request, Opportunities, Sales Lead. -
MessageTitle: string
Title:
SubjectMaximum Length:1000The title of the conversation message. -
MessageTypeCd: string
Title:
Message TypeMaximum Length:30The code indicating the type of the conversation message, such as INBOUND or OUTBOUND. -
MessageTypeCdMeaning: string
Title:
Message TypeRead Only:trueMaximum Length:255The value of conversation message type, such as Inbound, Outbound, Internal Note, System Response, or System Note. -
MsgTemplateObjectId: integer
(int64)
Title:
Message Template Object IDThe unique identifier of the object associated with the message template. -
OriginalSystemReference: string
Title:
Original Application ReferenceMaximum Length:1000The original application reference of an imported conversation message. -
ParentMessageId: integer
(int64)
Title:
Parent Message IDThe unique identifier of the parent message of the current conversation message. When a user replies to a message the original message becomes the parent message of the reply. -
ParentMessageNumber: string
Title:
Parent Message NumberMaximum Length:30The alternate key identifier of the parent message. -
ProcessingAPPCd: string
Title:
Processing ApplicationMaximum Length:30The code indicating the application that will be processing the message such as Oracle Marketing Cloud or CX Sales. Typically, this is used for outbound messages. -
ProcessingAPPContentReferenceId: string
Title:
Processing Application Content Reference IDMaximum Length:30The reference ID of the message's content in the application processing the message. This is used when an application other than CX Sales processes the outbound message such as Oracle Marketing Cloud. -
ProcessingAPPMsgId: string
Title:
Processing Application Message IDMaximum Length:30The processing application's message identifier. This is used when an application other than CX Sales processes the outbound message such as Oracle Marketing Cloud. -
ProcessingStatusCd: string
Title:
Processing StatusMaximum Length:30The code indicating the processing status of the conversation message, such as WAITING, READY, ERROR, or SUCCESS. -
ProcessingStatusDetail: string
Title:
Processing Status DetailMaximum Length:1000The details of the conversation message processing status. -
QueueId: integer
(int64)
Title:
Queue IDThe unique identifier of the queue that the conversation message is assigned to. This isn't used currently and reserved for future. -
QueueName: string
Title:
Queue NameRead Only:trueMaximum Length:400The name of the queue that the conversation message is assigned to. This isn't used currently and reserved for future. -
QueueNumber: string
Title:
Queue NumberRead Only:trueMaximum Length:30The alternate key identifier of the queue that the conversation message is assigned to. This isn't used currently and reserved for future. -
recipients: array
Conversation Message Recipients
Title:
Conversation Message RecipientsMessage recipients. -
ReportedDate: string
(date-time)
Title:
Reported DateThe date when the conversation message was reported. Typically this date would be the same as the created date unless the message was imported. -
SenderAlternateId: integer
(int64)
Title:
Sender Alternate IDThe alternate identifier of the message sender. -
SenderFreeFormAddress: string
Title:
Sender Free Form AddressMaximum Length:320The free form address of the sender of the message. For example, the email address of the sender. -
SenderPartyId: integer
(int64)
Title:
Sender Party IDThe unique identifier of the sender party. -
SenderPartyName: string
Title:
SenderRead Only:trueMaximum Length:360The name of the sender party. -
SenderPartyNumber: string
Title:
Sender Party NumberRead Only:trueMaximum Length:30The alternate key identifier of the sender party. -
SenderPartyTypeCd: string
Title:
Sender Party TypeMaximum Length:30The party type code of the message sender such as ORA_SVC_BUSINESS_CONTACT, ORA_SVC_RESOURCE. -
SentDate: string
(date-time)
Title:
Sent DateThe date when the message was sent by the sender. This field isn't populated when a message is automatically created via channels like email, social, and so on. -
smartActions: array
Smart Actions
Title:
Smart ActionsThis VO stores the endpoint and security details for every user action. -
SourceCd: string
Title:
SourceMaximum Length:30The code indicating the source of the conversation message, such as ORA_SVC_AGENT_UI, API, or ORA_SVC_INBOUND_MSG.
Nested Schema : Attachments
Type:
arrayTitle:
AttachmentsThe attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Conversation Message Recipients
Type:
arrayTitle:
Conversation Message RecipientsMessage recipients.
Show Source
Nested Schema : Smart Actions
Type:
arrayTitle:
Smart ActionsThis VO stores the endpoint and security details for every user action.
Show Source
Nested Schema : conversationMessages-attachments-item-response
Type:
Show Source
object-
AsyncTrackerId: string
Title:
Asynchronous Upload Tracker IdAttribute provided for the exclusive use by the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document IdThe unique identifier of the attached document. -
CategoryName: string
Title:
CategoryMaximum Length:30The category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:255The user who created the record. -
CreatedByUserName: string
Title:
Created By User NameRead Only:trueThe user name who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
DatatypeCode: string
Title:
TypeMaximum Length:30Default Value:FILEA value that indicates the data type. -
Description: string
Title:
DescriptionMaximum Length:255The description of the attachment. -
DmDocumentId: string
Maximum Length:
255The document ID from which the attachment is created. -
DmFolderPath: string
Title:
Dm Folder PathMaximum Length:1000The folder path from which the attachment is created. -
DmVersionNumber: string
Maximum Length:
255The document version number from which the attachment is created. -
DownloadInfo: string
Title:
DownloadInfoJSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status CodeThe error code, if any, for the attachment. -
ErrorStatusMessage: string
Title:
Error Status MessageThe error message, if any, for the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration DateThe expiration date of the contents in the attachment. -
FileContents: string
(byte)
Title:
File ContentsThe contents of the attachment. -
FileName: string
Title:
File NameMaximum Length:2048The file name of the attachment. -
FileUrl: string
Title:
File UrlThe URI of the file. -
FileWebImage: string
(byte)
Title:
File Web ImageRead Only:trueThe base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:255The user who last updated the record. -
LastUpdatedByUserName: string
Title:
Last Updated By UserRead Only:trueThe user name who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingActionThe name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
TitleThe title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content TypeThe content type of the attachment. -
UploadedFileLength: integer
Title:
File SizeThe size of the attachment file. -
UploadedFileName: string
Title:
Uploaded File NameThe name to assign to a new attachment file. -
UploadedText: string
Title:
Uploaded TextThe text content for a new text attachment. -
Uri: string
Title:
UriMaximum Length:4000The URI of a Topology Manager type attachment. -
Url: string
Title:
UrlMaximum Length:4000The URL of a web page type attachment. -
UserName: string
Title:
User NameRead Only:trueMaximum Length:255The login credentials of the user who created the attachment.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : conversationMessages-recipients-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the conversation message recipient. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the conversation message recipient was created. -
FreeFormAddress: string
Title:
Free Form AddressMaximum Length:320The free form address of the conversation message recipient. E.g. the email address of the sender. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the conversation message recipient was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the conversation message recipient. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the conversation message recipient. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MessageId: integer
(int64)
Title:
Message IDThe unique identifier of the conversation message. -
MessageNumber: string
Title:
Message NumberMaximum Length:30The alternate key identifier of the conversation message. -
PersonId: integer
(int64)
Title:
Person IDThe unique identifier of the recipient. This is populated if the recipient is an internal person such as an employee and contingent worker. -
RecipientAlternateId: integer
(int64)
Title:
Recipient Alternate IDThe alternate identifier of the recipient such as the identifier of the recipient in an external system. -
RecipientAlternateMessageId: string
Title:
Message Alternate IDMaximum Length:1000The alternate identifier of the message in an external system. -
RecipientId: integer
(int64)
Title:
Recipient IDRead Only:trueThe unique identifier of the conversation message recipient. -
RecipientNumber: string
Title:
Recipient NumberMaximum Length:30The public unique identifier of the conversation message recipient. -
RecipientPartyId: integer
(int64)
Title:
Recipient Party IDThe unique identifier of the party of the conversation message recipient. -
RecipientPartyName: string
Title:
Recipient NameRead Only:trueMaximum Length:360The name of the party of the conversation message recipient. -
RecipientPartyNumber: string
Title:
Recipient Party NumberRead Only:trueMaximum Length:30The alternate key identifier of the party of the conversation message recipient. -
RecipientPartyTypeCd: string
Title:
Recipient Party TypeMaximum Length:30The party type code of the message recipient such as ORA_SVC_BUSINESS_CONTACT, ORA_SVC_RESOURCE. -
RecipientTypeCd: string
Title:
Recipient TypeMaximum Length:30The code indicating the type of the recipient in the conversation message, such as TO, CC, or BCC.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : conversationMessages-smartActions-item-response
Type:
Show Source
object-
ActionContextParameters: string
Title:
Action Context ParametersMaximum Length:1000Determines the context when a smart action is applicable. -
ActionIntent: string
(byte)
Title:
Action IntentJSON object that describes what an action does and what context data can be passed to the action. -
ActionSource: string
Title:
Action SourceMaximum Length:512Attribute that describes the source of a smart action. Smart actions can be manually created or cloned, or automatically generated. -
ActiveFlag: boolean
Title:
ActiveMaximum Length:1Boolean value indicating if the action is active or inactive. -
ApplicationRoles: string
Title:
Application RolesMaximum Length:2000The application roles associated with the smart action. -
Condition: string
Title:
Filter ConditionMaximum Length:1000Groovy script used to qualify this action. -
ConfirmationMessage: string
Title:
Confirmation MessageMaximum Length:4000A message to seek confirmation for the action being performed. -
ContentType: string
Title:
Content TypeMaximum Length:50The content type to use when invoking the REST endpoint. -
ContextualFlag: boolean
Title:
ContextualMaximum Length:1Indicates if the smart action is contextual. -
DataPrivilege: string
Title:
Data Security PrivilegeMaximum Length:250JSON string containing the Privilege name, the object name, and the object key. -
DisplayLabel: string
Title:
Action NameMaximum Length:256Consumer-friendly action name. -
Entity: string
Title:
Parent EntityMaximum Length:150REST Resources the action belongs to. -
Href: string
Title:
REST EndpointMaximum Length:1024The REST endpoint to perform the action. -
IncludedIn: string
Title:
Included InMaximum Length:150The view object this action is part of. Could contain more than one comma-separated value. -
IncludedInApplication: string
Title:
Included in ApplicationMaximum Length:512List of applications that this action can be used in. -
InternalFlag: boolean
Title:
RestrictedMaximum Length:1Boolean type indicating if this action is internal. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MassActionFlag: boolean
Title:
Mass ActionMaximum Length:1Boolean type indicating if this action can be mass processed. -
Method: string
Title:
HTTP MethodMaximum Length:15HTTP method to use with HREF. -
ObjectFunctionName: string
Title:
Object FunctionMaximum Length:64The object function associated with the smart action. -
PageType: string
Title:
Page TypeMaximum Length:256The list of pages that this action can be used in. -
SmartSuggestFlag: boolean
Title:
Smart SuggestMaximum Length:1Indicates if smart suggest is enabled for the action. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Boolean type indicating if the action is seeded or custom. -
UpdateOfAttributes: string
Title:
Attributes to UpdateMaximum Length:512Attributes to be updated when the Actions UI is launched. -
UserActionId: integer
(int64)
Title:
User Action IDUniquely identifies the action. For internal use. -
UserActionName: string
Title:
Action NameMaximum Length:256Uniquely identifies the action with a name. For internal use. - UserActionNavigation: array Smart Action User Interface Definitions
-
UserActionRank: integer
(int64)
Title:
PriorityNumber to indicate priority of the action. -
UserActionRequestPayload: array
Smart Action REST Payload Definitions
Title:
Smart Action REST Payload DefinitionsIf an LOV required for constructing a request payload needs to post data, the payload metadata is stored here. -
UserActionURLBinding: array
Smart Action User Interface Definitions
Title:
Smart Action User Interface DefinitionsBinding metadata for a variable in the URL. -
UserPrivilege: string
Title:
User Security PrivilegeMaximum Length:4000The user security privilege.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Smart Action REST Payload Definitions
Type:
arrayTitle:
Smart Action REST Payload DefinitionsIf an LOV required for constructing a request payload needs to post data, the payload metadata is stored here.
Show Source
Nested Schema : Smart Action User Interface Definitions
Type:
arrayTitle:
Smart Action User Interface DefinitionsBinding metadata for a variable in the URL.
Show Source
Nested Schema : conversationMessages-smartActions-UserActionRequestPayload-item-response
Type:
Show Source
object-
Binding: string
Title:
Payload Value Binding TypeMaximum Length:64Indicates the binding type of the value. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
MandatoryMaximum Length:1Boolean value indicating if the payload is mandatory. -
RequestPayloadId: integer
(int64)
Uniquely identifies the payload for smart actions. For internal use.
-
RequestPayloadName: string
Title:
Request Payload Attribute NameMaximum Length:256The key in the Key Value pair that forms the payload. -
SmartSuggestPath: string
Title:
Smart Suggest PathMaximum Length:2048The path used for smart suggest. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Default Value:falseBoolean value. -
Value: string
Title:
Request Payload Attribute ValueMaximum Length:1000The value in the Key Value pair that forms the payload. -
ValueStruct: string
Title:
Payload Value StructureMaximum Length:20If the value in the Key Value pair isn't a single value, this would be set.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : conversationMessages-smartActions-UserActionURLBinding-item-response
Type:
Show Source
object-
Binding: string
Title:
URL Binding TypeMaximum Length:64This is a hint for processing the Url Binding runtime. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Default Value:falseBoolean indicator. -
URLBindingId: integer
(int64)
Uniquely identifies the URL Bind for smart actions. For internal use.
-
URLBindingName: string
Title:
URL Binding Parameter NameMaximum Length:256For action REST endpoints that require runtime binding, this is the key in the key value pair. -
Value: string
Title:
URL Binding Parameter ValueMaximum Length:1000For action REST endpoints that require runtime binding, this is the value in the key value pair.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- copyAttachmentsToConversationMessage
-
Operation: /crmRestApi/resources/11.13.18.05/conversationMessages/action/copyAttachmentsToConversationMessageCopies attachments to a specific conversation message.
- createConversationMessageForBusinessObject
-
Creates a conversation, conversation message, conversation message recipients, and associates the conversation with one or more business objects.
Examples
The following example shows how to get all conversation messages by submitting a get request on the REST resource using cURL.
cURL Command
curl --location
'https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/describe'
-X GET
Example of Request Body
The following shows an example of the request body in JSON format.
Example of Response Body
The following shows an example of the response body in JSON format.
{
"items" : [ {
"MessageId" : 300100571392602,
"MessageNumber" : "CDRM_0000000002",
"CreatedBy" : "automsgcenterAdmin2",
"CreationDate" : "2022-11-11T07:52:29+00:00",
"LastUpdatedBy" : "automsgcenterAdmin2",
"LastUpdateDate" : "2022-11-11T07:52:34+00:00",
"LastUpdateLogin" : "ED2D888E9B61901EE0536F6315AC143A",
"MessageTypeCd" : "ORA_SVC_OUTBOUND",
"MessageTitle" : "Title of Internal Collaboration Conversation 1_73359",
"SourceCd" : null,
"ChannelTypeCd" : "ORA_SVC_EMAIL",
"ChannelTypeCdMeaning" : "E-Mail",
"InboundStatusCd" : null,
"InboundStatusCdMeaning" : null,
"MessageStatusCd" : "ORA_SVC_COMMITTED",
"ProcessingStatusCd" : "ORA_SVC_SUCCESS",
"ProcessingStatusDetail" : null,
"SentDate" : "2022-11-11T07:52:34.307+00:00",
"MessageSendDate" : null,
"OriginalSystemReference" : null,
"ConversationId" : 300100571390602,
"ConversationNumber" : "CDRM_0000000001",
"ConversationTypeCd" : "ORA_SVC_COLLABORATION",
"ConversationStripeCd" : "ORA_SVC_CRM",
"ConversationBUOrgId" : 204,
"ParentMessageId" : 300100571390601,
"ParentMessageNumber" : "CDRM_0000000001",
"ChannelId" : null,
"QueueId" : null,
"QueueNumber" : null,
"QueueName" : null,
"AssignedToPartyId" : null,
"AssignedToPartyNumber" : null,
"AssignedToPersonName" : null,
"ProcessingAPPCd" : "ENGAGEMENT_CENTER",
"ProcessingAPPMsgId" : null,
"ProcessingAPPContentReferenceId" : null,
"MessageTemplateObjTypeCd" : "ORA_SVC_SERVICE_REQUESTS",
"MessageTemplate" : null,
"SenderPartyId" : 300100181732720,
"SenderPartyNumber" : "CDRM_871796",
"SenderPartyName" : "automsgcenterAdmin2 svc",
"SenderPartyTypeCd" : "ORA_SVC_RESOURCE",
"ReportedDate" : "2022-11-11T07:52:29+00:00",
"SenderFreeFormAddress" : "sendmail-test-discard@oracle.com",
"MessageCount" : "2",
"MsgTemplateObjectId" : 300100571390592,
"SenderAlternateId" : null,
"MessageAlternateId" : null,
"MessageTypeCdMeaning" : "Outbound",
"links" : [ {
"rel" : "self",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002",
"name" : "conversationMessages",
"kind" : "item",
"properties" : {
"changeIndicator" : "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
}
}, {
"rel" : "canonical",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002",
"name" : "conversationMessages",
"kind" : "item"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002/child/attachments",
"name" : "attachments",
"kind" : "collection"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002/child/recipients",
"name" : "recipients",
"kind" : "collection"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002/child/smartActions",
"name" : "smartActions",
"kind" : "collection"
}, {
"rel" : "enclosure",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/CDRM_0000000002/enclosure/MessageContent",
"name" : "MessageContent",
"kind" : "other"
} ]
},....
"count" : 25,
"hasMore" : true,
"limit" : 25,
"offset" : 0,
"links" : [ {
"rel" : "self",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages",
"name" : "conversationMessages",
"kind" : "collection"
}, {
"rel" : "action",
"href" : "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/conversationMessages/action/createConversationMessageForBusinessObject",
"name" : "createConversationMessageForBusinessObject",
"kind" : "other"
} ]
}