Bridge a new channel to the existing one.Generally used to route an incoming call to one or more endpoints. Multiple endpoints can be dialed simultaneously or sequentially.

{
    "bridge": {
        "strategy": "multiple",
		"pickup": "mygroup",
        "parameters": ["a=1", "instant_ringback=true"],
        "endpoints": [{
            "name": "gw_name1",
            "type": "sipGateway",
            "dialString": "&reg0.$1",
            "parameters": ["absolute_codec_string='PCMA,G729'"]
          },
          {
            "name": "1000",
            "type": "device"
          },
          {
            "name": "1001",
            "type": "user",
            "domainName": "10.10.10.144",
            "parameters": ["d=3"]
          }]
	}
}
ValueDescription
strategy
  • multiple - no limit to concurrency, first one to answer wins.
  • failover -  no limit to failover number.
pickup
pickup group name. The pickup endpoint is a dummy channel that never answers to which you can originate from anywhere you can place calls.
parameters

Set variables to all endpoints. Some useful variables:

  • instant_ringback=true - ringback will not wait for indication before sending ringback tone to calling party.

  • ignore_early_media=true - Ignore early media from the endpoint.
  • ignore_early_media=ring_ready - The same as ignore_early_media=true but also send a SIP 180 to the inbound leg when the first SIP 183 is caught.
  • call_timeout=20 - Controls how long (in seconds) to ring the endpoint. Default is 60 seconds.
  • leg_timeout=15 - Can be used inside endpoints parameters only.
  • leg_delay_start=15 - Specifies a wait time in seconds before the leg is called. Can be used inside endpoints parameters only.
  • origination_caller_id_number - Sets the origination CallerID number.
  • absolute_codec_string - Sets the absolute codec string to use (nothing will be appended).
  • sip_renegotiate_codec_on_reinvite=true - Allow SDP codec change with re-INVITE.

Endpoints

sipGateway

ValueDescription
name

SIP gateway name.

dialString

Dialed number to this endpoint. &reg0.$1 = destination number

parameters
Set variables to this endpoint.

user

ValueDescription
name

User name.

domainName
User domain name.
parameters
Set variables to this endpoint.

device

ValueDescription
name

Device name in current domain.

parameters
Set variables to this endpoint.