Sends “Delivered” or “Read” acknowledgments so that reps know when outbound messages have been delivered or read by the message recipient.
This API marks a conversation entry as “Delivered” after the message reaches the message recipient or “Read” after the message recipient reads the message.
Each request can support up to 25 delivery and read acknowledgments. If the request includes multiple acknowledgments, the last message received based on the acknowledgements.acknowledgementTimestamp value will be marked.
This API applies to the following products:
This API is available in version 62.0 and later.
v1/acknowledgement
POST
Format: Bearer <Salesforce Access Token>
String. Standard header. Used to authenticate the user, where <Salesforce Access Token> is the Salesforce access token used as the bearer token to make requests to the Interaction Service APIs. Required.
Format: application/json
String. Standard header. Format of the request payload. Required for any request that includes a body.
Format: <Salesforce Org ID>
String. Custom header. The Salesforce org. <Salesforce Org ID> is the 15-character Org ID of the Salesforce org. Required.
Format: <UUID>
String. Custom header. Universally Unique Identifier (<UUID>) that references and tracks this request. Required.
Format: <AuthorizationContext>
String. Custom header. Additional information for the request authorization used to authenticate and validate requests against the connected app scopes.
<AuthorizationContext> to the developer name of the ConversationChannelDefinition record. For example, Partner1_ChannelDefinition1. Required.<AuthorizationContext> to the developer name of the ConversationChannelDefinition record. For example, Partner1_ChannelDefinition1. Required.1-H $'Authorization: Bearer 00DSG000009SWby!...LN8XxeRIxGe' \
2-H "content-type: application/json" \
3-H "OrgId: 00DSG000009SWby" \
4-H "AuthorizationContext: Partner1_ChannelDefinition1" \
5-H "RequestId: a1b23c45-c06a-4784-c96c-cb95d3321bda" \| Property Name | Type | Description | Required |
|---|---|---|---|
| sender | object | An object representing a messaging participant. The participant can be a rep or end user. | Yes |
| sender.appType | string | The app type used for the conversation. Set this value to custom to represent a custom channel. | Yes |
| sender.subject | string | The end user client identifier. | Yes |
| sender.role | string | The role within the conversation. Set this value to EndUser. | Yes |
| conversationIdentifier | string | The unique ID for the conversation channel. | Yes |
| acknowledgements | string | A list of delivery acknowledgments and read receipts, sorted in chronological descending order by acknowledgements.acknowledgementTimestamp. Each request can support up to 25 delivery and read acknowledgments. If multiple outbound messages are sent, the rep sees the last acknowledgment in the list. | Yes |
| acknowledgements.acknowledgementTimestamp | int64 | The date and time of the delivery acknowledgment or read receipt. | Yes |
| acknowledgements.acknowledgementType | string | The type of acknowledgment. Valid values are delivery for delivery acknowledgments, and read for read receipts. | Yes |
| acknowledgements.acknowledgedConversationEntryIdentifier | string | The unique identifier for the conversation entry that’s associated with the acknowledgment. | Yes |
| acknowledgements.acknowledgmentCreatedConversationEntryIdentifier | string | The client-supplied unique identifier to set when storing the new acknowledgment conversation entry. This can be any UUID generated by the partner. | Yes |
1{
2 "sender" : {
3 "appType" : "custom",
4 "subject" : "end-user-0001",
5 "role" : "EndUser"
6 },
7 "conversationIdentifier" : "a12b3c45-2239-453e-866c-c6db0a826f23",
8 "acknowledgements" : [{
9 "acknowledgementTimestamp" : "1719430624",
10 "acknowledgementType" : "Read",
11 "acknowledgedConversationEntryIdentifier" : "9a8bc7d6-6c56-4d9a-bd09-a7f66527bb6d",
12 "acknowledgmentCreatedConversationEntryIdentifier" : "1234abc5-478c-4d4c-b1f5-fe1a300efc9d"
13 },
14 {
15 "acknowledgementTimestamp" : "1719434324",
16 "acknowledgementType" : "Delivered",
17 "acknowledgedConversationEntryIdentifier" : "987a6bcd-4e6e-4327-97b8-bd5e50d4bae1",
18 "acknowledgmentCreatedConversationEntryIdentifier" : "09876543-62b7-47fe-9658-dd00da0f0ba4"
19 }]
20}
j