Open in
Повежите се из Zoom Contact Center-а
Усмерите позиве из Zoom Contact Center-а ка ThunderPhone агенту помоћу конектора за гласовни бот треће стране и вратите их људском агенту путем SIP REFER-а.
Виџет Бот у Вашем току Zoom Contact Center шаље позиваоца агенту са
идентификатором позива Zoom. Када је позиваоцу потребна особа, агент шаље SIP REFER
на адресу Zoom за људског агента, а Ваш ток преузима преусмеравање по идентификатору позива.
Пре него што почнете
- ThunderPhone агент и организациони API кључ.
- Zoom Marketplace Општа апликација, којом управља Ваш администратор и која је доступна за Contact Center, са конектором за виџет Бот (водич Zoom за гласовне ботове независних произвођача).
- SIP trunk од Zoom до добављача бота. ISV тим компаније Zoom га прави у фазама (откривање, пробни trunk, затим продукција), а назив компаније у апликацији мора се тачно подударати са записом за trunk. Ово подешавање почиње уз подршку ThunderPhone и Zoom, а не само на Вашем Zoom налогу.
1. Креирајте SIP крајњу тачку
Конектор Zoom позива 15-цифрени број који почиње са 999, а не SIP
адресу. Чувањем конектора генерише се тај број. Trunk компаније Zoom користи TLS 1.2
на порту 5061 са SRTP за звук и налази се на листи дозвољених на основу подмрежа Zoom, а
не лозинке. Зато креирајте ip_allowlist крајњу тачку са бројем конектора
као бројем за долазне позиве и обавезним SRTP-ом (погледајте
Платформе које позивају број телефона):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: подмреже SIP сигнализације Zoom, које добијате од Zoom. Свака мора бити опсег јавних IPv4 адреса величине/16или ужи (IPv6/48или ужи).dial_in_numbers: број конектора тачно онако како га Zoom шаље, без знака+.srtp:required, јер trunk компаније Zoom увек користи SRTP.
Адресе Zoom деле сви његови клијенти, па сваки други клијент Zoom који позове тај број долази до Вашег агента. Zoom додељује број; немојте га објављивати.
2. Шаљите позиве са контекстом
Додајте виџет Бот у Ваш ток и повежите га са конектором. Затражите од ISV
тима компаније Zoom да усмери trunk на sip.thunderphone.com, са TLS-ом на порту 5061,
са бројем конектора и у URI-ју захтева и у заглављу To. Крајња тачка
одбија UDP, па се уверите да trunk не прелази на њега.
Zoom шаље:
X-ZOOM-Call-Sid, сачуван каоexternal_call_idпозива. Сопствена страница Zoom за мапирање података га не наводи; интеграција Zoom другог добављача AI га документује, зато га проверите при првом пробном позиву.X-ZOOM-DNIS, број који је позивалац позвао, као{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, статички URL конектора.
3. Примите позив назад
Агент шаље REFER на адресу људског агента на Zoom-овом SBC-у. Додајте овај
број за пренос (погледајте
Додајте број за пренос),
са SBC адресом коју Вам Zoom даје:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Zoom-ово упутство описује два начина на која бот прослеђује контекст: POST на
статички URL конектора пре REFER захтева (догађаји voicebot_metadata и
слични) и SIP заглавља мапирана у одељку Улазно од бота. ThunderPhone не
шаље захтеве на статички URL. Zoom-ово упутство не наводи да ли чита мапирана
заглавља из REFER захтева; ако желите да покушате, додајте headers, као што
је "X-Handoff-Id": "{{handoff_id}}", у запис и проверите током пробног позива.
Такође потврдите са Zoom-ом да прихвата REFER без POST захтева са метаподацима
пре њега.
Да бисте добили податке о преносу без ослањања ни на једно од наведеног, нека их Ваш ток потражи после виџета Бот, помоћу виџета HTTP позив или Скрипта:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=након чега следи SID позива.- Заглавље
Authorization: Bearer sk_live_…. - Користите
handoff.summaryиhandoff.intentда бисте усмерили позиваоца и упознали особу која преузима позив са детаљима.
Zoom не објављује документацију на нивоу поља за ове виџете, па у свом налогу
потврдите да виџет може да пошаље заглавље Authorization. Погледајте
Потражите пренети позив.
Тестирајте
Позовите број који води до виџета Бот, затражите од агента разговор са особом и
проверите да ли позивалац стиже до људског агента и да ли виџет враћа податке о
преносу. Затим отворите позив помоћу GET /v1/calls/{call_id}: sip_headers
треба да садржи x-zoom-call-sid, а external_call_id треба да одговара SID-у
позива који Ваш ток користи.
Ограничења
- ThunderPhone не шаље захтеве на статички URL конектора, па Zoom добија
податке о преносу путем претраге или путем мапираних заглавља ако Ваш тест
покаже да их Zoom чита из
REFERзахтева. - Trunk израђује Zoom-ов ISV тим, тако да га не можете сами подесити нити тестирати.