User roles & meeting permissions

Whereby allows your participants to join a video meeting without creating accounts or logins. If you want some users to have altered privileges in the meeting, you can use different URL types

Hosts

Users joining via the hostRoomURL become meeting hosts and have the following features available:

• Lock and unlock the room.

• Enter locked rooms without knocking.

• Respond and allow access to participants that are knocking.

• Remove, mute, and spotlight meeting participants.

• Remove chat messages and files shared by any participant.

• Start and stop recordings, if available.

• Start and stop breakout groups, if available.

Host privileges are valid immediately on room creation and are disabled one hour after the endDate.

A hostRoomURL is only available if the hostRoomURL is included in the fields parameter when creating a meeting via the API.

Example request body:

{
    "endDate": "2099-03-25T13:30:00.000Z",
    "fields": ["hostRoomUrl"]
}

Response:

{
    "meetingId": "1234",
    "startDate": "2022-03-09T13:50:00.000Z",
    "endDate": "2099-03-25T13:30:00.000Z",
    "roomUrl": "https://example.whereby.com/room",
    "hostRoomUrl": "https://example.whereby.com/room?roomKey=eFhcG...i00ZG"
}

Now that you have both a roomUrl and a hostRoomUrl, you can ensure that both your guests and hosts get the right privileges by using the corresponding URL when embedding rooms in your own webpage or app.

Participants

Users joining via the standard roomUrl will have a more typical meeting experience. They will only have access to the features you've set via URL parameters or the dashboard, and they will need to knock to gain entry to locked rooms.

A roomUrl will be included with any POST meeting creation requests.

Example request body:

{ 
    "endDate": "2099-03-25T13:30:00.000Z", 
}

Response:

{
    "meetingId": "1234",
    "startDate": "2022-03-09T13:50:00.000Z",
    "endDate": "2099-03-25T13:30:00.000Z",
    "roomUrl": "https://example.whereby.com/room",
}

Viewers

In Viewer Mode, participants joining as Viewers have their camera and microphone access disabled. Viewers can gain access to locked rooms without knocking and can only interact with Hosts and Participants by using the Chat, if you've enabled that in the room.

This is a 1.0 feature and might change in the future.

Meetings created in "group" mode can support up to 200 hosts or participants. Viewer mode can support an additional 400 viewers for a total of 600 viewers, hosts, and participants.

Using Viewer Mode for meetings created in "normal" mode (2-4 people) may present technical issues. Viewer Mode is intended to be used in "group" meetings instead.

Example request body:

{
    "endDate": "2099-03-25T13:30:00.000Z",
    "templateType": "viewerMode"
}

Response:

{
    "meetingId": "1234",
    "startDate": "2022-03-09T13:50:00.000Z",
    "endDate": "2099-03-25T13:30:00.000Z",
    "roomUrl": "https://example.whereby.com/room",
    "hostRoomUrl": "https://example.whereby.com/room?roomKey=eFhcG...i00ZG"
    "viewerRoomUrl": "https://example.whereby.com/room?roomKey=eFhcG...VTQIE"
}

Explore more in the API reference.