LogoLogo
  • Go to Docs Center
  • Plum DEV Documentation
  • Overview
  • Developer Reference
    • Tutorial
    • How to...
      • Use Plum's Transcription API
    • Audio Formats and Prompts
    • Grammars and Speech Recognition
    • Available ASR Engines
    • TTS Engine Characteristics
      • Amazon Polly TTS Engine
        • Polly Voice Tag Attribute Details
      • AT&T Natural Voices
      • Cepstral Engine
      • RealSpeak Engine
      • Vocalizer 7
        • Vocalizer 7: <voice> tag and SSML Support
    • Data Exchange
    • Logging
    • Caching
    • Root Documents
  • VoiceXML
    • Tags
      • <assign>
      • <audio>
      • <block>
      • <break>
      • <catch>
      • <choice>
      • <clear>
      • <data>
      • <desc>
      • <disconnect>
      • <else>
      • <elseif>
      • <emphasis>
      • <enumerate>
      • <error>
      • <example>
      • <exit>
      • <field>
      • <filled>
      • <foreach>
      • <form>
      • <goto>
      • <grammar>
      • <help>
      • <if>
      • <initial>
      • <item>
      • <lexicon>
      • <link>
      • <log>
      • <mark>
      • <menu>
      • <meta>
      • <metadata>
      • <noinput>
      • <nomatch>
      • <one-of>
      • <option>
      • <paragraph>
      • <param>
      • <phoneme>
      • <prompt>
      • <property>
      • <prosody>
      • <record>
      • <reprompt>
      • <return>
      • <rule>
      • <ruleref>
      • <say-as>
      • <script>
      • <sentence>
      • <speak>
      • <sub>
      • <subdialog>
      • <submit>
      • <tag>
      • <throw>
      • <token>
      • <transfer>
      • <value>
      • <var>
      • <voice>
      • <vxml>
    • Properties
      • audiofetchhint
      • audiomaxage
      • audiomaxstale
      • bargein
      • bargeintype
      • certverifypeer
      • completetimeout
      • confidencelevel
      • datafetchhint
      • datamaxage
      • datamaxstale
      • documentfetchhint
      • documentmaxage
      • documentmaxstale
      • fetchaudio
      • fetchaudiodelay
      • fetchaudiominimum
      • fetchtimeout
      • grammarfetchhint
      • grammarmaxage
      • grammarmaxstale
      • incompletetimeout
      • inputmodes
      • interdigittimeout
      • logging
      • maxnbest
      • maxspeechtimeout
      • normalizeaudio
      • recordcall
      • recordcallappend
      • recordutterance
      • recordutterancetype
      • scriptfetchhint
      • scriptmaxage
      • scriptmaxstale
      • sensitivity
      • speedvsaccuracy
      • termchar
      • termmaxdigits
      • termtimeout
      • timeout
      • universals
      • voicegender
      • voicename
    • Application and Session Variables
      • application.lastresult$[i].confidence
      • application.lastresult$[i].inputmode
      • application.lastresult$[i].interpretation
      • application.lastresult$[i].recording
      • application.lastresult$[i].recordingduration
      • application.lastresult$[i].recordingsize
      • application.lastresult$[i].utterance
      • session.callrecording
      • session.id
      • session.telephone.ani
      • session.telephone.dnis
    • VoiceXML Resources
  • Plum DEV Guide
    • Using the Plum DEV site
    • Using the File Repository
    • Outbound Calling Guide
      • Using the Outbound Tools in the DEV web UI
      • DEV Outbound Programming Notes
      • Outbound FAQs and Tips
    • Call Reporting
    • Analytics
    • VoiceTrends
    • Debugging
    • Scratchpads
    • Saved URLs
    • Voice Biometrics
    • Call Routing
    • Data Security
      • 'Private' Tags
      • Managing Secure Phone Numbers
      • Sensitive Data Types
    • SMS Guide
      • Standard Short Codes
      • SMS Debugging/Error Logs
      • Additional SMS Info
    • Single Sign On
  • Plum DEV APIs
    • DEV Outbound APIs
      • Contacts CSV Formatting
      • Outbound API Parameter Notes
      • Legacy and Miscellaneous Notes
    • SMS API
    • Call Logs API
    • Call Scheduling and Pacing API
    • Transcription API
    • Application API
    • Blocklist API
