ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Contact centers

Повежите из услуге Genesys Cloud

Проследите позиве из услуге Genesys Cloud агенту ThunderPhone преко BYOC Cloud магистрале са ИД-ом разговора и UUI-јем, а затим их вратите са преносом у UUI-ју.

Ваш Architect ток шаље позиваоца агенту преко BYOC Cloud магистрале, са ID-ом разговора и свим UUI вредностима које подесите. Када је позиваоцу потребна особа, агент шаље SIP REFER, Genesys преузима позив назад, а ID предаје стиже у UUI позива.

Пре почетка

  • ThunderPhone агент и организациони API кључ.
  • Genesys Cloud са BYOC Cloud-ом и спољном магистралом (тип BYOC Carrier или PBX) са укљученим следећим подешавањима (подешавања спољне магистрале):
    • Заглавља разговора, тако да Genesys шаље свој ID разговора у x-inin-cnv. Подразумевано је искључено.
    • UUI прослеђивање, са типом заглавља User-To-User и Hex кодирањем.
    • Преузимање назад и пренос, тако да Genesys прихвата REFER агента.

1. Креирајте SIP крајњу тачку

Genesys одговара на digest изазов, па користите стандардну крајњу тачку:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Genesys Cloud"}'

Одмах сачувајте password из одговора; приказује се само једном. На магистрали:

ПодешавањеВредност
SIP серверsip.thunderphone.com, порт 5061
ПротоколTLS
Digest аутентификацијаusername и password крајње тачке
КодециPCMU, PCMA или G.722

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

2. Шаљите позиве са контекстом

У вашем Architect току:

  1. Опционо додајте радњу Поставите UUI податке са контекстом за агента, као што је account=12345. Genesys препоручује 128 знакова или мање.
  2. Додајте радњу Пренесите на број са sip_uri крајње тачке, на пример sip:agent-12-jhxmginwjx@sip.thunderphone.com.

Genesys шаље ID разговора у x-inin-cnv. ThunderPhone га чува као external_call_id позива. UUI стиже у упит декодиран, као {{sip_uui}}.

Прилагођена заглавља магистрале су статична у Genesys-у, па вредности по позиву ставите у UUI. Genesys за себе резервише префиксе заглавља x-inin, x-genesys, x-pcv и x-gcv.

3. Преузмите позив назад

Агент преноси позив помоћу REFER на адресу у Genesys-у, са ID-ом предаје као hex UUI унутар те адресе. Додајте овај број за пренос (погледајте Додајте број за пренос и Заглавља унутар адресе за пренос):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Замените адресу оном која усмерава назад на ред или ток који треба да преузме позиваоца; потврдите њен облик са Genesys-ом. REFER изгледа овако:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Када је укључено Преузимање назад и пренос, Genesys преузима позив назад са магистрале и усмерава га на ту адресу. Genesys документује да долазни UUI стиже у Call.UUIData; то не документује за преузимање назад, па потврдите са Genesys-ом, или на пробном позиву, да ток који прима позиваоца тамо проналази ID предаје. Да бисте добили резиме и намеру, позовите претрагу предаје помоћу радње Позовите радњу за податке у интеграцији Web Services Data Actions:

  • Захтев: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= праћен ID-ом из Call.UUIData.
  • Акредитиви: ваш API кључ, послат као Authorization: Bearer sk_live_….
  • Излаз: мапирајте handoff.summary и handoff.intent на променљиве тока.

Погледајте Потражите предати позив.

Тестирајте

Позовите број који води до тока, затражите од агента особу и проверите да ли Genesys преусмерава позив на адресу коју сте поставили. У том току проверите да Call.UUIData садржи ИД предаје као текст (ако приказује хексадецималне цифре, проверите да ли је UUI кодирање магистрале подешено на Hex). Затим отворите позив помоћу GET /v1/calls/{call_id}: external_call_id треба да буде ИД разговора.

Ограничења

  • Радња Преузмите SIP заглавља чита само почетни INVITE, па не може да прочита ништа из агентског REFER. Предаја стиже до Genesys-а само путем UUI-ја.
  • Genesys одбацује сав UUI када позив садржи више од једног UUI заглавља.
  • Адреса за пренос је ограничена на 254 знака, па се дугачак UUI скраћује да би се уклопио. ИД предаје увек стаје.