Message Push Service (MPS) enables you to revoke messages that have been pushed. With this function, notifications that have been sent but not viewed or cleared will disappear from the device notification bar. To reduce business loss and related impacts, this function mainly applies to the following two scenarios: 1. Wrong messages are pushed due to misoperations; 2. Messages that have been pushed but need to be revoked urgently in case of temporary business changes.
You can query the message status and revoke messages through the mPaaS console. In addition, MPS supports backend APIs. You can revoke messages by calling APIs in the business system.
The mode of implementing message revocation varies with the push channel. The following table describes the specific details.
Push channel | Revocation supported or not | How it works | |
---|---|---|---|
Vendor channel | Huawei | Yes | Overlap a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be cleared. The "Message revoked" message is displayed. |
Xiaomi | Yes | Overlap a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be cleared. The "Message revoked" message is displayed. | |
OPPO | Yes | Overlap a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be cleared. The "Message revoked" message is displayed. | |
Vivo | Yes | Revoke a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be directly cleared. That is, the message will disappear from the notification bar. | |
Apple (iOS) | Yes | Overlap a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be cleared. The "Message revoked" message is displayed. | |
MPS self-built channel | Yes | Overlap a message. After the client receives the command of revoking a message, the message displayed in the notification bar will be cleared. The "Message revoked" message is displayed. | |
SMS push | No | The SMS messages that have been sent cannot be revoked. |
Revoke a message by the mPaaS console
Log in to the mPaaS console, and select a target app. In the navigation pane on the left, choose Message Push Service >
Message management .Select a message push task type to enter the message list page.
Select a message to be revoked, click Revoke, and click
OK . After you perform the revocation operation, a message that is being pushed will not be pushed. A message that has been pushed but is not displayed will not be displayed.
Revoke a message by calling APIs
A message pushed in the simple push mode can be revoked by the message ID. A message pushed in the multiple push mode can be revoked by the task ID. Only messages in recent 7 days can be revoked.
For how to revoke a message by calling APIs, see the documentation listed in Message revocation API.