Deletes the Pending Service Routing (PSR) record for the specified conversation.
This API doesn’t need to be called for most scenarios; the PSR record is automatically deleted when the call is no longer being routed. However, there are some scenarios, like for missed or abandoned messages when using partner telephony systems (excluding Amazon Connect), where you must explicitly call this API to clear the PSR record.
This API applies to the following product:
This API is available in version 62.0 and later.
v1/route
DELETE
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.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 |
|---|---|---|---|
| cancelReason | enum | The reason why conversation routing was cancelled. Valid values include: - UNKNOWN (0) - An unknown cancellation reason such as an error. - UNAVAILABLE (1) - The rep was unavailable. - DECLINE (2) - The rep declined. - CANCEL (3) - Generic cancellation reason. | No |
| conversationIdentifier | string | The unique ID for the conversation channel. | Yes |
1{
2 "conversationIdentifier": "1234a5bc-52b8-43ed-9608-7997f7b88dc1",
3 "cancelReason": "Decline"
4}
j