---
title: "Zoom Contact Center سے کنیکٹ کریں"
description: "تیسرے فریق کے وائس بوٹ کنیکٹر کے ذریعے Zoom Contact Center کی کالز ThunderPhone ایجنٹ کو بھیجیں، اور SIP REFER کے ذریعے انہیں واپس انسانی ایجنٹ کو منتقل کریں۔"
---

آپ کے Zoom Contact Center فلو میں ایک بوٹ ویجیٹ کالر کو Zoom کے کال SID کے ساتھ ایجنٹ کے پاس بھیجتا ہے۔ جب کالر کو کسی شخص کی ضرورت ہو، تو ایجنٹ Zoom کے انسانی ایجنٹ کے پتے پر ایک SIP `REFER` بھیجتا ہے، اور آپ کا فلو کال SID کے ذریعے منتقلی حاصل کرتا ہے۔

## شروع کرنے سے پہلے

- ایک ThunderPhone ایجنٹ اور ایک تنظیم کی [API کلید](/ur/guides/api-keys)۔
- ایک Zoom Marketplace **عمومی ایپ**، جسے آپ کا منتظم منظم کرے اور Contact Center کے لیے دستیاب بنائے، اور جس میں بوٹ ویجیٹ کے لیے کنیکٹر ہو
  ([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` اینڈ پوائنٹ بنائیں
(دیکھیں
[وہ پلیٹ فارمز جو فون نمبر پر ڈائل کرتے ہیں](/ur/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 سگنلنگ سب نیٹس۔ ہر ایک
  عوامی IPv4 رینج `/16` یا اس سے زیادہ محدود ہونی چاہیے (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 پتہ استعمال کرتے ہوئے یہ
منتقلی نمبر شامل کریں (دیکھیں
[منتقلی نمبر شامل کریں](/ur/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 ٹیم بناتی ہے، اس لیے آپ اسے خود سیٹ اپ یا ٹیسٹ نہیں کر سکتے۔
