Skip to main content

index


type: page title: Gather

Gather

The <Gather> verb collects DTMF tones during a call. <Say> can be nested within <Gather> to create an interactive IVR with text-to-speech.

Attributes

ATTRIBUTEDESCRIPTIONOPTIONSDEFAULT
action URL where TeXML will send the gathered result and message history. Same method (GET/POST) as set for the TexML application is used. Transfers control of the current call to the TeXML file returned. -
timeout Time in seconds between digits before the <Gather> digits are sent to your action URL. Telnyx will wait until all nested verbs have been executed before beginning the timeout period. 1 - 1205
input The input type for the gather action. dtmf, speech, dtmf speechdtmf
speechTimeout Time in seconds to wait after speech ends before timing out. -
partialResultCallback URL for sending partial gather results. -
partialResultCallbackMethod HTTP request type used for partialResultCallback. GET, POSTPOST
profanityFilter Whether to filter profanity from speech recognition results (camelCase format). -
useEnhanced Enables enhanced transcription, this works for models phone_call and video (camelCase format). -
hints Hints to improve transcription accuracy. -
transcriptionEngine Engine to use for speech recognition: google, telnyx google, telnyx-
finishOnKey The set of digits, (0-9, *, #), that indicates the end of the gather. #
numDigits The number of digits to be gathered. -
language The language used. See RESTful API documentation for supported values. By default en-US. en-US
validDigits The set of valid digits for the gather action. -
invalidDigitsAction URL where TeXML will send the invalid gathered digits. The same method (GET/POST) as set for the TeXML application is used. Transfers control of the current call to the TeXML file returned. -
minDigits Minimum number of digits to be gathered. 1 - 1281
maxDigits Maximum number of digits to be gathered. 1 - 128128

Child verbs/nouns

NOUN/VERBDESCRIPTION
Say
Play

Examples

<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Gather timeout="5" numDigits="1" finishOnKey="#">
<Say>Press 1 for sales, press 2 for support.</Say>
</Gather>
</Response>

Expected callbacks

If action is set, the following callback can be expected with the gathered digits

{
"AccountSid":"cb6cfbbc-eb00-41af-a3f3-0d7b32009e4b",
"CallSid":"v2:DPNqxVjTNtQYaKdcKbU0QgRFrQ3YzuAQrVYC4Ggcuq7zTpDkUB7A4w",
"CallSidLegacy":"v2:DPNqxVjTNtQYaKdcKbU0QgRFrQ3YzuAQrVYC4Ggcuq7zTpDkUB7A4w",
"Digits":"1",
"From":"Defaultj35z6@sip.telnyx.com",
"To":"+12132045020"
}

Action callback attributes

ATTRIBUTEDESCRIPTION
AccountSidA unique identifier for the account generating this call.
CallSidA unique identifier for this call, generated by Telnyx.
CallSidLegacyA unique identifier for the call sent for keeping backward compatibility.
FromThe outbound caller number.
ToThe inbound callee number.
DigitsThe digits entered in the gather process by the callee.