Cloud Fax and Notifications API 2.6 Documentation
VoiceScriptCreate
Cloud Fax and Notifications API Forums Home  
    prev  next        Table of Contents  VoiceScriptCreate  

61.2 VoiceScriptCreateRequest

VoiceScriptCreate Overview   VoiceScriptCreateResult

Tag Name
& type
#Description
VoiceScriptCreateRequest   Namespace of this element is http://ws.easylink.com/VoiceScriptCreate/2017/09
   SubmitId
xs:string
0-1Optional string identifying request, which will be echoed in result.
   ObjectStore
xs:string
1The store in which the voice script is to be created. This can be a specific EasyLink "domain" name, but using the generic system type "XDDS" or "MR" allows the Cloud Fax and Notifications API to choose the most appropriate available switch.
   ReplaceExisting
xs:boolean
1This boolean value indicates whether or not an existing voice script will be overwritten. If "false", then the operation will fail if the voice script already exists. If "true", then a new voice script will be created, possibly overwriting an existing one.
   VoiceScriptId
StoredObjectIdType
1Voice Script identifier. See Stored Objects.
   TransactionInfo
TransactionInfoType
1This element is used to provide the transactions of the voice script.
   IDWav
DocumentInfoType
0-1This optional element specifies the WAV file to be used to identify the voice script when selecting a script to deliver. See DocumentInfoType. A Text-to-Speech template cannot be used for the script identification file.
   Transaction1-Each Transaction contains one transaction record of the script. There are 5 types of transactions possible: Informational, MultipleChoice, AutoTransfer, NumericInput and ExactMatch.
   @transactionID
xs:unsignedInt
0-1This attribute specifies the transaction ID. This ID may be used to refer to this transaction in other places in the request, for example in a Branching element.
   TransactionName
xs:string
1This gives the transaction name. This name may be used to refer to this transaction in other places in the request, for example in a Branching element.
   Informational
InformationalInfoType
1This is an informational type of transaction with no inputs from the user.
   PromptAttachment
DocumentInfoType
0-1This is the WAV file or Text-to-Speech template to be played when the transaction is delivered to a recipient. See DocumentInfoType.
   Branching
BranchingInfoType
0-1This allows a user to specify the transaction flow from this transaction. See BranchingInfoType. The default is to proceed to the next transaction. There can be no conditional user input for this transaction.
MultipleChoice
MultipleChoiceInfoType
1This type of transaction permits multiple choice inputs from the user.
   ResponseRange1This determines what user input is valid for the transaction.
   NumChoices1This is the number of choices allowed for user input. The maximum allowed is 10 (1 - 9 plus the 0 key).
   ExitChoice
DTMFKey
0-1This optional element is the input that, if entered by the recipient during script delivery, will terminate script delivery. The available choices are based on the NumChoices option selected (e.g. if you select 4 as the number of choices, then only the keys 5 - 9, 0 and '*' are available).
   PromptAttachment
DocumentInfoType
0-1This is the WAV file or Text-to-Speech template to be played when the transaction is delivered to a recipient. See DocumentInfoType.
   ResponseAttachment
DocumentInfoType
0-1This is the response WAV or Text-to-Speech template to be played when this transaction is presented to the recipient. The response file is played immediately after the PromptAttachment WAV or Text-to-Speech template is played. See DocumentInfoType.
   Branching
BranchingInfoType
0-This allows a user to specify the transaction flow from this transaction. See BranchingInfoType. The default is to proceed to the next transaction.
AutoTransfer
AutoTransferInfoType
1This is an auto-transfer transaction. AutoTransfer can be set-up with an audio prompt to be played to the broadcast recipient while the call transfer is taking place. This can be either a WAV file or a TTS template. This prompt will be played in a loop until the transfer call attempt completes. The default is to play silence. The pause between the prompt playback is measured in seconds with a default of five seconds.
   ResponseRange1This determines what user input is valid for the transaction.
   TransferKey
DTMFKey
1Determines the transfer number, stored in the user profile, to be used for a live answer call.
   PlayBackLoopDelay
xs:unsignedInt
1The duration in seconds of the pause before the prompt is repeated.
   PromptAttachment
DocumentInfoType
0-1This is the WAV file or Text-to-Speech template to be played when the transaction is delivered to a recipient. See DocumentInfoType.
NumericInput
NumericInputInfoType
1This type of transaction permits numeric inputs from the user.
   ResponseRange1This determines what user input is valid for the transaction.
