Bridge(channel[,options])
Full arguments reference
channelrequired - The current channel is bridged to the channel identified by the channel name, channel name prefix, or channel uniqueid.-
optionsp- Play a courtesy tone to channel.-
F- When the bridger hangs up, transfer the bridged party to the specified destination and start execution at that location.Note
Any channel variables you want the called channel to inherit from the caller channel must be prefixed with one or two underbars ('_').
Note
This option will override the 'x' option
contextextenpriorityrequiredF- When the bridger hangs up, transfer the bridged party to the next priority of the current extension and start execution at that location.
Note
Any channel variables you want the called channel to inherit from the caller channel must be prefixed with one or two underbars ('_').
Note
Using this option from a or Gosub() might not make sense as there would be no return points.
Note
This option will override the 'x' option
-
h- Allow the called party to hang up by sending the *** DTMF digit. H- Allow the calling party to hang up by pressing the *** DTMF digit.k- Allow the called party to enable parking of the call by sending the DTMF sequence defined for call parking infeatures.conf.K- Allow the calling party to enable parking of the call by sending the DTMF sequence defined for call parking infeatures.conf.L(x[:y][:z])- Limit the call to x ms. Play a warning when y ms are left. Repeat the warning every z ms. The following special variables can be used with this option:-
n- Do not answer the channel automatically before bridging. Additionally, to prevent a bridged channel (the target of the Bridge application) from answering, theBRIDGE_NOANSWERvariable can be set to inhibit answering.Warning
Do not set the
BRIDGE_NOANSWERvariable globally, as it will break normal bridging behavior in many cases. Only use this variable on a per-channel basis when you really know what you are doing! -
S(x)- Hang up the call after x seconds after the called party has answered the call. t- Allow the called party to transfer the calling party by sending the DTMF sequence defined infeatures.conf.T- Allow the calling party to transfer the called party by sending the DTMF sequence defined infeatures.conf.w- Allow the called party to enable recording of the call by sending the DTMF sequence defined for one-touch recording infeatures.conf.W- Allow the calling party to enable recording of the call by sending the DTMF sequence defined for one-touch recording infeatures.conf.x- Cause the called party to be hung up after the bridge, instead of being restarted in the dialplan.
Allows the ability to bridge two channels via the dialplan.
This application sets the following channel variable upon completion:
- BRIDGERESULT - The result of the bridge attempt as a text string.
SUCCESSFAILURELOOPNONEXISTENT
channelrequired - The current channel is bridged to the channel identified by the channel name, channel name prefix, or channel uniqueid.-
optionsp- Play a courtesy tone to channel.-
F- When the bridger hangs up, transfer the bridged party to the specified destination and start execution at that location.Note
Any channel variables you want the called channel to inherit from the caller channel must be prefixed with one or two underbars ('_').
Note
This option will override the 'x' option
contextextenpriorityrequiredF- When the bridger hangs up, transfer the bridged party to the next priority of the current extension and start execution at that location.
Note
Any channel variables you want the called channel to inherit from the caller channel must be prefixed with one or two underbars ('_').
Note
Using this option from a or Gosub() might not make sense as there would be no return points.
Note
This option will override the 'x' option
-
h- Allow the called party to hang up by sending the *** DTMF digit. H- Allow the calling party to hang up by pressing the *** DTMF digit.k- Allow the called party to enable parking of the call by sending the DTMF sequence defined for call parking infeatures.conf.K- Allow the calling party to enable parking of the call by sending the DTMF sequence defined for call parking infeatures.conf.L(x[:y][:z])- Limit the call to x ms. Play a warning when y ms are left. Repeat the warning every z ms. The following special variables can be used with this option:-
n- Do not answer the channel automatically before bridging. Additionally, to prevent a bridged channel (the target of the Bridge application) from answering, theBRIDGE_NOANSWERvariable can be set to inhibit answering.Warning
Do not set the
BRIDGE_NOANSWERvariable globally, as it will break normal bridging behavior in many cases. Only use this variable on a per-channel basis when you really know what you are doing! -
S(x)- Hang up the call after x seconds after the called party has answered the call. t- Allow the called party to transfer the calling party by sending the DTMF sequence defined infeatures.conf.T- Allow the calling party to transfer the called party by sending the DTMF sequence defined infeatures.conf.w- Allow the called party to enable recording of the call by sending the DTMF sequence defined for one-touch recording infeatures.conf.W- Allow the calling party to enable recording of the call by sending the DTMF sequence defined for one-touch recording infeatures.conf.x- Cause the called party to be hung up after the bridge, instead of being restarted in the dialplan.
User Notes
Know a tip or gotcha for this topic? Share it below and help others.
Contribute a note
Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.