If a notification message sent by an application contains an error or incorrect redirect link, it will give end users a negative impression of the involved product/service after they view or click it. In this case, you should fix the problem in time. You can choose to terminate, recall, or override the message, or cancel the related scheduled task if there is any. This document describes how to do so through the console and RESTful APIs.
Platform | Termination | Recall | Override | Scheduled task cancellation |
---|---|---|---|---|
Android | Supported | This feature is still being upgraded and not available yet. | Supported only for the Tencent Push Notification Service channel, Mi channel, Meizu channel, and Huawei devices on EMUI 10 and later | Supported |
iOS | Not supported | This feature is still being upgraded and not available yet. | Supported | Supported |
Note:Message termination, recall, and override are supported only for notifications whose push target is push to all devices, push to a list of accounts, or push to devices with specific tags.
Scheduled task cancellation is supported only for notifications whose push target is push to all devices, push by account package, and push to devices with specific tags.
Note:When you select message override, for vivo, OPPO, and Huawei (below EMUI 10) devices that do not support message override, you can choose whether to continue the message delivery:
- If you choose to continue the delivery, the notification message will be overridden, and both the new and original messages will appear in the device notification center at the same time.
- If you choose to abort the delivery, no new notification messages will be sent to the above devices that do not support message override.
Request method: POST
Request Address
Service URL/v3/push/stop_push_msg
The API service address corresponds to the service access point one by one; therefore, please select the service address corresponding to your application service access point.
Parameter | Type | Required | Description |
---|---|---|---|
pushId | String | Yes | Push task ID |
{
"pushid":"43214535"
}
Request method: POST
Request Address
Service URL/v3/push/revoke_push_msg
The API service address corresponds to the service access point one by one; therefore, please select the service address corresponding to your application service access point.
Note:Message recall will terminate the offline message delivery of the current push task by default.
Parameter | Type | Required | Description |
---|---|---|---|
pushId | String | Yes | Push task ID |
{
"pushid":"150032"
}
collapse_id
of the push taskCall the API for querying push information for one task and get the collapse_id
, for example, 0001, from the corresponding response parameter.
When you call the push API, add the collapse_id
, for example, 0001, obtained in step 1. You can also set the force_collapse
field to decide whether to deliver the message to devices that do not support message override.
Note:Message override will terminate the offline message delivery of the original push task by default.
{
"audience_type": "all",
"collapse_id": 0001,
"force_collapse":false,
"message_type": "notify",
"message": {
"title": "Override message 0001",
"content":"It's a nice day today"
},
"platform": "android"
}
Request method: POST
Request Address
Service URL/v3/push/cancel_timing_task
The API service address corresponds to the service access point one by one; therefore, please select the service address corresponding to your application service access point.
Note:Cancel a scheduled task that has not yet been scheduled.
Parameter | Type | Required | Description |
---|---|---|---|
pushId | String | Yes | Push task ID |
{
"pushid":"15003211"
}
Was this page helpful?