DocumentationEngagement Platform API
Sign inGet started
Guides
API

Gather DTMF from a call

Use this request to gather DTMF - digits entered by user. Gather command can be nested with a playback or a say.
POST
/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/gather
Gather DTMF from a channel call
Corps de la requête
maxNumKeys
integer
endKey
string
Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, *, #
timeout
integer
retries
integer
input
string
Possible values: dtmf, speech, dtmf speech
speechLocale
string
Possible values: de-DE, en-AU, en-GB, en-US, es-US, it-IT, ja-JP, ko-KR, pt-BR, th-TH, zh-CN
playback
object
Afficher les paramètres enfants
playback.media
array of string
obligatoire
playback.loop
integer
playback.timeout
integer
playback.pauseMilliseconds
integer
say
object
Afficher les paramètres enfants
say.text
string
obligatoire
say.locale
string
Curated set of BCP47 locale identifiers supported by AWS Polly text-to-speech in Bird voice products
Possible values: arb, ar-AE, bg-BG, bn-IN, ca-ES, cs-CZ, cy-GB, cmn-CN, da-DK, de-CH, de-DE, de-AT, el-GR, en-AU, en-GB, en-IN, en-NZ, en-ZA, en-US, en-GB-WLS, es-ES, es-MX, es-US, eu-ES, fi-FI, fil-PH, fr-FR, fr-BE, fr-CA, gl-ES, gu-IN, he-IL, hi-IN, hu-HU, id-ID, is-IS, it-IT, ja-JP, ko-KR, lt-LT, lv-LV, ms-MY, nl-BE, nl-NL, nb-NO, pa-IN, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sk-SK, sr-RS, sv-SE, ta-IN, te-IN, tr-TR, th-TH, uk-UA, vi-VN, yue-CN
say.voice
string
say.loop
integer
say.timeout
integer
Corps de la réponse
id
string
callId
string
callFlowId
string
status
string
command
string
conditions
array of object
Afficher les attributs enfants
conditions.variable
string
Possible values: keys, speech
conditions.operator
string
Possible values: eq, ne, ==, !=, contains
conditions.value
string
Exemple de code
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/gather' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
Exemple de code
curl -X POST "https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/gather" \
     -H "Authorization: AccessKey YOUR_SECRET_TOKEN"