Conference Rooms

Conference rooms provide multi-party audio bridges for meetings.

Purpose

Use this module to:

• Create conference bridges
• Configure PIN and host PIN protection
• Enable recording and host controls
• Set participant limits and entry behavior

Features

Feature	Description
PIN Protection	Optional numeric PIN required to join
Host PIN	Special PIN for host controls
Recording	Record conference sessions
Auto-Start Recording	Start recording automatically when the conference begins
Wait for Host	Keep participants on hold until the host joins
Mute on Entry	Automatically mute new participants
Announce Join/Leave	Play sounds when participants join or leave
Talk Detection	Emit webhooks when participants speak
Max Participants	Limit the number of simultaneous participants (2-1000)

Permissions

Action	Owner	PBX Admin	PBX User	Reporter
View conference rooms	Yes	Yes	Yes	Yes
Create conference rooms	Yes	Yes	No	No
Update conference rooms	Yes	Yes	No	No
Delete conference rooms	Yes	Yes	No	No

UI Workflow

Create a Conference Room

1. Navigate to Conference Rooms in the sidebar
2. Click Create Conference Room
3. Enter a name and optional description
4. Set the maximum number of participants
5. Enable PIN protection and enter PINs if required
6. Configure recording and host behavior
7. Save

The room can then be assigned to an extension or used as a DID routing destination.

Key Data Fields

conference_rooms Table

Column	Type	Notes
id	bigint	Primary key
organization_id	FK	Tenant scope
name	string	Unique per org
description	string nullable
max_participants	integer	2-1000
status	enum	active, inactive (uses UserStatus)
pin	string nullable	Numeric, max 20
pin_required	boolean
host_pin	string nullable
recording_enabled	boolean
recording_auto_start	boolean
recording_webhook_url	URL nullable
wait_for_host	boolean
mute_on_entry	boolean
announce_join_leave	boolean
music_on_hold	boolean
talk_detection_enabled	boolean
talk_detection_webhook_url	URL nullable	Required when talk detection is enabled

Related API Endpoints

Method	Endpoint	Purpose
GET/POST/PUT/DELETE	/v1/conference-rooms[/{conferenceRoom}]	Standard CRUD

See the OPBX REST API reference for full schemas.

Related Modules

• Extensions — CONFERENCE type extensions link to rooms
• Phone Numbers — DIDs can route to conference rooms
• IVR Menus — IVR options can route to conference rooms