Specify Fax Phone Number

$fax_phone phonenum

This command identifies the phone number of the fax machine to call. This is a required command (unless you use $voice_phone or $poll_phone instead to specify a voice or poll call).

For a fax-on-demand callback operation, CopiaFacts will create this command from the phone number entered by the caller in response to standard voice prompt 21 or standard voice prompt 36; or looked up as specified in $caller_id; or specified as $owner_fax; or assigned to system variable RCVRFAX during the request.

For fax server and broadcast operations, the phone number will be inserted by the client application, perhaps from a broadcast list or phone book. FFMERGE creates this command from the phone number on the document action line.

The parameter on this command is used as follows:

phonenum fax phone number to call. For convenience when files are generated, the phone number on this command need not be enclosed in double quotes if it contains embedded spaces.

The number may be included on the cover sheet by using the system variable @RCVRFAX in the cover sheet template, or in the fax header line.

Non-numeric codes in dial strings are processed as follows:

If the phone number contains embedded spaces, parentheses, square brackets, hyphens, tilde or slash characters, they are discarded. The processing of '+' is affected by the $country_prefix configuration command. The number is then processed as specified in the $phone_mask command, if any. Any other non-numeric character causes all following characters to be excluded from phone-mask matching (and then replaced). This allows you to specify, for example, a delay and then dialing an extension number (e.g. ",,,34"). It also allows a standard dial command prefix (e.g. "TW") to be used to bypass phone-mask processing altogether.

For Dialogic Diva and Brooktrout TR1034 fax dial operations, the number may be followed by a vertical bar and digits which are output as in-band DTMF between call connection and starting the fax transmission.  The extra digits are ignored for the purposes of phone-mask and do-not-send processing.  Immediately following the vertical bar, you may insert additional vertical bars (or commas) each of which adds a delay of one second between connection and starting to send the DTMF tones.

With digital telephone lines, all non-numeric characters are discarded, since special prefix characters are never valid.

For Dialogic (not Diva) analog lines, the character L in the dialstring waits for a local dial tone, and I waits for an international dial tone.  If a W is used, it is changed to a comma (delay) since Dialogic analog boards do not support this code.  In addition a "$" suffix on the phone number causes call progress analysis to be skipped, so sending a fax will be started whatever the outcome of placing the call  (which is marginally faster if the call succeeds, but much slower if the call result is busy or no-answer).

The suffix and other special characters can be applied to specific numbers or by using the convert option of the $phone_mask.

For BladeWare SIP calls, the SIP: prefix and account suffix are normally applied using the contents of variable CFSIP_SIPIP.  However for direct T.38 calls the phone number may be specified in the form sip:number@domain, and this overrides the domain in CFSIP_SIPIP.  When this is done, the media specifications in  OTF_DIRECT_OFFER_MEDIA and OTF_DIRECT_ANSWER_MEDIA are used in place of those in OTF_SEND_OFFER_MEDIA and OTF_SEND_ANSWER_MEDIA.

Default: none (required entry for fax transmission)

Examples:

$fax_phone "6307788848"

$fax_phone 6307788848|||1234   ; delay two seconds before DTMF

$fax_phone sip:6307788848@copiacolo.net  ; BladeWare direct T.38 call