Иди на текст

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

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

Преглед

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

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

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

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

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

ЦОДЕ_БЛОЦК_0

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

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

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

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

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

ДТМФ акције

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

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

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

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

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

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

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

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

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

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

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

ЦОДЕ_БЛОЦК_1

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

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

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

ЦОДЕ_БЛОЦК_2

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

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

ЦОДЕ_БЛОЦК_3

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

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

ЦОДЕ_БЛОЦК_4

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

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

цУРЛ Пример

ЦОДЕ_БЛОЦК_5

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

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

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