Message Push lets you revoke messages. This feature removes sent notifications from a device's notification bar if the user has not clicked or cleared them. You can use this feature to recall messages urgently, for example, if you sent incorrect content by mistake or if business needs suddenly change. This helps minimize the impact and potential business loss.
You can query message status and revoke messages in the mPaaS console. Message Push also provides a backend API that you can call from your business system to revoke messages.
The implementation of message revocation varies depending on the push channel. The following table describes the differences.
Push channel | Supports revoke | Revoke method | |
Vendor channel | Huawei | Yes | Overwrite message. When the client receives the revoke instruction, it deletes the message from the notification bar and displays "Message revoked". |
Xiaomi | Yes | Overwrite message. When the client receives the revoke instruction, it deletes the message from the notification bar and displays "Message revoked". | |
OPPO | Yes | Overwrite message. When the client receives the revoke instruction, it deletes the message from the notification bar and displays "Message revoked". | |
vivo | Yes | Revoke message. When the client receives the revoke instruction, it directly deletes the message from the notification bar. The message disappears. | |
Apple (iOS) | Yes | Overwrite message. When the client receives the revoke instruction, it deletes the message from the notification bar and displays "Message revoked". | |
MPS self-built channel | Yes | Overwrite message. When the client receives the revoke instruction, it deletes the message from the notification bar and displays "Message revoked". | |
Text message push | No | Sent text messages cannot be revoked. | |
Revoke messages from the console
Log on to the mPaaS console. Select your target application. In the navigation pane on the left, choose Message Push > Message Management.
Select a message push task type to go to the corresponding message list page.
Select the message that you want to revoke, click Revoke, and then confirm the operation. After you revoke a message, any in-progress pushes for that message are stopped. Messages that have been delivered but not yet displayed are also canceled.
Revoke messages by calling an API
For simplified push, revoke messages using the message ID. For batch push, revoke messages using the task ID. You can only revoke messages that were sent within the last 7 days.
For more information, see Message Revoke API.