Add Users to Group Mute Exceptions

Add one or more group members to the mute exceptions list for a specified group.

• Once added to the group's mute exceptions list, members can still send messages to the group via the client SDK even if the group is set to mute all members.
• If a user on the exceptions list leaves and rejoins the group, their exception status remains valid.
• If the group is disbanded and recreated, the exceptions status remains valid.

tip

The group mute feature for individual users takes precedence. If an individual mute is active, even if the user is added to the mute exceptions list, they still cannot send messages to the group.

Request Method

POST: https://data center domain/group/user/ban/whitelist/add.json

Rate Limit: 100 requests per second

Signature Rule: All server API requests require signature verification. For details, see API Request Signature.

Body Parameters

The HTTP request body may include the following form parameters:

Parameter	Type	Required	Description
userId	String	Yes	User ID. Supports adding multiple users at once, up to 20.
groupId	String	Yes	Group ID.

Request Example

POST /group/user/ban/whitelist/add.json HTTP/1.1
Host: api.rong-api.com
App-Key: c9kqb3rdkbb8j
NONCE: 97
TIMESTAMP:  1480479442
SIGNATURE:  9774e3d91656dc92df8aff294d46d6a506412538
Content-Type: application/x-www-form-urlencoded

groupId=2MqOJa1Un&userId=3212&userId=2583

Response

The HTTP response body contains a JSON object with the following structure:

Return Value	Type	Description
code	Number	Return code, 200 for success.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"code":200}