Specify Dial Command for Call Transfer
$dial_cmd "dialstring"|MULTIPLE [transtype [channelgroup [channelrange]]]
This command is used in an infobox of $type transfer to specify the number to be dialed and the type of transfer.
This command is used both for a normal 'call transfer' (where the transferred call is then released by CopiaFacts) and for a call connection, where a second CopiaFacts line is used to place a call which is then connected to the first.
The parameters on this command are used as follows:
| dialstring | The dial codes and phone or extension number to be dialed. The special characters for Brooktrout boards are "!" to hook flash, "," to delay one second, and ";" to delay five seconds. This option has to be used on a line that can get a dial tone via a hook flash. This is normally done via a PBX, Centrex, or special DID interface that also has a dial tone line attached to it. For Diva call transfers the hook flash character need not be included in the string as the board takes care of the mechanics of the transfer appropriately for the line type. For Diva and Brooktrout boards, in-band dialing and delays can be added after a vertical bar character (|) as described for $fax_phone. |
| transtype | One of the following keywords: |
| callp, cp2 | transfer the call (or place the second call) with call progress (when supported by the voice hardware). On PRI circuits this setting causes analysis to be done on in-band tones (using the voice channel) after the call placement is complete. This is the default unless the infobox is $type call_ext. |
| cp1 | transfer the call (or place the second call) and wait on PRI circuits until call placement is signaled as complete, then return without doing any analysis of in-band tones. |
| nocallp, cp0 | transfer the call (or place the second call) without waiting to determine the result. This is the default when the infobox is $type call_ext. |
| channelgroup | This parameter specifies the channel or channel group to be used to place a separate outbound call. If the outbound call is successful, the inbound line will be connected to the outbound line using the Dialogic Diva line interconnect feature. Both calls are then terminated when either is hung up. If this parameter is not given, the incoming line is assumed to be from a PBX or other system which can accept a hook flash or other signal to transfer the call. |
| If a channel group name of the form 'RRn...' is used, where n is a digit from 1 to 8, then the channel is selected from the channel group on a 'round-robin' basis. Up to 8 different groups can be specified in this way. The default is to allocate the lowest numbered available line in the group. This feature does not apply to PRI-ISDN lines where the outbound telephony channel is selected using the channelrange parameter and the sequence of use of the voice channels is not relevant. |
On voice boards which support call progress analysis, control will be passed to the infobox specified by $error_exit if the call progress is specified and the call transfer fails due to busy, no answer or other error conditions. Since the caller will hear the call tones (e.g. ring, busy, etc.) you should make sure that your prompt advises staying on the line if you intend to take back control of the call after failure to connect. The system variable CATERM is set with a numeric error outcome code giving the reason for the failure. In addition the following special codes may be returned:
| 101 | Cannot connect lines, already connecting or connected |
| 102 | No suitable line available in specified group, for outbound call |
The call is normally hung up after a call transfer on a single line. However by specifying $error_exit in the same infobox you skip the hangup for a failed call-progress call. And specifying a $next_box value in the same infobox you can avoid hanging up the line after a successful call-progress operation, and after a non-call-progress operation. This feature allows you to send a command to a local PBX, signaled by a hook-flash, and continue to process the original call.
This feature is available for Copia VoIP ports. Note that the transtype parameter must be set to CP2 and the channelgroup parameter must specify a channel defined using the same $voip command as the channel that is originating the call. In addition the DTMF parameter on the $allow_interrupt command (to filter which DTMF keys are to break the connection) is not yet supported.
Hardware Issues: Only Diva lines using Line Interconnect, or Copia VoIP ports (see limitations above) can be used to place a separate outbound call. The second line must be in the same node and of the same type as the inbound call.
Default: none (required in infobox of above types)
Examples:
;operator.iif
$type transfer
$script "Your call is being transferred"
$image_desc standard ; use operator.vox
$dial_cmd "&,0" callp
$error_exit noxfer ; go to noxfer.iif on error
;0001212.iif
$type transfer
$image_desc @FFBASE\image\operator.vox
$dial_cmd "&,9,5551212" ; dial outside number
