Back to Phone_Notify!
Most of these features do not work in our Demo version
This turns off Message Interruption for digit commands (such as 1 for
repeat). This is useful for a message that says Enter your zip code and
doesn't jump around in the Dial Plan when the digits are pressed.
~\ActOnDigitPress(false)~
This will turn off AMD (Answering Machine Detection), Fax, and Ring
Detection. This is useful when you do not wish the message to restart
when these tones are detected.
~\ActOnFeature(false)~
Assigns 1 to go to TestLbl (Note: 1 defaults to repeat msg.) - This can
change anytime in the dialplan
~\AssignDTMF(1|TestLbl)~
A standard Beep tone. Usually used right before a Record command.
~\Beep()~
Provides a clean slate for Acting on DTMF Commands (This will clear the
default of press 1 to repeat).
~\ClearDTMF()~
Provides a way to Conference Multiple Notifies together.
~\Conference()~
NOTE: The first Notify that uses the command will return a ConfKey
variable (You must use StatusChangePostURL to get it). You can then
start other notifies with the same ConfKey to join the person to the
same room. You would need to use ~\SetVar(ConfKey|the confkey guid)~
at the front of the other notifications.
Dials a number in DTMF tones. xxx being the number to dial.
~\DialDTMF(xxx)~
see Phone Notify! Debugging and Error
Reporting
Ends the call immediately.
~\EndCall()~
Returns the digits in the variable specified. Also waits 5 ([optional]
or what you specify) seconds for digits. Then automatically continues to
the next command after '#' is pressed. You can also specify the max
digits to accept([optional] This will turn off the # feature).
Variables will be added to a new GetQueueIDStatus function called
GetQueueIDStatusAdvanced. This is due to security concerns and will
allow you to pull more information about the call. It is good to use
this with the ActOnDigitPress(false) command before the sound file that
you ask for this information.
~\GetDigits(TestVar|5)~
Zipcode Example. This will pause up to six seconds for a 5 digit number.
~\GetDigits(TestVar|6|5)~
Returns the length of a variable into another variable.
~\GetVariableLength(variable|resultvar)~
This will goto a Label defined by the Label command.
~\Goto(lbl)~
This will go to a Label only if the Variable value is equal to the 2nd
value.
~\GotoIf(TestVar|true|TestLbl)~
This will go to a Label only if the Variable value matches the specified
operator.
~\GotoIf(TestVar|>|5|TestLbl)~
This will increase a variable by the amount specified. The number could
also be negative and cause a decrease. If the variable is not a number,
the system will ignore this command and move on.
~\IncreaseVariable(TestVar|1)~ - would increase TestVar by 1.
Sets a label
~\Label(TestLbl)~
Sets ring time for the call. Put this at the top of your script. Please
keep in mind that some phones don't ring for the first few seconds of
ring time. The reason is for call blocking applications for instance.
(Outgoing Calls Only)
~\MaxRingTime(10)~ would cause the system to ring a phone for 10 seconds.
You can reset these labels in order for the system to do something that
you wish during Amd for instance.
This command will read out Alpha-numeric characters in a clear voice
that uses the Phonetic Alphabet. Variables are not currently supported
with this command.
~\PlayAlphaNumeric(xxxx)~
This command will read out money values in a clear voice. Variables are
not currently supported with this command. For a C# example that you
can implement yourself, visit Convert Money to Text in C
Sharp.
~\PlayAmount(xxxx)~
This function is mainly used by CDYNE for global sound files such as
recording sound files.
~\PlaySpecialSoundFile(xxxx)~
* BEA78757-BE32-4670-A8F7-D7E03AAFFB95 - Hello, please record sound file for id...
* AAA31398-AED0-4854-B745-95D174AAFE37 - after the tone record the message and press # to hang up or stop speaking when you are finished.
* C8F07A8C-E130-4E54-BE55-8079B8BB64E5 - Press 1 to accept, Press 2 to rerecord the sound file.
* B8B80319-0308-4E9A-80D8-D3A3D1E3CF51 - Thank you for using the Sound Record Service.
This function is used to insert a pause in any portion of the message,
this is great if you have a requirement to wait for any duration of
time. Value is in seconds. You can use .5 for half of a second. Example
(3.5)
~\PlaySilence(3)~
This allows you to query your own server and return a Variable to use in
the dialplan. Note: Special characters such as ~ ^ ( ) | are not
allowed in the URL Field. Your server has 5 seconds to respond. If your
URL does not respond within 5 seconds the call script will continue if
there is additional scripting in the TextToSay parameter and if there is
no additional scripting, the call will end. This may force the url into
lowercase.
~\QueryExternalServer(url|TestVar)~
NOTE: You may specify variables in the URL by encasing them in brackets
Example
~\QueryExternalServer(http://null.cdyne.com/manage_appt.cgi?action=cancel&queueid=[queueid]|Result)~
This will begin the message as fast as possible. This feature by-passes
'hello' detection. So if this feature is used, some follow it with
~\WaitForSilence(.5)~. THIS MUST BE THE VERY FIRST THING IN A DIAL
PLAN.
~\QuickStart()~
Records the Wave file and saves it as the Sound ID.
~\RecordAndSaveAs(MySoundID)~
Records with a unique soundid and sets the Variable to that SoundID.
~\RecordWithUniqueID(Variable)~
Sets a Variable with the Value Specified. Values could be forced to
lowercase.
~\SetVar(Variable|Value)~
This can be set at anytime in the call.
Set at the beginning of a call and removed at the end of the call (you
can use these in your scripts):
Set only at the end of a call:
Our system pauses with loud background noise. This is to assist in the
answering machine detection of where the beep is. Sometimes talking over
the answering machine will cause the beep to corrupt and therefore
causes our system to miss it. If you would like to turn off the sound
pausing feature of amd detection. Issue the following command.
~\soundpausing(false)~
This posts information about the call to a URL you specify. Using this
method is highly suggested if you have a server to postback to on the
web. The posturl must be in lower case.
PostBackURL
~\StatusChangePostURL(posturl)~
It will Post to you these values:
In Visual Studio.NET, under the Standard Page_Load event you could
simply use the Request object to request these variables.
Sending an NotifyPhoneAdvanced will allow you to set this also. Use
StatusChangePostUrl in the AdvancedNotify Class.
This transfers the call immediately to the number specified.
~\TransferTo(17575551000)~
Converts a Variable to Text To Speech and plays it to a caller. Keep in
mind that this gets sent to the TTS Server Farm for conversion (This is
usually very quick). Please try to limit the size of these otherwise
your caller might enjoy too much dead-air.
~\VariableToTTS(Variable)~
This function waits x seconds for a DTMF Command - this differs from
getdigits in that it accepts only one digit. Make sure that
ActOnDigitPress(true) is set (It is true by default).
~\WaitForDTMF(5)~
Waits for silence that lasts xxx number of seconds. (Up to a 10 second
wait.)
~\WaitForSilence(xxx)~