Поруке говорног позива

СпеецхЦалл је врста поруке интерактивног гласовног одговора (ИВР) која вам омогућава да упућујете аутоматизоване гласовне позиве са опцијама менија и ДТМФ (двотонско више фреквенција) интеракцијама.

Преглед

СпеецхЦалл омогућава предузећима да:

• Упућујте аутоматизоване гласовне позиве клијентима
• Пустите уводне аудио поруке
• Представите интерактивне опције менија
• Управљајте ДТМФ одговорима на притисак тастера (0-9, *, #)
• Дефинишите прилагођено понашање за неважеће уносе/истек – Покрени веб-хукове са прилагођеним телима и заглављима на основу избора корисника
• Управљајте током позива динамички (навигација између менија)

Случајеви употребе

• Анкете клијената - Прикупите повратне информације путем опција менија телефона
• Подсетници за састанке - Потврдите или поново закажите гласовном интеракцијом
• Праћење поруџбине - Обезбедите ажурирања статуса поруџбине
• Интерактивна обавештења - Испоручите важне информације са опцијама акције
• Верификација гласом - Вишефакторска аутентификација путем гласовних позива

Формат захтева

Основна структура

ЦОДЕ_БЛОЦК_0

Опис параметра

Параметар	Тип	Обавезно	Опис
од	стринг	Да	Идентификатор пошиљаоца (алфа име или ИД)
то	стринг	Да	Телефонски број примаоца у међународном формату
текст	стринг	Да	Текстуална вредност, обично “ивр” за СпеецхЦалл
тип	стринг	Да	Мора бити "спеецхцалл"
мени	низ	Да	Низ конфигурација менија за позив

Конфигурација менија

Сваки објекат менија садржи:

Параметар	Тип	Обавезно	Опис
интроУрл	стринг	Да	УРЛ или идентификатор уводне аудио датотеке
идлеТимеоутМсец	цео број	Не	Време је истекло у милисекундама за чекање на притисак на тастер (нпр. 10000). Ако корисник не одговори, биће извршене акције конфигурисане под погрешним кључем
дтмфАцтионс	објекат	Да	Мапа ДТМФ кључева за радње

ДТМФ акције

Објекат дтмфАцтионс мапира ДТМФ кључеве или посебне услове у низове радњи:

ДТМФ кључ	Опис
д0	Притисните 0
д1	Притисните 1
д2	Притисните 2
…	…
д9	Притисните 9
д*	Притисните *
д#	Притисните #
погрешно	Покреће се када се притисне неважећи тастер или када се достигне идлеТимеоутМсец без икаквог уноса

Сваки ДТМФ кључ/услов се пресликава на низ акција које ће се извршавати у низу.

Подржане акције

Акција	Параметри	Опис
вебхоок	урл (стринг, обавезан)<бр>боди (објекат, опционо)<бр>хеадерс (објекат, опционо)	Шаље ХТТП ПОСТ захтев у ЈСОН формату на наведену УРЛ адресу. Објекат боди ће бити угнежђен испод поља ацтион у захтеву за веб-хук. Прилагођена заглавља су укључена као ХТТП заглавља.
хангуп	Ноне	Завршава позив
готоМену	мени (стринг или цео број)	Пребацује позив на други мени у низу мену користећи индекс заснован на 0 (нпр. "1")

Детаилед Ацтион Бехавиор

Вебхоок радња (вебхоок)

Радња вебхоок шаље ХТТП ПОСТ захтев на УРЛ повратног позива са метаподацима позива и опционим прилагођеним подацима:

• Ако је тело обезбеђено, његови парови кључ-вредност се шаљу унутар поља акција тела корисног оптерећења.
• Ако су заглавља наведена, она се шаљу као прилагођена ХТТП заглавља у захтеву.

Акција прекида (прекид)

Акција прекид одмах прекида активни позив. Ниједна даље радња у низу или менијима неће бити обрађена након акције прекидања.

Иди на радњу менија (готоМену)

Акција готоМену преусмерава ток позива на другу структуру менија унутар низа мену. Потребан је један параметар мени који специфицира индекс циљног менија заснован на 0 (нпр. "1" за прелазак на други мени или "0" за поновно покретање првог менија).

---

Неактивност и руковање грешкама (погрешно)

Погрешан кључ унутар дтмфАцтионс је посебан руковалац пропуста. Он извршава свој низ акција у два сценарија:

1. Неважећи унос: Позивалац притисне ДТМФ тастер који није дефинисан у дтмфАцтионс (на пример, притисну 3, али мени дефинише само д1 и д2).
2. Време чекања у мировању: Позивалац не притисне ниједан тастер у трајању одређеном са идлеТимеоутМсец.

Ако погрешно није дефинисано и позивалац притисне неважећи тастер или истекне, ток позива ће подразумевано прекинути везу. Дефинисање погрешног вам омогућава да направите меније петље (нпр. враћање на исти мени са "ацтион": "готоМену", "мену": "0") или преусмеравање корисника на мени помоћи.

---

Формат испоруке Вебхоок-а

Када се покрене акција вебхоок, систем шаље ХТТП ПОСТ захтев на конфигурисани урл са Цонтент-Типе: апплицатион/јсон.

Заглавља захтева Вебхоок-а

Ако је радња конфигурисана са параметром хеадерс, ти парови кључ-вредност су укључени као ХТТП заглавља у захтеву.

Тело захтева за Вебхоок

ЈСОН корисни терет послат на УРЛ веб-хука има следећу структуру:

ЦОДЕ_БЛОЦК_1

Поље	Тип	Опис
од	стринг	Број телефона позиваоца / ИД пошиљаоца
то	стринг	Број телефона примаоца
средина	стринг	ИД поруке
акција	објекат	Прилагођени ЈСОН објекат дефинисан у пољу тело акције

Комплетан пример

Једноставан ИВР са временским ограничењем и провером уноса

ЦОДЕ_БЛОЦК_2

Комплексни ИВР са више менија и ДТМФ рутирањем

Овај пример показује како да дефинишете више менија и да се крећете између њих користећи радњу готоМену када корисник унесе неважећи тастер или када позив истекне. Такође приказује прилагођена тела и прилагођена ХТТП заглавља послата са покретачима веб-хука.

ЦОДЕ_БЛОЦК_3

Формат одговора

Успешан одговор

ЦОДЕ_БЛОЦК_4

Обрада грешака

ХТТП статус	Опис
200	Захтев је успео
400	Неважећи формат захтева
401	Аутентификација није успела
429	Ограничење стопе је прекорачено
500	Интерна грешка сервера

цУРЛ Пример

ЦОДЕ_БЛОЦК_5

Најбоље праксе

1. Аудио датотеке – Уверите се да су уводне УРЛ адресе доступне и да су аудио датотеке у подржаним форматима
2. Поузданост веб-хук-а – Дизајнирајте веб-хукове да брзо реагују (у року од 2 секунде)
3. ДТМФ опције - Ограничите опције менија на 4-6 избора за боље корисничко искуство
4. Управљање временским ограничењем – Користите идлеТимеоутМсец да бисте одредили прилагођена ограничења неактивности (нпр. 10000 мс) и конфигурисали грациозан резервни део испод погрешног ДТМФ тастера (као што је понављање менија или прекидање везе)
5. Ток позива са више менија - пажљиво користите готоМену да бисте спречили бесконачне петље приликом усмеравања корисника назад на претходне меније
6. Резервна стратегија – Користите резервне поруке за кориснике који не одговарају или прекину везу

Повезане теме

• Пошаљи поруку - Општи водич за слање порука
• Фласх позив - Једноставни позиви за гласовну верификацију
• Провери статус - Пратите статус испоруке поруке
• Типови порука - Преглед свих подржаних типова порука