Moderation, Roles & Privileges
In order to have moderation privileges, a user has to be assigned a role. Currently, we offer three tiers of roles for users and one tier for admins
Moderation Overview
We determine a user's moderation capabilities based on their current role.
Roles | Description |
None | The user has no moderation privileges |
Moderator | The user can assert general moderation privileges on other users |
Super-Moderator | The user can assert general moderation privileges and be exempt from moderation from other users |
Global-Admin (Admin Only)* | The user can assign the roles of others, assert all moderation privileges and be exempt from moderation |
*This role cannot be assigned to a user, but only to an Admin.
When you are routed to ASC Console after clicking Go to console in your newly created application in Amity Portal, you will be logged in as a super-admin. This is different from the global-admin and must NOT be used for normal administration tasks for the following reasons:
It cannot generate an Admin API access token used in making server-to-server API calls.
It must be reserved for operations that only a super-admin can perform such as uploading a push notification certificate.
You must create a new admin account for normal administration tasks.
Change User Role
You can promote a user's role from a member to a moderator. Alternatively, a community moderator can also be demoted to a member.
These are the steps to change a user's role:
In the left menu, select Community > Communities.
In the Community Management page, select a community.
In the community's page, click Members tab.
In the Change role pop-up, select the user's new role and click Confirm to submit.
Create Role
You can create a new role with customized permissions by following these steps:
in the left menu, select Users > Roles.
In the Create role page, provide a name for the role that you will create.
Customize the permissions by selecting from the list in the Permissions section on the right.
Click Create.
Admin Moderation Privileges
Amity Social Cloud Console provides administrators the ability to observe and control messages in channels.
Moderation tools range from automatic operations such as the blocklisting of words/phrases to controlled operations such as the manual banning and muting of users.
Blocklisting
Blocklisting is used to block certain words from being sent in Amity's Chat and Social SDK. When a word is blocklisted, anytime a user attempts to send a message, comment, or a post with that word, it will not be sent.
Contents that are moderated are:
Messages
Posts
Comments
Poll questions and answers
Contents that are not moderated include:
Community names
Community category names
Channel names
User display names
File names
Reaction names
Network names
Role names
Allow List
Amity by default prevents any link or URL from being sent. However, websites can be whitelisted so that links with that website domain can be sent.
You can enable or disable this feature.
Banning Users
There are 2 types of ban that can be performed on a user:
Global Ban
Channel Ban
Global Ban
Admins have the ability to global ban a user. When a user is globally banned, they will no longer be able to authenticate with ASC and will be forcibly removed from all their existing channels. All the globally banned user's messages will also be deleted. If the SDK has already cached the messages, they will only disappear when refreshed. Note that the global banned user's social content, such as posts, comments, and community membership, will not be removed.
The globally banned user will not be able to authenticate with Amity's network again until they have been globally unbanned.
Global-banning a user
To perform a global ban on a user:
In ASC Console, go to Users.
Select the user you wish to ban.
In Actions, click the ban user icon.
Click Confirm in the confirmation pop-up.
When a user is global-banned, it can take up to 30 seconds before the user is disconnected from the network. Global ban also does not emit channel ban event and there would be no update via Live Collection.
Global-unbanning User
To unban a user who has been globally banned:
In ASC Console, go to Users.
Select the user you wish to unban.
In Actions, click the unban user icon.
Click Confirm in the confirmation pop-up.
Channel Ban
Admins also have the ability to ban a user at the channel level. When a user is banned in a channel, unlike global ban, the user will not get disconnected but will only get an event on both user and channel level. All messages of the banned user in the specified channel will be soft deleted.
There is a real-time event telling online users in the channel that a user has been banned. Therefore, SDK can do soft delete locally and reflects the changes on to the message list right away via LiveCollection.
Channel-banning User
To perform a channel ban on a user:
In ASC Console, go to Channels.
Select the channel where the User is a member.
Click Members button.
Select the User in the channel that you wish to ban.
In Actions, click the ban user icon.
Click Confirm in the confirmation pop-up.
Channel-unbanning User
To unban a user who has been banned in the channel:
In ASC Console, go to Channels.
Select the channel where the User is a member.
Click Members button.
Select the User in the channel that you wish to ban.
In Actions, click the unban user icon.
Click Confirm in the confirmation pop-up.
General Moderation Privileges
These moderation tools are available to all admins and users with moderator and super-moderator roles
Muting and Unmuting
Moderators can mute and unmute users. When a user is muted, they cannot send messages in a channel. However, muted users will still be allowed to observe messages in a channel. The status of being muted is indefinite but is only applied at the channel level.
Banning Unbanning
Moderators can ban and unban users. When a user is banned in a channel, they are forcibly removed from the channel and may no longer participate or observe messages in that channel. All their previous messages in the channel will also be automatically deleted.
A user that has been banned from a channel can not rejoin the channel until they have been unbanned.
Moderation Level
Any frontend user of a network can be promoted into a moderator. There are two types of moderators:
Network Level Moderators They can moderate all posts, comments, and users in all communities across the entire network.
Community Level Moderators They have the same set of permissions as the Network Level Moderators but are only limited within the community wherein they are the moderator.
UIKit for iOS and Android supports both moderation levels so all moderators can see more menus not available to non-moderators.
UIKit for web supports community-level moderation only.
Moderator Permissions
Making a user an administrator allows them to:
Create, edit, or delete roles
Create, edit, or delete community categories
Delete or edit communities
Add, edit, ban, or remove community users
Edit, review, or delete community posts
Edit or delete community comments
Manage posts, comments, and communities
How to promote a user to network-level moderator
To promote a user to a network-level moderator, perform these steps:
In ASC Console, go to Users.
Select the user you wish to upgrade.
In Actions, click the Change role icon.
Select Network Moderator from the user role dropdown.
How to promote a user to a community-level moderator
Promoting a user to a community-level moderator can be done via API, SDK, or by the Change User Role settings in the Console.
Last updated