---
title: "Zoom Contact Center నుండి కనెక్ట్ చేయండి"
description: "థర్డ్-పార్టీ వాయిస్‌బాట్ కనెక్టర్‌తో Zoom Contact Center కాల్‌లను ThunderPhone ఏజెంట్‌కు పంపండి మరియు SIP REFERతో వాటిని తిరిగి మానవ ఏజెంట్‌కు బదిలీ చేయండి."
---

Zoom Contact Center ఫ్లోలోని బాట్ విడ్జెట్ కాలర్‌ను Zoom కాల్ sidతో ఏజెంట్‌కు పంపుతుంది. కాలర్‌కు వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ Zoom మానవ-ఏజెంట్ చిరునామాకు SIP `REFER` పంపుతుంది మరియు మీ ఫ్లో కాల్ sid ద్వారా హ్యాండ్-ఆఫ్‌ను పొందుతుంది.

## ప్రారంభించే ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/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` ఎండ్‌పాయింట్‌ను సృష్టించండి (చూడండి
[ఫోన్ నంబర్‌కు డయల్ చేసే ప్లాట్‌ఫారమ్‌లు](/te/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`: Zoom ట్రంక్ ఎల్లప్పుడూ SRTPను ఉపయోగిస్తుంది కాబట్టి `required`.

Zoom చిరునామాలు దాని కస్టమర్లందరికీ భాగస్వామ్యంగా ఉంటాయి, కాబట్టి సంఖ్యకు డయల్ చేసే ఏ ఇతర Zoom కస్టమర్ అయినా మీ ఏజెంట్‌ను చేరుకుంటారు. Zoom సంఖ్యను కేటాయిస్తుంది; దాన్ని ప్రచురించవద్దు.

## 2. సందర్భంతో కాల్‌లను పంపండి

మీ ఫ్లోకు ఒక **బాట్** విడ్జెట్‌ను జోడించి, దానిని కనెక్టర్‌కు అనుసంధానించండి. ట్రంక్‌ను `sip.thunderphone.com` వైపు, పోర్ట్ 5061లో TLSతో, రిక్వెస్ట్ URI మరియు `To` హెడర్ రెండింటిలోనూ కనెక్టర్ సంఖ్యతో సూచించమని Zoom యొక్క ISV బృందాన్ని అడగండి. ఎండ్‌పాయింట్ UDPని తిరస్కరిస్తుంది, కాబట్టి ట్రంక్ దానికి తిరిగి మారకుండా నిర్ధారించండి.

Zoom పంపేది:

- కాల్ యొక్క `external_call_id`గా నిల్వ చేయబడే `X-ZOOM-Call-Sid`. Zoom స్వంత డేటా
  మ్యాపింగ్ పేజీలో ఇది జాబితా చేయబడలేదు; మరొక AI ప్రొవైడర్ యొక్క Zoom ఇంటిగ్రేషన్ దీనిని డాక్యుమెంట్ చేస్తుంది,
  కాబట్టి మీ మొదటి పరీక్ష కాల్‌లో దీన్ని తనిఖీ చేయండి.
- కాలర్ డయల్ చేసిన సంఖ్య అయిన `X-ZOOM-DNIS`, ఇది `{{sip_x_zoom_dnis}}`గా ఉంటుంది.
- కనెక్టర్ యొక్క స్టాటిక్ URL అయిన `X-ZOOM-WEBHOOK`.

## 3. కాల్‌ను తిరిగి పొందండి

ఏజెంట్ Zoom యొక్క SBCలోని మానవ ఏజెంట్ చిరునామాకు `REFER` పంపుతుంది. ఈ
బదిలీ నంబర్‌ను (చూడండి
[బదిలీ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview)),
Zoom మీకు అందించే SBC చిరునామాతో జోడించండి:

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

సందర్భాన్ని బాట్ పంపగల రెండు విధానాలను Zoom గైడ్ వివరిస్తుంది: `REFER`కు ముందు
కనెక్టర్ యొక్క స్టాటిక్ URLకు `POST` పంపడం (`voicebot_metadata` మరియు ఇలాంటి
ఈవెంట్‌లు), అలాగే **బాట్ నుండి ఇన్‌బౌండ్** కింద మ్యాప్ చేసిన SIP హెడర్‌లు.
ThunderPhone స్టాటిక్ URLకు పోస్ట్ చేయదు. `REFER` నుండి మ్యాప్ చేసిన హెడర్‌లను
అది చదువుతుందో లేదో Zoom గైడ్‌లో చెప్పలేదు; మీరు ప్రయత్నించాలనుకుంటే, ఎంట్రీకి
`"X-Handoff-Id": "{{handoff_id}}"` వంటి `headers` జోడించి, టెస్ట్ కాల్‌లో
తనిఖీ చేయండి. అంతకు ముందు మెటాడేటా `POST` లేకుండా `REFER`ను అది అంగీకరిస్తుందో
లేదో కూడా Zoomతో నిర్ధారించండి.

వీటిలో దేనిపైనా ఆధారపడకుండా హ్యాండ్-ఆఫ్ పొందడానికి, బాట్ విడ్జెట్ తర్వాత మీ ఫ్లో
దానిని **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` నుండి చదువుతుందని కనిపిస్తే
  మ్యాప్ చేసిన హెడర్‌ల ద్వారా పొందుతుంది.
- ట్రంక్‌ను Zoom యొక్క ISV బృందం నిర్మిస్తుంది, కాబట్టి మీరు దానిని స్వయంగా సెటప్
  చేయలేరు లేదా పరీక్షించలేరు.
