Open in
Повежите из услуге 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агента.
- Заглавља разговора, тако да Genesys шаље свој ID разговора у
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 току:
- Опционо додајте радњу Поставите UUI податке са контекстом за агента, као
што је
account=12345. Genesys препоручује 128 знакова или мање. - Додајте радњу Пренесите на број са
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 скраћује да би се уклопио. ИД предаје увек стаје.