Dial()

This application will place calls to one or more specified channels. As soon as one of the requested channels answers, the originating channel will be answered, if it has not already been answered. These two channels will then be active in a bridged call. All other channels that were requested will then be hung up.

Unless there is a timeout specified, the Dial application will wait indefinitely until one of the called channels answers, the user hangs up, or if all of the called channels are busy or unavailable. Dialplan execution will continue if no requested channels can be called, or if the timeout expires. This application will report normal termination if the originating channel hangs up, or if the call is bridged and either of the parties in the bridge ends the call.

If the OUTBOUND_GROUP variable is set, all peer channels created by this application will be put into that group (as in Set(GROUP()=...). If the OUTBOUND_GROUP_ONCE variable is set, all peer channels created by this application will be put into that group (as in Set(GROUP()=...). Unlike OUTBOUND_GROUP, however, the variable will be unset after use.

same => n,Dial(PJSIP/alice,30)

same => n,Dial(PJSIP/alice&PJIP/bob,45)

same => n,Dial(PJSIP/alice,,g)
same => n,Log(NOTICE, Alice call result: ${DIALSTATUS})

same => n,Dial(PJSIP/alice,,TX)

same => n,Dial(PJSIP/alice,,L(60000:30000:10000))

same => n,Dial(PJSIP/alice&PJSIP/bob,,Q(NO_ANSWER))

[default]
exten => callee_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})
 same => n,Log(NOTICE, I'm called on channel ${CHANNEL} prior to it starting the dial attempt)
 same => n,Return()
exten => called_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})
 same => n,Log(NOTICE, I'm called on outbound channel ${CHANNEL} prior to it being used to dial someone)
 same => n,Return()
exten => _X.,1,NoOp()
 same => n,Dial(PJSIP/alice,,b(default^called_channel^1(my_gosub_arg1^my_gosub_arg2))B(default^callee_channel^1(my_gosub_arg1^my_gosub_arg2)))
 same => n,Hangup()

[my_gosub_routine]
exten => s,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})
 same => n,Playback(hello)
 same => n,Return()
[default]
exten => _X.,1,NoOp()
 same => n,Dial(PJSIP/alice,,U(my_gosub_routine^my_gosub_arg1^my_gosub_arg2))
 same => n,Hangup()

same => n,Dial(PJSIP/alice,,G(jump_to_here))
same => n(jump_to_here),Goto(confbridge)
same => n,Goto(confbridge)
same => n(confbridge),ConfBridge(${EXTEN})

This application sets the following channel variables:

• DIALEDTIME - This is the time from dialing a channel until when it is disconnected.
• DIALEDTIME_MS - This is the milliseconds version of the DIALEDTIME variable.
• ANSWEREDTIME - This is the amount of time for actual call.
• ANSWEREDTIME_MS - This is the milliseconds version of the ANSWEREDTIME variable.
• RINGTIME - This is the time from creating the channel to the first RINGING event received. Empty if there was no ring.
• RINGTIME_MS - This is the milliseconds version of the RINGTIME variable.
• PROGRESSTIME - This is the time from creating the channel to the first PROGRESS event received. Empty if there was no such event.
• PROGRESSTIME_MS - This is the milliseconds version of the PROGRESSTIME variable.
• DIALEDPEERNAME - The name of the outbound channel that answered the call.
• DIALEDPEERNUMBER - The number that was dialed for the answered outbound channel.
• FORWARDERNAME - If a call forward occurred, the name of the forwarded channel.
• DIALSTATUS - This is the status of the call
  • CHANUNAVAIL - Either the dialed peer exists but is not currently reachable, e.g. endpoint is not registered, or an attempt was made to call a nonexistent location, e.g. nonexistent DNS hostname.
  • CONGESTION - Channel or switching congestion occurred when routing the call. This can occur if there is a slow or no response from the remote end.
  • NOANSWER - Called party did not answer.
  • BUSY - The called party was busy or indicated a busy status. Note that some SIP devices will respond with 486 Busy if their Do Not Disturb modes are active. In this case, you can use DEVICE_STATUS to check if the endpoint is actually in use, if needed.
  • ANSWER - The call was answered. Any other result implicitly indicates the call was not answered.
  • CANCEL - Dial was cancelled before call was answered or reached some other terminating event.
  • DONTCALL - For the Privacy and Screening Modes. Will be set if the called party chooses to send the calling party to the 'Go Away' script.
  • TORTURE - For the Privacy and Screening Modes. Will be set if the called party chooses to send the calling party to the 'torture' script.
  • INVALIDARGS - Dial failed due to invalid syntax.