Dial Options

Dial options are an advanced feature that permits complex control of the call behavior.  Generally, a dial option field can be left blank, and are only needed in very complex situations.

• t - Allows the called user to transfer the call by hitting #
• T - Allows the calling user to transfer the call by hitting #
• r - Generates a ring tone for the calling party, passing no audio from the called channel(s) until one answers. This is generally not required, as the system will detect when to generate tones automatically in almost all caes.
• R - Indicates ringing to the calling party when the called party indicates ringing, pass no audio until answered.
• m - Provides Music on Hold to the calling party until the call is answered. This is mutually exclusive with option 'r'. Use m(class) to specify a class for the Music on Hold.
• o - Send the original caller's ID
• M (x) - Executes the macro (x) upon call connection (i.e. when the called party answers)
• h - Allows the called party to hang up by dialing *
• H - Allows the caller to hang up by dialing *
• g - When the called party hangs up, exit to execute more commands in the current context.
• G (context^exten^pri) - If the call is answered, this transfers both parties to the specified priority. The calling party is transferred to priority x and the called party to priority x+1
• A (x) - Play an announcement (x.gsm) to the called party.
• S (n) - Hang up the call n seconds AFTER the called party picks up.
• d: - This flag trumps the 'H' flag and intercepts any DTMF while waiting for the call to be answered and returns that value on the spot. This allows you to dial a 1-digit exit extension while waiting for the call to be answered.
• D (digits) - After the called party answers, send digits as a DTMF stream, then connect the call to the originating channel.
• L (x[:y][:z]) - Limit the call to 'x' minutes, warning when 'y' minutes are left, repeated every 'z' minutes). Only 'x' is required, 'y' and 'z' are optional. The following special variables are optional for limited calls:
  • + LIMIT_PLAYAUDIO_CALLER - yes|no (default yes) - Plays sounds to the caller.
  • + LIMIT_PLAYAUDIO_CALLEE - yes|no - Plays sounds to the called party.
  • + LIMIT_TIMEOUT_FILE - File to play when time is up.
  • + LIMIT_CONNECT_FILE - File to play when the call begins.
  • + LIMIT_WARNING_FILE - File to play as a warning if 'y' is defined. If LIMIT_WARNING_FILE is not defined, then the default behavior is to announce ('You have [XX minutes] YY seconds').
• f - forces CallerID to be set for the extension of the line making/redirecting the outgoing call.
• NOTE: Dial options can bind together. (E.g. t + r = tr)