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

Contact centers

Повежите се из 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 тим, тако да га не можете сами подесити нити тестирати.