NOTE: User input for transactions of this type is terminated when either the maximum range of input digits is reached or the '#' key is pressed. If you wish to allow the user to always terminate the input by using the '#' key, it is suggested that you increase the maximum range by one digit (Example: setting the minimum/maximum input digit range to 1-3 would cause input termination after 999 is received. Increasing the maximum input digits allowed to 4 would then allow the input 999# to be received). Note that user input may also time out. This timeout will occur if 15 seconds passes before the first input is received. After the first input to this transaction is received, 6 seconds is allowed between subsequent key presses before a timeout occurs. When a timeout occurs, if the number of digits input is less than the minimum specified, then the transaction will replay. If the number of digits input is greater than or equal to the minimum digits specified, then the input will be treated as valid input.
   MinInputDigit
xs:unsignedInt
1This is the minimum number of digits accepted as the response to this transaction.
   MaxInputDigit
xs:unsignedInt
1This is the maximum number of digits accepted as the response to this transaction. (Example: if the minimum and maximum digit values are both 2, valid user input would range between 00-99). The maximum number must be greater than or equal to the minimum number. The maximum number cannot be larger than 127.
   PromptAttachment
DocumentInfoType
0-1This is the WAV file or Text-to-Speech template to be played when the transaction is delivered to a recipient. See DocumentInfoType.
   Branching
BranchingInfoType
0-3This allows a user to specify the transaction flow from this transaction. See BranchingInfoType. The default is to proceed to the next transaction. This allows the next transaction to be selected based on an arithmetic comparison of the user input to a specific numeric value in the branch condition.
ExactMatch
ExactMatchInfoType
1This transaction permits testing an exact match of the condition.
   ResponseRange1This determines what user input is valid for the transaction.
   InsertId
xs:unsignedInt
1This is the ID of the destination list insert whose value is to be used when performing input matching for this transaction. The InsertId must be any number from 1 to 999.
   NumOfAttempts
xs:unsignedInt
1This value determines the maximum number of attempts the call recipient will be given to enter a correct response (a response that matches the value for the provided insert) after the initial incorrect response. This value must be in the range from 0 to 20.
Note that this includes the initial attempt as well as retry attempts, so this may be one greater than values (as on the voiceREACH website) that only show the number of retries.
   PromptAttachment
DocumentInfoType
0-1This is the WAV file or Text-to-Speech template to be played when the transaction is delivered to a recipient. See DocumentInfoType.
   ResponseAttachment
DocumentInfoType
0-1This is the response WAV or Text-to-Speech template to be played when this transaction is presented to the recipient. The response file is played when the entered response does not match the insert value. See DocumentInfoType.
   Branching
BranchingInfoType
0-2This allows a user to specify the transaction flow from this transaction when the input collected from the call recipient matches or does not match the exact match insert id value for the recipient. See BranchingInfoType. The conditions to be used in this element should be either equals or notequals only. The default is to proceed to the next transaction.
   Attachment
DocumentType
0-This contains the actual WAV files to be played, in Document format. See DocumentType. The DocType must be WAV.
Supplied WAV files will be converted to the standard format used by voice scripts (8 khz sampling rate, 8 bit sample size, mu-law format, mono) before the script is created.
   VoiceScriptCreateExtensions0-1This element is used to provide the extensions that can be passed to the voice script.
   Segment
SegmentType
1-Extensions may be divided into categories and the segment will indicate the category. See SegmentType.
   @name
xs:string
0-1The name of the segment for this property. The special name value "/Processing" is used to specify processing directives.
   Property1-This element will contain the specific extension value.
   @name
xs:string
1The name of the keyword.
The following extension can be used to specify a processing feature:
SegmentPropertyDescription
/ProcessingCreateForm When the value is false ,VoiceScriptCreate will not alter the existing form, if the new form fields match the existing form fields. On mismatch of fields , error is thrown. Default value is true and the VoiceScriptCreate will create a new form. Any other value is ignored and default behavior is considered.
   @b64charset
xs:string
0-1The value may be base64 encoded to convey data in a particular character set. See EncodableStringType.
 
    prev  next        Table of Contents  VoiceScriptCreate  
© Copyright 2020 OpenText Corp. All Rights Reserved.
Privacy Policy | Cookie Policy
This information is subject to change. Please check frequently for updates.
Modified October 06, 2020