---
title: "Yhdistä Zoom Contact Centeristä"
description: "Ohjaa Zoom Contact Center -puhelut ThunderPhone-agentille kolmannen osapuolen äänibottiyhdistimellä ja siirrä ne takaisin ihmisen agentille SIP REFER -pyynnöllä."
---

Zoom Contact Center -työnkulkusi Botti-widget lähettää soittajan agentille Zoomin
puhelun SID-tunnuksen avulla. Kun soittaja tarvitsee ihmisen, agentti lähettää SIP-`REFER`-pyynnön
Zoomin ihmisagentin osoitteeseen, ja työnkulkusi hakee siirron puhelun SID-tunnuksen perusteella.

## Ennen kuin aloitat

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Zoom Marketplace -palvelun **Yleinen sovellus**, jota ylläpitäjäsi hallinnoi ja joka on otettu
  käyttöön Contact Centerissä, sekä Botti-widgetin liitin
  ([Zoomin kolmannen osapuolen puhebotin opas](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Zoomista botin tarjoajalle kulkeva SIP-runko. Zoomin ISV-tiimi rakentaa sen
  vaiheittain (kartoitus, testi-SIP-runko ja sitten tuotanto), ja sovelluksen Company
  Name -arvon on vastattava täsmälleen SIP-rungon tietuetta. Tämä määritys aloitetaan ThunderPhone-
  tuen ja Zoomin kanssa, ei pelkästään Zoom-tililläsi.

## 1. Luo SIP-päätepiste

Zoomin liitin soittaa `999`-alkuiseen 15-numeroiseen numeroon, ei SIP-
osoitteeseen. Liittimen tallentaminen luo kyseisen numeron. Zoomin SIP-runko käyttää TLS 1.2:ta
portissa 5061 ja SRTP:tä äänelle, ja se sallitaan Zoomin aliverkkojen eikä salasanan
perusteella. Luo siis `ip_allowlist`-päätepiste, jossa liittimen numero on soittonumerona ja SRTP on pakollinen (katso
[Alustat, jotka soittavat puhelinnumeroon](/fi/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`: Zoomin SIP-signaloinnin aliverkot, jotka saat Zoomilta. Jokaisen on
  oltava julkinen IPv4-alue, jonka peite on `/16` tai tarkempi (IPv6 `/48` tai tarkempi).
- `dial_in_numbers`: liittimen numero täsmälleen siinä muodossa kuin Zoom sen lähettää, ilman
  `+`-merkkiä.
- `srtp`: `required`, koska Zoomin SIP-runko käyttää aina SRTP:tä.

Zoomin osoitteet ovat yhteisiä kaikille sen asiakkaille, joten kuka tahansa toinen Zoom-asiakas,
joka soittaa numeroon, pääsee agentillesi. Zoom määrittää numeron; älä
julkaise sitä.

## 2. Lähetä puhelut kontekstin kanssa

Lisää työnkulkuusi **Botti**-widget ja liitä se liittimeen. Pyydä Zoomin ISV-
tiimiä ohjaamaan SIP-runko osoitteeseen `sip.thunderphone.com` TLS:llä portissa 5061 siten, että
liittimen numero on sekä pyyntö-URI:ssa että `To`-otsikossa. Päätepiste
ei hyväksy UDP:tä, joten varmista, ettei SIP-runko palaa siihen varavaihtoehtona.

Zoom lähettää:

- `X-ZOOM-Call-Sid`, joka tallennetaan puhelun `external_call_id`-arvoksi. Zoomin oma tietojen
  yhdistämissivu ei luettele sitä; toisen tekoälypalveluntarjoajan Zoom-integraatio dokumentoi
  sen, joten tarkista se ensimmäisessä testipuhelussasi.
- `X-ZOOM-DNIS`, soittajan soittaman numeron, muodossa `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, liittimen staattisena URL-osoitteena.

## 3. Ohjaa puhelu takaisin

Agentti lähettää `REFER`-pyynnön Zoomin SBC:ssä olevaan ihmisagentin osoitteeseen. Lisää tämä
siirtonumero (katso
[Lisää siirtonumero](/fi/guides/contact-centers/overview)),
käyttäen Zoomin antamaa SBC-osoitetta:

```json
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}
```

Zoomin ohjeessa kuvataan kaksi tapaa, joilla botti välittää kontekstin: `POST`-pyyntö
yhdistimen staattiseen URL-osoitteeseen ennen `REFER`-pyyntöä (`voicebot_metadata` ja vastaavat
tapahtumat) sekä SIP-otsakkeet, jotka on yhdistetty kohdan **Saapuva liikenne botilta** alle. ThunderPhone
ei lähetä pyyntöjä staattiseen URL-osoitteeseen. Zoomin ohjeessa ei kerrota, lukeeko se
yhdistetyt otsakkeet `REFER`-pyynnöstä. Jos haluat kokeilla sitä, lisää merkintään `headers`,
kuten `"X-Handoff-Id": "{{handoff_id}}"`, ja tarkista asia testipuhelulla. Varmista myös
Zoomilta, että se hyväksyy `REFER`-pyynnön ilman sitä edeltävää metatietojen `POST`-pyyntöä.

Jotta saat siirron ilman kumpaankaan tukeutumista, määritä työnkulkusi hakemaan se
Bot-widgetin jälkeen **HTTP-kutsu**- tai **Skripti**-widgetillä:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ja sen perään puhelun sid.
- Otsake `Authorization: Bearer sk_live_…`.
- Reititä soittaja `handoff.summary`- ja `handoff.intent`-arvojen avulla ja anna
  puhelun vastaanottavalle henkilölle tarvittavat taustatiedot.

Zoom ei julkaise näiden widgetien kenttäkohtaisia ohjeita, joten varmista omalla
tililläsi, että widget voi lähettää `Authorization`-otsakkeen. Katso
[Hae siirretty puhelu](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Soita numeroon, joka ohjautuu Bot-widgetiin, pyydä puheagentilta ihmistä ja tarkista,
että soittaja päätyy ihmisagentille ja widget palauttaa siirtotiedot. Avaa sitten
puhelu komennolla `GET /v1/calls/{call_id}`: `sip_headers`-kentässä pitäisi näkyä
`x-zoom-call-sid`, ja `external_call_id`-arvon pitäisi vastata työnkulkusi käyttämää
puhelun sid-arvoa.

## Rajoitukset

- ThunderPhone ei lähetä pyyntöjä yhdistimen staattiseen URL-osoitteeseen, joten Zoom saa
  siirron haun kautta tai yhdistettyjen otsakkeiden kautta, jos testisi osoittaa, että
  Zoom lukee ne `REFER`-pyynnöstä.
- Zoomin ISV-tiimi rakentaa trunkin, joten et voi määrittää tai testata sitä itse.
