DokumentacjaEngagement 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
Treść żądania
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
Pokaż parametry podrzędne
playback.media
array of string
wymagane
playback.loop
integer
playback.timeout
integer
playback.pauseMilliseconds
integer
say
object
Pokaż parametry podrzędne
say.text
string
wymagane
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
Treść odpowiedzi
id
string
callId
string
callFlowId
string
status
string
command
string
conditions
array of object
Pokaż atrybuty podrzędne
conditions.variable
string
Possible values: keys, speech
conditions.operator
string
Possible values: eq, ne, ==, !=, contains
conditions.value
string
Przykład kodu
curl -X POST 'https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/gather' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
Przykład kodu
curl -X POST "https://api.bird.com/workspaces/{workspaceId}/channels/{channelId}/calls/{callId}/gather" \
     -H "Authorization: AccessKey YOUR_SECRET_TOKEN"