Skip to main content

​
Video

Orbit’s video channel gives you live, in-browser video rooms that run over WebRTC on Orbit Media (Devotel’s hosted SFU). Rooms need nothing installed — a guest joins from a link in any modern browser — and they live on the same account as your SMS, voice, WhatsApp, and email, so a video session lands in the shared inbox alongside the rest of the conversation. This page is the concept-and-reference surface: room kinds, join tokens, the embed, recording, moderation, and broadcast. For the full endpoint parameter and response contract see the Video API reference; for the ordered walkthroughs see Video meetings and conferences, Video room access tokens, and the embedded video consultation button.

​
Two kinds of rooms

Scheduled rooms are the first-class surface: they carry a host, an optional schedule and recurrence rule, a capacity, recording, guest invite links, and an inbox entry. Ad-hoc rooms are the lighter primitive for one-off “start a call now” flows.

​
Create and schedule from the API

The response returns the room plus a host token for the creator, so the organizer joins immediately. Leave scheduled_at unset to start now, pass an RFC 5545 recurrence_rule for a repeating series, and omit max_participants to inherit your tenant’s participant ceiling.

​
Join tokens: the browser never sees your API key

Joining a room is a two-step wire. Your back end mints a bounded, per-participant join token:
The token — not the tenant API key — is what the browser carries. Hand it to the prebuilt embed, the guest lobby, or your own client.

​
Embed a room with the web SDK

The Orbit web SDK (@devotel-orbit/web) registers a prebuilt video-room element:
The camera, microphone, screen-share, and device-selection toggles ship with the widget, so an embedded room is a snippet rather than a UI build. For the full embed walkthrough see the embedded video consultation button guide.

​
Recording

Drive recording from the API — /rooms-scheduled/:id/recording/start, /stop, and /pause — or set recording_enabled: true on create so recording starts automatically when the first participant joins. Finished recordings land back on the room.

​
Moderation and broadcast

Hosts moderate from the dashboard or the API: spotlight a speaker, mute or remove a participant, lock the room, run the waiting-room lobby, and clear the deck with mute-all. For larger audiences, stream the room with live broadcast and RTMP egress, or bridge it to the phone network with dial-in for guests and dial-out to bring a PSTN participant in.

​
Room-config templates

Save a room’s configuration as a reusable template under /rooms-scheduled/templates and create later rooms from it with the same behavior as a direct create — the fixed onboarding-call or weekly-sync setup stops being a copy-paste of settings.