---
title: "Five9 سے کنیکٹ کریں"
description: "AI Agent Connect کے ذریعے SIP پر Five9 کالز کو ThunderPhone ایجنٹ تک بھیجیں، اور انہیں ان روٹنگ ہیڈرز کے ساتھ واپس حاصل کریں جنہیں آپ کی IVR اسکرپٹ پڑھتی ہے۔"
---

آپ کی Five9 IVR اسکرپٹ کالر کو Five9 کی کال کی تفصیلات کے ساتھ ایجنٹ کے پاس بھیجتی ہے۔ جب ایجنٹ کا کام مکمل ہو جاتا ہے، تو وہ SIP `BYE` پر روٹنگ ہیڈرز کے ساتھ کال منقطع کرتا ہے، جنہیں اسکرپٹ کالر کو روٹ کرنے کے لیے کال ویری ایبلز میں پڑھتی ہے۔

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

- ایک ThunderPhone ایجنٹ اور تنظیم کی [API کلید](/ur/guides/api-keys)۔
- Five9 کا **AI ایجنٹ کنیکٹ** ایڈ آن۔ Five9 اسے ان AI فراہم کنندگان تک محدود رکھتا ہے جنہیں اس نے منظوری دی ہو، اور Five9 کی عمل درآمد ٹیم اسے ترتیب دیتی ہے: یہ فراہم کنندہ کا IVR اسکرپٹ ٹیمپلیٹ درآمد کرتی ہے، کال ویری ایبلز بناتی ہے اور اسکرپٹ کے **فریقِ ثالث منتقلی** ماڈیول کو فراہم کنندہ کی طرف متوجہ کرتی ہے۔ ThunderPhone ابھی Five9 کی منظور شدہ فہرست میں شامل نہیں ہے: اس پر منصوبہ بنانے سے پہلے اپنی Five9 اکاؤنٹ ٹیم یا ThunderPhone سپورٹ سے پوچھیں۔

## 1. SIP اینڈپوائنٹ بنائیں

Five9 کا فریقِ ثالث منتقلی ماڈیول SIP ایڈریس کے بجائے فون نمبر ڈائل کرتا ہے، اور دوسرے فراہم کنندگان کے Five9 انضمامات Five9 کی توثیق پاس ورڈ کے بجائے سورس ایڈریس سے کرتے ہیں۔ اس لیے Five9 کے ڈائل کیے جانے والے نمبر کو ڈائل اِن نمبر کے طور پر شامل کرتے ہوئے ایک `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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: Five9 سے حاصل کردہ آپ کے Five9 ڈیٹا سینٹرز کی SIP سگنلنگ رینجز۔ ہر ایک عوامی IPv4 رینج `/16` یا اس سے زیادہ محدود ہونی چاہیے (IPv6 `/48` یا اس سے زیادہ محدود)۔
- `dial_in_numbers`: وہ نمبر جو Five9 کی اسکرپٹ ڈائل کرے گی، اسی انداز میں لکھا ہوا جس میں Five9 اسے بھیجتا ہے۔ اس کا حقیقی فون نمبر ہونا ضروری نہیں ہے۔ یہ ThunderPhone پر پہلے سے بطور فون نمبر یا کسی دوسرے اینڈپوائنٹ پر استعمال میں نہیں ہو سکتا: ایسی صورت میں `409` واپس آتا ہے۔

Five9 کے ایڈریس اس کے تمام صارفین میں مشترک ہوتے ہیں، اس لیے کوئی بھی دوسرا Five9 صارف جو یہ نمبر ڈائل کرے گا آپ کے ایجنٹ تک پہنچ جائے گا۔ نمبر منتخب کرتے وقت، ایک لمبا نمبر منتخب کریں جس کا کوئی اندازہ نہ لگا سکے (15 ہندسوں تک)، یقینی بنائیں کہ Five9 اسے فون نیٹ ورک پر باہر بھیجنے کے بجائے ThunderPhone کو بھیجتا ہے، اور اسے شائع نہ کریں۔

## 2. سیاق کے ساتھ کالز بھیجیں

Five9 کی عمل درآمد ٹیم سے کہیں کہ:

- کال کو **فریقِ ثالث منتقلی** ماڈیول سے
  `sip:+14155550188@sip.thunderphone.com` پر بھیجیں، جس میں نمبر ریکویسٹ URI اور `To` ہیڈر، دونوں میں ہو۔ ماڈیول فراہم کنندہ کے SIP ڈومین کے ساتھ ہیڈر میں نمبر لیتا ہے۔
- اسے TLS (پورٹ 5061) یا TCP (پورٹ 5060) پر بھیجیں۔ اینڈپوائنٹ UDP کو مسترد کرتا ہے، اور Five9 یہ شائع نہیں کرتا کہ وہ کون سی ٹرانسپورٹ استعمال کرتا ہے، اس لیے یقینی بنائیں کہ وہ UDP نہ ہو۔
- **تیسرے فریق کی کال کے بعد واپس جائیں** کو فعال کریں، تاکہ ایجنٹ کے کال منقطع کرنے پر اسکرپٹ جاری رہے (Five9 تیسرے فریق کی کال پر 3,600 سیکنڈ تک کی اجازت دیتا ہے)۔

Five9 کی گائیڈ ان اقدار کی فہرست دیتی ہے جو وہ بھیجتا ہے (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` اور دیگر)، ان کے
ہیڈر نام نہیں۔ دوسرے AI فراہم کنندگان کے Five9 انضمامات انہیں SIP پیغامات میں
`X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
اور `X-AgentID` کے طور پر دستاویز کرتے ہیں؛ اپنی پہلی آزمائشی کال پر انہیں چیک کریں۔ ہر ایک prompt تک ویری ایبل کے طور پر پہنچتا ہے، مثلاً
`{{sip_x_callcampaign}}`۔ `X-CallID` کال کے
`external_call_id` کے طور پر محفوظ ہوتا ہے۔

## 3. کال واپس کریں

ایجنٹ کال واپس کرتا ہے: یہ الوداع کہتا ہے اور کال ختم کرتا ہے، اور `BYE` میں وہ
چار ہیڈرز شامل ہوتے ہیں جو Five9 کا اسکرپٹ پڑھتا ہے۔ یہ ٹرانسفر نمبر شامل کریں (دیکھیں
[ٹرانسفر نمبر شامل کریں](/ur/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` اور `X-RouteValue` اسکرپٹ کو بتاتے ہیں کہ کالر کو کہاں بھیجنا ہے،
  یہاں سپورٹ اسکل میں۔ دوسرے فراہم کنندگان `X-RouteType` کے لیے جن ویلیوز کی دستاویز کرتے ہیں ان میں
  `SkillTransfer`، `PhoneTransfer`، `Hangup` اور `DispositionOnly` شامل ہیں؛
  ویلیوز پر اسکرپٹ برقرار رکھنے والے شخص سے اتفاق کریں۔ متعدد منزلوں کے لیے، ہر
  منزل کے لیے مختلف نام اور `X-RouteValue` کے ساتھ ایک الگ واپسی شامل کریں۔
