---
title: "Повежите се из Zoom Contact Center-а"
description: "Усмерите позиве из Zoom Contact Center-а ка ThunderPhone агенту помоћу конектора за гласовни бот треће стране и вратите их људском агенту путем SIP REFER-а."
---

Виџет Бот у Вашем току Zoom Contact Center шаље позиваоца агенту са
идентификатором позива Zoom. Када је позиваоцу потребна особа, агент шаље SIP `REFER`
на адресу Zoom за људског агента, а Ваш ток преузима преусмеравање по идентификатору позива.

## Пре него што почнете

- ThunderPhone агент и организациони [API кључ](/sr/guides/api-keys).
- Zoom Marketplace **Општа апликација**, којом управља Ваш администратор и која је доступна
  за Contact Center, са конектором за виџет Бот
  ([водич Zoom за гласовне ботове независних произвођача](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- 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-ом (погледајте
[Платформе које позивају број телефона](/sr/guides/sip-addresses)):

```bash
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-у. Додајте овај
број за пренос (погледајте
[Додајте број за пренос](/sr/guides/contact-centers/overview)),
са SBC адресом коју Вам Zoom даје:

```json
{"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`. Погледајте
[Потражите пренети позив](/api-reference/calls#look-up-a-handed-off-call).

## Тестирајте

Позовите број који води до виџета Бот, затражите од агента разговор са особом и
проверите да ли позивалац стиже до људског агента и да ли виџет враћа податке о
преносу. Затим отворите позив помоћу `GET /v1/calls/{call_id}`: `sip_headers`
треба да садржи `x-zoom-call-sid`, а `external_call_id` треба да одговара SID-у
позива који Ваш ток користи.

## Ограничења

- ThunderPhone не шаље захтеве на статички URL конектора, па Zoom добија
  податке о преносу путем претраге или путем мапираних заглавља ако Ваш тест
  покаже да их Zoom чита из `REFER` захтева.
- Trunk израђује Zoom-ов ISV тим, тако да га не можете сами подесити нити
  тестирати.
