Digital Samba Embedded
  • Getting started
    • Sign up to create a new team
    • Choose your subdomain
    • Authenticate to the API
    • Regenerate your developer key
  • Setting up your team
    • Update your subdomain
    • Customise your domain
    • Customize Access to Recordings, Transcripts, and Files
    • Add members to your team
    • Assign a team-role to your team members
    • Remove members
  • Configuring your room defaults
    • General settings
    • Branding
    • Components
    • Content Library
    • Recordings
    • Chat
    • Captions
    • Polls
    • Q&A
    • Transcription
    • Join settings
  • Creating a room
    • General settings
    • Branding
    • Components
    • Content Library
    • Recordings
    • Chat
    • Breakout rooms
    • Polls
    • Captions
    • Q&A
    • Transcription
    • Join settings
    • Telephony
    • External stream
  • Managing rooms
  • Adding moderation to your rooms with roles
    • Add roles to a room
    • Create a custom role
    • Permissions
  • Managing roles
  • Controlling room entry
  • Libraries
  • Recordings
  • Webhooks
  • Tokens
  • Troubleshooting sessions
    • Session details
    • Participant details
    • Participant log
  • Retrieving session data and reports
  • Understanding usage data
  • System check
  • REST API docs
  • SDK docs
  • LTI docs
Powered by GitBook
On this page

Controlling room entry

As a team member, you can configure your rooms with specific rules to control room entry.

PreviousManaging rolesNextLibraries

Last updated 4 months ago

While this feature applies to all types of rooms, there are a few things worth noting. Digital Samba allows you to create single-role rooms and multi-role rooms. As the name implies, a single-role room is a room where all participants have the same user role. Single-role rooms are commonly used for meetings where moderation is not a requirement. On the other hand, a multi-role room is a room in which various user roles have been defined, likely for the purposes of introducing some type of moderation. .

Single-role rooms can only be locked manually, once you are in the room. They cannot be locked by default. The first user will always be able to enter the room, provided they have been granted the permission to start a session. They can then choose to lock the room, and subsequent users will be placed in the waiting room. When the last user leaves, the room is automatically unlocked.

Multi-role rooms can be locked either manually or by configuring the . A locked multi-user room can only be entered by users who have permission to do so. All other users will end up in a waiting room. .

Participants will seamlessly join, be asked to wait to be accepted into the session or be asked to wait until the session starts depending on the combination of a few factors. The below table lists all the possible permutations.

Roles in the room
Do I have the 'Start session' permission
Do I have the 'Control room entry' permission?
Did someone start the session?
Is the room locked when I try to join?
What happens then?

Single

No

All cases

No

All cases

"Please wait until the session starts, you will be automatically joined"

Single

No

All cases

Yes

No

I can join seamlessly.

Single

No

All cases

Yes

Yes

"Please wait to be accepted into the session"

Single

Yes

All cases

No

No

I can join seamlessly.

Single

Yes

All cases

No

Yes

It's impossible to set a room to be locked in single-role rooms.

Single

Yes

All cases

Yes

No

I can join seamlessly.

Single

Yes

All cases

Yes

Yes

"Please wait to be accepted into the session"

Multiple

No

No

No

No

"Please wait until the session starts, you will be automatically joined"

Multiple

No

No

No

Yes

"Please wait until the session starts, you will be automatically joined"

Multiple

No

No

Yes

No

I can join seamlessly.

Multiple

No

No

Yes

Yes

"Please wait to be accepted into the session"

Multiple

No

Yes

No

No

"Please wait until the session starts, you will be automatically joined"

Multiple

No

Yes

No

Yes

"Please wait until the session starts, you will be automatically joined"

Multiple

No

Yes

Yes

No

I can join seamlessly.

Multiple

No

Yes

Yes

Yes

I can join seamlessly.

Multiple

Yes

No

No

No

I can join seamlessly.

Multiple

Yes

No

No

Yes

I can join seamlessly.

Multiple

Yes

No

Yes

No

I can join seamlessly.

Multiple

Yes

No

Yes

Yes

I can join seamlessly.

Multiple

Yes

Yes

No

No

I can join seamlessly.

Multiple

Yes

Yes

No

Yes

I can join seamlessly.

Multiple

Yes

Yes

Yes

No

I can join seamlessly.

Multiple

Yes

Yes

Yes

Yes

I can join seamlessly.

Discover more about custom roles here
room settings that define the default state of the room
See how you can assign permissions here