ConfBridge Conference Bridge Example

ConfBridge is Asterisk's modern built-in conference bridge. It is the usual choice for staff conference rooms, support bridges, training calls, and small hosted meeting bridges where you want dialplan control instead of an external conferencing service.

This example builds a complete bridge with regular users, marked admin users, a DTMF menu, entry and exit prompts, and optional recording.

Files used

• confbridge.conf, bridge, user, and menu profiles
• extensions.conf, dialplan entry points
• Optional recording storage under /var/spool/asterisk/monitor

confbridge.conf

[default_bridge]
type=bridge
max_members=25
record_conference=yes
sound_has_joined=conf-hasjoin
sound_has_left=conf-hasleft
sound_only_person=conf-onlyperson
sound_there_are=conf-thereare
sound_other_in_party=conf-otherinparty

[default_user]
type=user
music_on_hold_when_empty=yes
announce_user_count=yes
announce_only_user=no
wait_marked=no
end_marked=no
quiet=no

[admin_user]
type=user
marked=yes
admin=yes
music_on_hold_when_empty=yes
announce_user_count=yes
wait_marked=no
end_marked=yes

[default_menu]
type=menu
*=playback_and_continue(conf-usermenu)
1=toggle_mute
2=decrease_listening_volume
3=increase_listening_volume
4=decrease_talking_volume
5=increase_talking_volume
9=leave_conference

[admin_menu]
type=menu
*=playback_and_continue(conf-adminmenu)
1=toggle_mute
2=decrease_listening_volume
3=increase_listening_volume
4=decrease_talking_volume
5=increase_talking_volume
6=admin_kick_last
8=admin_toggle_conference_lock
9=leave_conference

Dialplan

[conference]
; Regular participant entry
exten => 7000,1,NoOp(ConfBridge room 7000 user)
 same => n,Answer()
 same => n,ConfBridge(7000,default_bridge,default_user,default_menu)
 same => n,Hangup()

; Admin entry with marked user privileges
exten => 7001,1,NoOp(ConfBridge room 7000 admin)
 same => n,Answer()
 same => n,Authenticate(1234)
 same => n,ConfBridge(7000,default_bridge,admin_user,admin_menu)
 same => n,Hangup()

How the profiles fit together

ConfBridge(room,bridge_profile,user_profile,menu_profile) combines three pieces:

• The bridge profile controls the room itself, including maximum members and recording.
• The user profile controls participant behavior, such as whether the user is an admin or marked user.
• The menu profile maps DTMF keys to in-conference actions.

A marked admin is useful when attendees should wait for a host. Set wait_marked=yes for regular users and marked=yes for admins if you want a host-required meeting room.

Recording notes

record_conference=yes records the mixed conference audio. With no record_file in the bridge profile, Asterisk generates a unique filename in its monitor directory. To choose the path yourself, set record_file in the bridge profile or start recording with confbridge record start <conference> <file>. Store recordings on a filesystem with enough space and apply the same retention policy you use for MixMonitor files.

Troubleshooting

• If callers hear silence, confirm that the bridge profile and user profile names match the names in confbridge.conf.
• If DTMF menu keys do nothing, confirm the fourth ConfBridge argument names a menu profile.
• If recordings are missing, check directory permissions for the Asterisk user.
• If users should wait for a host, set wait_marked=yes on the normal user profile and marked=yes on the admin profile.

See Also

• ConfBridge()
• ConfKick()
• CONFBRIDGE()
• app_confbridge
• ConfBridge Profiles, User, Bridge, and Menu