---
title: "Zoom Contact Center પરથી કનેક્ટ કરો"
description: "થર્ડ-પાર્ટી વૉઇસબોટ કનેક્ટર વડે Zoom Contact Center કૉલ્સને ThunderPhone એજન્ટ પાસે મોકલો અને SIP REFER વડે તેમને ફરી માનવ એજન્ટ પાસે પરત મોકલો."
---

તમારા Zoom Contact Center ફ્લોમાંનો બોટ વિજેટ કૉલરને Zoom ના કૉલ sid સાથે એજન્ટ પાસે મોકલે છે. જ્યારે કૉલરને કોઈ વ્યક્તિની જરૂર હોય, ત્યારે એજન્ટ Zoom ના માનવ-એજન્ટ સરનામે SIP `REFER` મોકલે છે અને તમારો ફ્લો કૉલ sid દ્વારા હેન્ડ-ઓફ મેળવે છે.

## શરૂ કરતા પહેલાં

- એક ThunderPhone એજન્ટ અને સંસ્થાની [API કી](/gu/guides/api-keys).
- તમારા એડમિન દ્વારા સંચાલિત અને Contact Center માટે ઉપલબ્ધ કરાયેલી Zoom Marketplace **જનરલ એપ**, જેમાં બોટ વિજેટ માટે કનેક્ટર હોય
  ([Zoom ની તૃતીય-પક્ષ વૉઇસબોટ માર્ગદર્શિકા](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Zoom થી બોટ પ્રદાતા સુધીનો SIP ટ્રંક. Zoom ની ISV ટીમ તેને
  તબક્કાવાર બનાવે છે (ડિસ્કવરી, સ્ટેજિંગ ટ્રંક અને પછી પ્રોડક્શન), અને એપનું કંપનીનું
  નામ ટ્રંક રેકોર્ડ સાથે બરાબર મેળ ખાતું હોવું જોઈએ. આ સેટઅપ તમારા માત્ર Zoom એકાઉન્ટમાં નહીં,
  પરંતુ ThunderPhone સપોર્ટ અને Zoom સાથે શરૂ થાય છે.

## 1. SIP એન્ડપૉઇન્ટ બનાવો

Zoom નો કનેક્ટર SIP સરનામું નહીં, પરંતુ `999` થી શરૂ થતો 15-અંકનો નંબર ડાયલ કરે છે.
કનેક્ટર સાચવવાથી તે નંબર જનરેટ થાય છે. Zoom નો ટ્રંક ઑડિયો માટે SRTP સાથે
પોર્ટ 5061 પર TLS 1.2 નો ઉપયોગ કરે છે અને પાસવર્ડને બદલે Zoom ના સબનેટ્સ દ્વારા ઍલાઉલિસ્ટ થાય છે.
તેથી કનેક્ટરના નંબરને ડાયલ-ઇન નંબર તરીકે અને SRTP જરૂરી રાખીને `ip_allowlist` એન્ડપૉઇન્ટ બનાવો (જુઓ
[ફોન નંબર ડાયલ કરતા પ્લેટફૉર્મ્સ](/gu/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`: Zoom તરફથી મળતા Zoom ના SIP સિગ્નલિંગ સબનેટ્સ. દરેક
  `/16` અથવા તેનાથી વધુ સંકુચિત જાહેર IPv4 રેન્જ હોવી જોઈએ (IPv6 `/48` અથવા તેનાથી વધુ સંકુચિત).
- `dial_in_numbers`: Zoom જે રીતે મોકલે છે તે જ રીતે કનેક્ટરનો નંબર, `+` વિના.
- `srtp`: `required`, કારણ કે Zoom નો ટ્રંક હંમેશા SRTP નો ઉપયોગ કરે છે.

Zoom ના સરનામાં તેના બધા ગ્રાહકો વચ્ચે વહેંચાયેલા હોય છે, તેથી નંબર ડાયલ કરનાર કોઈપણ અન્ય Zoom ગ્રાહક
તમારા એજન્ટ સુધી પહોંચે છે. Zoom નંબર ફાળવે છે; તેને પ્રકાશિત કરશો નહીં.

## 2. સંદર્ભ સાથે કૉલ મોકલો

તમારા ફ્લોમાં **બોટ** વિજેટ ઉમેરો અને તેને કનેક્ટર સાથે બાંધો. Zoom ની ISV
ટીમને ટ્રંકને `sip.thunderphone.com` પર નિર્દેશિત કરવા કહો, પોર્ટ 5061 પર TLS સાથે, અને
રિક્વેસ્ટ URI તથા `To` હેડર બંનેમાં કનેક્ટરનો નંબર રાખો. એન્ડપૉઇન્ટ UDP ને નકારે છે,
તેથી ખાતરી કરો કે ટ્રંક તેના પર પાછો ન ફરે.

Zoom મોકલે છે:

- `X-ZOOM-Call-Sid`, જે કૉલના `external_call_id` તરીકે સંગ્રહિત થાય છે. Zoom ના પોતાના ડેટા
  મેપિંગ પેજમાં તે સૂચિબદ્ધ નથી; અન્ય AI પ્રદાતાનું Zoom ઇન્ટિગ્રેશન તેને દસ્તાવેજિત
  કરે છે, તેથી તમારા પ્રથમ પરીક્ષણ કૉલમાં તેને ચકાસો.
- `X-ZOOM-DNIS`, કૉલરે ડાયલ કરેલો નંબર, `{{sip_x_zoom_dnis}}` તરીકે.
- `X-ZOOM-WEBHOOK`, કનેક્ટરનું સ્થિર URL.

## 3. કૉલ પાછો મેળવો

એજન્ટ Zoom ના SBC પર માનવ એજન્ટના સરનામે `REFER` મોકલે છે. Zoom તમને આપે તે SBC સરનામા સાથે આ
ટ્રાન્સફર નંબર ઉમેરો (જુઓ
[ટ્રાન્સફર નંબર ઉમેરો](/gu/guides/contact-centers/overview)):

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

Zoom ની માર્ગદર્શિકા બોટ કોન્ટેક્સ્ટ મોકલવાની બે રીતો વર્ણવે છે: `REFER` પહેલાં
કનેક્ટરના સ્ટેટિક URL પર `POST` (`voicebot_metadata` અને સમાન
ઇવેન્ટ્સ), અને **Bot તરફથી ઇનબાઉન્ડ** હેઠળ મેપ કરેલા SIP હેડર્સ. ThunderPhone
સ્ટેટિક URL પર પોસ્ટ કરતું નથી. Zoom ની માર્ગદર્શિકા એ જણાવતી નથી કે તે
`REFER` માંથી મેપ કરેલા હેડર્સ વાંચે છે કે નહીં; જો તમે પ્રયાસ કરવા માંગતા હો, તો
એન્ટ્રીમાં `"X-Handoff-Id": "{{handoff_id}}"` જેવા `headers` ઉમેરો અને પરીક્ષણ કૉલમાં તપાસો. ઉપરાંત,
Zoom પાસેથી ખાતરી કરો કે તે પહેલાં કોઈ મેટાડેટા `POST` વગરનું `REFER` સ્વીકારે છે.

બંનેમાંથી કોઈ પર આધાર રાખ્યા વિના હેન્ડ-ઓફ મેળવવા માટે, તમારા ફ્લોમાં Bot વિજેટ પછી
**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).

## તેનું પરીક્ષણ કરો

Bot વિજેટ સુધી પહોંચતા નંબર પર કૉલ કરો, એજન્ટને કોઈ વ્યક્તિ સાથે વાત કરાવવાનું કહો, અને તપાસો
કે કૉલર માનવ એજન્ટ સુધી પહોંચે છે અને વિજેટ હેન્ડ-ઓફ પરત કરે છે. પછી
`GET /v1/calls/{call_id}` વડે કૉલ ખોલો: `sip_headers` માં
`x-zoom-call-sid` સૂચિબદ્ધ હોવું જોઈએ, અને `external_call_id` તમારા ફ્લો દ્વારા ઉપયોગમાં લેવાતા કૉલ sid સાથે
મેળ ખાતું હોવું જોઈએ.

## મર્યાદાઓ

- ThunderPhone કનેક્ટરના સ્ટેટિક URL પર પોસ્ટ કરતું નથી, તેથી Zoom ને
  હેન્ડ-ઓફ શોધ દ્વારા મળે છે, અથવા જો તમારા પરીક્ષણમાં Zoom `REFER` માંથી તેમને વાંચતું હોવાનું દેખાય તો મેપ કરેલા હેડર્સ દ્વારા મળે છે.
- ટ્રંક Zoom ની ISV ટીમ દ્વારા બનાવવામાં આવે છે, તેથી તમે તેને જાતે સેટ અપ અથવા પરીક્ષણ કરી શકતા નથી.
