Navigation:  Commands > Fax to Send File [FS] > $voice_phone [FS]

Specify Phone Number for Voice Broadcast

$voice_phone phonenum infobox

---

This command identifies the voice phone number to call in a voice outbound (voice broadcast) application (which requires voiceout line operation enabled). This is a required command for this application and must not be used in the same file as $fax_phone. For fax server and broadcast operations, the phone number will be inserted by the client application, perhaps from a broadcast list or phone book.

The parameters on this command are used as follows:

Note that other commands starting $fax_... in the FS file have their usual functions even though no fax transmission is involved.

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.

In PRI-ISDN systems, non-numeric characters (other than those listed above as discarded) in a dial string cause the number to be rejected, since special prefix characters are never valid.

After processing the sequence of infoboxes needed for your voice outbound application, you should normally transfer control using $next_box to one of the three states VOICE_FAIL (S34), VOICE_RETRY (S156) or VOICE_EXIT (S155). If you fail to transfer to one of these states, the call is treated as successful and after hangup the FS file is moved to SENT.

Hardware Issues: The CopiaFacts default for the Dialogic voice boards and Fax/40 board is use call progress analysis on the dialed call. You can use a "$" suffix on the phone number to attempt to send the fax whatever the outcome of placing the call (which marginally faster if the call succeeds, but much slower if the call result is busy or no-answer). These suffix characters can be applied to specific numbers (e.g. to a known combined fax/answer-machine) or by using the convert option of the $phone_mask to add the suffix.

Default: none (required entry for voice outbound)

Example:

$voice_phone "6306828898" 1234

 

---

Topic url: http://www.copia.com/support/refmanual/index.html?%24voice_phone.htm