Skip to main content

Start Gather

The StartGather verb is used to get asynchronous notifications of DTMF digits collected in the call while other verbs are executed.

It can, for instance, listen for DTMF digits while a call is in a <Conference>, in a <Transfer>, in a <Bridge>, or while executing other verbs.

It cannot be used with the <Forward> verb.

It is paused during the execution of a <Gather> verb; digits pressed during a <Gather> will not be duplicated as DTMF events.

The StartGather verb can be cancelled by the <StopGather> verb.

Text Content#

There is no text content available to be set for the <StartGather> verb.

Attributes#

AttributeDescription
dtmfUrlURL to send the DTMF event to. May be a relative URL.
dtmfMethod(optional) The HTTP method to use for the request to dtmfUrl. GET or POST. Default value is POST.
username(optional) The username to send in the HTTP request to dtmfUrl.
password(optional) The password to send in the HTTP request to dtmfUrl.
tag(optional) A custom string that will be sent with this and all future callbacks unless overwritten by a future tag attribute or <Tag> verb, or cleared.

May be cleared by setting tag=""

Max length 256 characters.

Webhooks Received#

WebhookCan reply with more BXML
dtmfNo

Examples#

Gather Digits During a Conference#

<?xml version="1.0" encoding="UTF-8"?>
<Response>
<StartGather dtmfUrl="https://startgather.url/callback" />
<Conference>my-conference-name</Conference>
</Response>