Powered by GitBook
On this page
  • <link>
  • Attributes
  • Notes
  • Example
  • Child Tags
  • Parent Tags
  1. VoiceXML
  2. Tags

<link>

<link>

A <link> element may have one or more grammars that are scoped to the element containing the <link>. The <link> element also allows you to implement a grammar within a root document that could be acted upon by your leaf documents.

Attributes

Name
Data type
Description

fetchaudio

String

The URI of the audio clip to play while the fetch is being done. If not specified, the fetchaudio property is used, and if that property is not set, no audio is played during the fetch.

The fetching of the audio clip is governed by the audiofetchhint, audiomaxage, audiomaxstale, and fetchtimeout properties in effect at the time of the fetch.

The playing of the audio clip is governed by the fetchaudiodelay, and fetchaudiominimum properties in effect at the time of the fetch.

fetchhint

This attribute is not supported.

fetchtimeout

String

(defaults to “fetchtimeout” global property value) The timeout for fetches. Must be specified with the appropriate time units (e.g., “120s” for 120 seconds).

maxage

String

(defaults to “documentmaxage” global property value) Tells the platform the maximum acceptable age, in seconds, of cached documents.

maxstale

String

(defaults to “documentmaxstale” global property value) Tells the platform the maximum acceptable staleness, in seconds, of expired cached documents.

next

String

The URI to go to. This URI is a document (perhaps with an anchor to specify the starting dialog) or a dialog in the current document (just a bare anchor).

expr

String

Like next, except that the URI is dynamically determined by evaluating the given ECMAScript expression.

dtmf

String

The DTMF sequence for this link. It is equivalent to a simple DTMF <grammar> and DTMF properties to recognition of the sequence.

event

String

Specify an event to be thrown instead of specifying a next.

eventexpr

String

An ECMAScript expression evaluating to the name of the event to be thrown.

message

String

A message string providing additional context about the event being thrown. The message is available as the value of the variable “_message” within the scope of the catch element.

messageexpr

String

An ECMAScript expression evaluating to the message string.

Notes

Exactly one of “next”, “expr”, “event”, and “eventexpr” must be specified. Exactly one of “message” and “messageexpr” may be specified.

Example

<?xml version="1.0"?>
<vxml version="2.0">
  <link event="pound">
    <grammar type="application/x-jsgf" mode="dtmf">
      "#"
    </grammar>
  </link>
</vxml>
<?xml version="1.0"?>
<vxml version="2.0" application="linkrootdocument.vxml">
<property name="timeout" value="20s" />
<property name="interdigittimeout" value="20s" />
<property name="inputmodes" value="dtmf" />
<property name="bargein" value="true" />       
<property name="termtimeout" value="0.5s" />

  <form>
    <field name="phone">
      <grammar root="ROOT" type="application/srgs+xml" mode="dtmf">
        <rule id="ROOT" scope="public">
          <one-of>
              <item repeat="0-255">
                  <ruleref uri="#digit"/>
              </item>
          </one-of>
        </rule>
        <rule id="digit" scope="public">
          <one-of>
              <item> 0 </item>
              <item> 1 </item>
              <item> 2 </item>
              <item> 3 </item>
              <item> 4 </item>
              <item> 5 </item>
              <item> 6 </item>
              <item> 7 </item>
              <item> 8 </item>
              <item> 9 </item>                     
          </one-of>
        </rule>
      </grammar>
      <prompt>
        Please enter a telephone number.
      </prompt>
      <filled>
        <prompt>                                         
          You entered <value expr="phone"/>.
        </prompt>
      </filled>
    </field>
  </form>

  <catch event="pound">
    <goto next="linkhandlerpage.vxml"/>
  </catch>
</vxml>
<?xml version="1.0"?>
<vxml version="2.0" application="linkrootdocument.vxml">
  <form>
    <block>
      <prompt>
  You have entered the pound key. This is a specific page that handles events for when the user enters the pound key.
      </prompt>
    </block>
  </form>
</vxml>

The output of the above script would be:

Computer: Please enter a telephone number. Human: (enters DTMF-#) Computer: You have entered the pound key. This is a specific page that handles events for when the user enters the pound key.

Child Tags

Parent Tags

Previous<lexicon>Next<log>

Last updated 1 year ago

, , ,

<grammar>
<field>
<form>
<initial>
<vxml>