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
We determine a user's moderation capabilities based on their current role.
*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.
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.
Select the member and click the Change user role button.
In the Change role pop-up, select the user's new role and click Save to submit.
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.
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 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
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.
There are 2 types of ban that can be performed on a user:
Global Ban
Channel 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.
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.
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.
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.
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.
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.
These moderation tools are available to all admins and users with moderator and super-moderator roles
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.
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.
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.
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
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.
Promoting a user to a community-level moderator can be done via API, SDK, or by the Change User Role settings in the Console.
In the Roles & Permissions page, click the Create a new role button on the upper right.
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
