Platform API
User Type

User Types

Depending on which type of a channel your users are chatting in, they are given different labels, as well as access to different actions and information. Users can also interact privately with others by registering them as friends, or block others from sending direct messages. In some cases, users can be given an operator role and moderate other regular users who commit abnormal activities.


User vs. Participant vs. Member

TypeDefinition

User

Scope: application
Refers to one who can access all the chat features of a SendBird application with their own unique ID, but does not have administrative privileges.

Participant

Scope: open channels
Refers to a specific user who has entered an open channel without an invitation and is staying online in the channel. Open channel participants are not provided relational information such as connection status, typing indicators, and read receipts of other participants, as opposed to group channel members. With limited information shared with others, they can enter and exit the channel at all times.

Member

Scope: group channels
Refers to a specific user who has joined a group channel through an invitation from an existing member or from their own choice to join the group due to the channel’s characteristics. Relational information such as connection status, typing indicators, and read receipts of the group channel members can be made available to each other depending on the channel’s settings.


Friend and Blocked

A user can register other users within an application as friends, and start an instant 1-on-1 group chat with a friend or invite friends to existing group channels. On the other hand, a user can block other users to stop receiving any further messages from them in 1-on-1 group channels, and not to be notified of their new messages in 1-on-N group channels. You can choose whether or not a user can view which users they have blocked in the UI of the channel.

A SendBird application provides two blocking options: including or excluding blocked users in invitations and turning on/off push notifications from blocked users. The previous block modes are now deprecated and only supported for customers who have been using it from before.

  • Including or excluding blocked users in invitations: determines for a user whether or not to automatically filter out already blocked users when inviting a group of users to a new group channel. The value of this option can be manually adjusted only from our side before integrating your SendBird application to an app. If you want to change the value, contact our engineering team for further assistance. (Default: including)
  • Turning on/off push notifications from blocked users: determines for a user whether or not to receive push notifications for the messages from already blocked users within a specific 1-on-N group channel where they are members of together. The value of this option can be set individually by channel. If you want to use this option, contact our engineering team for further assistance. (Default: off)
1-on-1 group channel
Channel listPush notificationsMessages

A user's channel list will not be updated and rearranged from the blocked user's messages.

A user will not be notified that the blocked user sent a message.

New messages sent from the blocked user will not be delivered to the channel, but are saved and displayed to the blocked user's channel view. The blocked user is not aware of their blocked status.
A user can only see the messages that the blocked user has sent previously before blocking.
(If the blocked user is unblocked, a user can see all the messages except those that were sent during the blocking period.)

1-on-N group channel (group chat)
Channel listPush notificationsMessages

A user's channel list will be updated and rearranged from a blocked user's messages.

If the push notifications from blocked users is turned on, messages sent from blocked users will be notified to a user. Otherwise, they will not be notified.

All the messages from blocked users are delivered to the channel. You can choose whether or not a user can view which users they have blocked in the UI of the channel.


Operator

You can assign operators on each channel to moderate participants or members with abnormal activities by banning and muting participants/members in a channel. The banned participants/members who are kicked out of the channel can participate/join the channel after the banning time specified by operators. Muted participants/members are allowed to stay in the channel and view the messages, but can't talk in the channel until the operators unmute them.