End or Inactivate a Messaging Session
Ends or suspends a messaging session.
Only use this API if routing is partner-owned (if ConversationChannelDefinition.routingOwner is set to Partner).
Use this API to end or suspend a messaging session while noting whether the action came from a Messaging End User or your partner system. The End or Inactivate a Messaging Session API doesn’t rely on an End Chat UI component interaction in Salesforce or the session inactivation timeout set by the Salesforce admin in the Messaging Channel. The partner system uses this API to notify Salesforce if a chat has ended or become inactive. The rep can then receive a status notification, start After Conversation Work, if enabled, and move on to the next session or work item.
This API applies to the following product:
- Bring Your Own Channel for Contact Center as a Service
This API is available in version 65.0 and later.
v1/messagingSession
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.
- For Bring Your Own Channel for CCaaS, set
<AuthorizationContext>to the developer name of the ConversationChannelDefinition record. For example, Partner1_ChannelDefinition1. Required. - For Bring Your Own Channel for Messaging, set
<AuthorizationContext>to the developer name of the ConversationChannelDefinition record. For example, Partner1_ChannelDefinition1. Required.
| Property Name | Type | Description | Required |
|---|---|---|---|
| channelAddressIdentifier | string | The globally unique ID (GUID) for the conversation channel (MessagingChannel.ChannelAddressIdentifier) field. Maximum size is 240 characters. | Yes |
| endUserClientId | string | The end user client identifier. This value comes from the partner system and can be up to 240 characters long. | Yes |
| conversationIdentifier | string | The unique ID for the conversation channel. | Yes |
| sessionId | string | The messaging session ID. | No |
| operation | string | Specifies the action to take on the messaging session. Valid values are: - End - Inactivate | Yes |
| operationBy | string | Specifies where the operation originated from. Valid values are: - EndUser - System | No |
If success is false, ErrorReason lists the reason why the Messaging session wasn’t successfully ended or inactivated. Valid values are:
ACTIVE_CONVERSATION_NOT_FOUNDEND_SESSION_FAILEDINTERNAL_ERRORPERMISSION_DENIEDCHANNEL_ADDRESS_NOT_FOUNDSESSION_NOT_FOUNDEND_USER_NOT_FOUNDORG_NOT_FOUNDCONVERSATION_PRECONDITION_FAILEDCONVERSATION_PROCESSING_ABORTEDCHANNEL_ADDRESS_IS_INACTIVECUSTOMER_ERROR
- GitHub: Interaction Service APIs