All Products
Search
Document Center

Mobile Platform as a Service:Message revocation

Last Updated:May 25, 2023

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

  1. Log in to the mPaaS console, and select a target app. In the navigation pane on the left, choose Message Push Service > Message management.

  2. Select a message push task type to enter the message list page.

  3. 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.