- `X-RouteReason` ایجنٹ کا انٹینٹ لیبل لے جاتا ہے، جیسے `billing_dispute`۔
- `X-CustomMetaData` ہینڈ آف آئی ڈی لے جاتا ہے۔ `BYE` اسے
  `X-TP-Handoff-Id` کے طور پر بھی لے جاتا ہے، جسے Five9 نہیں پڑھتا۔

Five9 کا اسکرپٹ ان چار ہیڈرز کو کال ویری ایبلز میں میپ کرتا ہے۔ ایجنٹ کے
خلاصے کے لیے، اسکرپٹ سے IVR کے **استعلام** ماڈیول کے ذریعے ہینڈ آف تلاش کو کال کروائیں:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` کے بعد
`call.call_id`، ایک آتھنٹیکیشن پروفائل کے ساتھ جو
`Authorization: Bearer` اور آپ کی API کلید بھیجتا ہو۔ دیکھیں
[ہینڈ آف کی گئی کال تلاش کریں](/api-reference/calls#look-up-a-handed-off-call)۔

## اس کی جانچ کریں

IVR اسکرپٹ پر کال کریں، ایجنٹ سے کسی شخص سے بات کرانے کو کہیں، اور تصدیق کریں کہ اسکرپٹ
کال ویری ایبلز بھرے ہوئے ہونے کے ساتھ کالر کو روٹ کرتا ہے۔ اگر کال کبھی ایجنٹ تک نہ پہنچے،
تو تصدیق کریں کہ ریکویسٹ URI اور `To` ہیڈر میں موجود نمبر ڈائل اِن نمبر سے مطابقت رکھتا ہے،
کہ Five9 کا سورس ایڈریس `allowed_source_cidrs` میں ہے، اور
کہ کال TCP یا TLS کے ذریعے آئی تھی۔ پھر کال کو
`GET /v1/calls/{call_id}` کے ذریعے کھولیں: `sip_headers` میں `x-callid` درج ہونا چاہیے، اور
`external_call_id` کو Five9 میں `call.call_id` سے مطابقت رکھنی چاہیے۔

## حدود

- Five9 کی گائیڈ `BYE` پر روٹنگ ڈیٹا کی دستاویز کرتی ہے اور
  `REFER` قبول کرنے کا ذکر نہیں کرتی، اس لیے واپس منتقلی اسکرپٹ کے ذریعے کولڈ ٹرانسفر ہے۔
- Five9 `X-RouteType`، `X-RouteValue`، `X-RouteReason` اور
  `X-CustomMetaData` پڑھتا ہے، `User-to-User` نہیں۔ ThunderPhone ہر ہیڈر ویلیو
  زیادہ سے زیادہ 256 بائٹس طویل بھیجتا ہے۔
- Five9 پیکٹ فریگمینٹیشن سے بچنے کے لیے کسٹم ہیڈرز کو تقریباً دس تک رکھنے کی
  سفارش کرتا ہے۔
