speech to text

action

string

• 'voice_helper' - установить правило голосовой навигации,  основные параметры для работы этого действия:  sound, voice_helper_digits_max,  voice_helper_rules,  voice_helper_timeout, voice_helper_classic_term, voice_helper_final_count

sound

integer

Идентификатор звукового файла, который необходимо проиграть.

Идентификатор можно получить с помощью ресурса:

GET /client/{client_id}/sound/

Во время проигрывания файла начинается распознавание речи звонящего, распознавание заканчивается по нажатию кнопки-терминатора #, набору количества цифр донабора (voice_helper_digits_max), либо по таймауту (voice_helper_timeout)

voice_helper_digits_max

integer

Количество цифр донабора, после которого заканчивается распознавание речи. Если на момент до набора нужного количества digits финальный результат распознавания недоступен- мы будем работать с предположениями.

voice_helper_rules

string

Список правил переадресации в виде массива
{ “to_option” : номер_опции, “transcription”: “распознанное слово” }

Опция данного контекста должна быть создана, иначе она пропускается во время звонка, при создании правила опция не проверяется.

Создается опция правилом POST /extension/{extension_id}/ivr/context/{context_id}/options/

Транскрипция может быть вида "привет|здравствуйте” (слова перечислены символом | пробелы вырезаются\должны отсутствовать. Регистр символов значения не имеет).

voice_helper_timeout 

integer

Время в миллисекундах по истечении которого заканчивается распознавание речи - если за это время финальный результат недоступен- мы будем работать с предположениями.

Минимум 3000

voice_helper_classic_term

boolean

Разрешить, либо запретить классический донабор с клавиатуры (по умолчанию запрещено и используется только как прерывание распознавания см. voice_helper_digits_max)

Полностью аналогичная логика донабору правила ivr Play sound. Но перед переходом в опцию или на добавочный проверяются voice_helper_rules и если там есть совпадения- переход будет по ним, а не по донабору (приоритет у сказанного, а не набранного, хоть набранное и завершает “прослушку” сказанного)

voice_helper_final_count

integer

Финальное распознавание определяется паузой в речи (до финального распознавания возможны только предположения)

voice_helper_final_count Это количество попыток сообщить голосом то, что имеется в voice_helper_rules

Обычно устанавливается от одной до трех попыток final_count

POST extension/204/ivr/context/1/options/start/rules/

или

PUT extension/204/ivr/context/1/options/start/rules/1

{
"voice_helper_digits_max": 2,
"voice_helper_rules": [
{
"to_option": 1,
"transcription": "привет|здравствуй|здарова"
},
{
"to_option": 2,
"transcription": "прощай|пока"
},
],
"sound": 52,
"voice_helper_timeout": 7000
}

{ …

"voice_helper_sound": 52,

"voice_helper_timeout": 7000,

"id": 39,

"voice_helper_digits_max": "2",

"voice_helper_rules": [ { "transcription": "привет|здравствуй|здарова", "to_option": 1 }, { "transcription": "прощай|пока", "to_option": 2 } ],

"final": true,

"action": "voice_helper",

…. }

extension_id

string

id добавочного

call_api_id

string

id звонка, по которому начнется распознавание речи

action 

string

Может быть start или stop

direction 

string

Направление распознанной речи относительно extension_id.

out если голос идет от добавочного, in- если к добавочному

url 

string

url, куда будут отправляться события с распознанным текстом из речи