---
title: "Genesys Cloud سے کنیکٹ کریں"
description: "Genesys Cloud کالز کو گفتگو کی id اور UUI کے ساتھ BYOC Cloud trunk کے ذریعے ThunderPhone ایجنٹ کو بھیجیں، اور hand-off کو UUI میں رکھ کر انہیں واپس لیں۔"
---

آپ کا Architect فلو کالر کو BYOC Cloud ٹرنک کے ذریعے ایجنٹ کے پاس بھیجتا ہے، گفتگو ID اور آپ کی مقرر کردہ کسی بھی UUI کے ساتھ۔ جب کالر کو کسی شخص کی ضرورت ہو، تو ایجنٹ ایک SIP `REFER` بھیجتا ہے، Genesys کال واپس لے لیتا ہے، اور منتقلی ID کال کی UUI میں پہنچتی ہے۔

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

- ایک ThunderPhone ایجنٹ اور تنظیم کی [API کلید](/ur/guides/api-keys)۔
- Genesys Cloud جس میں BYOC Cloud ہو، اور ایک بیرونی ٹرنک (قسم BYOC Carrier یا PBX) جس میں یہ ترتیبات فعال ہوں
  ([بیرونی ٹرنک کی ترتیبات](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **گفتگو ہیڈرز**، تاکہ Genesys اپنی گفتگو ID `x-inin-cnv` میں بھیجے۔ یہ بطور ڈیفالٹ بند ہوتا ہے۔
  - **UUI پاس تھرو**، جس کا ہیڈر ٹائپ `User-To-User` اور انکوڈنگ ہیکس ہو۔
  - **واپس لینا اور منتقل کرنا**، تاکہ Genesys ایجنٹ کا `REFER` قبول کرے۔

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

Genesys ڈائجسٹ چیلنج کا جواب دیتا ہے، اس لیے ایک معیاری اینڈ پوائنٹ استعمال کریں:

```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": "Genesys Cloud"}'
```

جواب سے `password` فوراً محفوظ کر لیں؛ یہ صرف ایک بار دکھایا جاتا ہے۔ ٹرنک پر:

| ترتیب | قدر |
|---|---|
| SIP سرور | `sip.thunderphone.com`، پورٹ `5061` |
| پروٹوکول | TLS |
| ڈائجسٹ توثیق | اینڈ پوائنٹ کا `username` اور `password` |
| کوڈیکس | PCMU، PCMA یا G.722 |

ٹرنک کو اپنی سائٹ کے ایک آؤٹ باؤنڈ روٹ پر رکھیں جس کا نمبر پلان اس پتے کا احاطہ کرتا ہو جسے فلو ڈائل کرتا ہے۔

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

اپنے Architect فلو میں:

1. اختیاری طور پر، ایجنٹ کے لیے سیاق کے ساتھ ایک **UUI ڈیٹا مقرر کریں** ایکشن شامل کریں، مثلاً `account=12345`۔ Genesys 128 یا اس سے کم حروف کی تجویز دیتا ہے۔
2. اینڈ پوائنٹ کے `sip_uri` کے ساتھ ایک **نمبر پر منتقل کریں** ایکشن شامل کریں، مثلاً `sip:agent-12-jhxmginwjx@sip.thunderphone.com`۔

Genesys گفتگو ID کو `x-inin-cnv` میں بھیجتا ہے۔ ThunderPhone اسے کال کی `external_call_id` کے طور پر محفوظ کرتا ہے۔ UUI ڈی کوڈ ہو کر prompt میں `{{sip_uui}}` کے طور پر پہنچتی ہے۔

Genesys میں ٹرنک کے کسٹم ہیڈرز جامد ہوتے ہیں، اس لیے فی کال اقدار UUI میں رکھیں۔ Genesys `x-inin`، `x-genesys`، `x-pcv` اور `x-gcv` ہیڈر سابقے اپنے لیے محفوظ رکھتا ہے۔

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

ایجنٹ Genesys پر موجود ایک پتے کو `REFER` کے ذریعے منتقل کرتا ہے، جس میں اس پتے کے اندر منتقلی ID بطور ہیکس UUI ہوتی ہے۔ یہ منتقلی نمبر شامل کریں ([منتقلی نمبر شامل کریں](/ur/guides/contact-centers/overview) اور [منتقلی پتے کے اندر ہیڈرز](/ur/guides/call-transfers) دیکھیں):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

پتے کو ایسے پتے سے تبدیل کریں جو واپس اس قطار یا فلو تک روٹ کرے جسے کالر وصول کرنا چاہیے؛ اس کی صورت Genesys سے تصدیق کریں۔ `REFER` اس طرح دکھائی دیتا ہے:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

**واپس لینا اور منتقل کرنا** فعال ہونے پر، Genesys ٹرنک سے کال واپس لے کر اسے اس پتے تک روٹ کرتا ہے۔ Genesys دستاویز کرتا ہے کہ آنے والی UUI `Call.UUIData` میں پہنچتی ہے؛ یہ واپس لینے کی صورت میں دستاویز نہیں کیا گیا، اس لیے Genesys سے، یا ایک آزمائشی کال پر، تصدیق کریں کہ کالر وصول کرنے والا فلو وہاں منتقلی ID تلاش کر لیتا ہے۔ خلاصہ اور ارادہ حاصل کرنے کے لیے، ویب سروسز ڈیٹا ایکشنز انضمام پر ایک **کال ڈیٹا ایکشن** کے ساتھ منتقلی تلاش اپ کو کال کریں:

- درخواست: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  جس کے بعد `Call.UUIData` سے ID ہو۔
- اسناد: آپ کی API کلید، جو `Authorization: Bearer sk_live_…` کے طور پر بھیجی جائے۔
- آؤٹ پٹ: `handoff.summary` اور `handoff.intent` کو فلو ویری ایبلز پر میپ کریں۔

[منتقل کی گئی کال تلاش کریں](/api-reference/calls#look-up-a-handed-off-call) دیکھیں۔

## اسے آزمائیں

ایسے نمبر پر کال کریں جو فلو تک پہنچتا ہو، ایجنٹ سے کسی شخص کے لیے کہیں، اور تصدیق کریں کہ
Genesys کال کو آپ کے مقرر کردہ پتے پر لے جاتا ہے۔ اس فلو میں، تصدیق کریں کہ
`Call.UUIData` میں ہینڈ آف id بطور متن موجود ہے (اگر اس میں hex ہندسے نظر آئیں تو چیک کریں کہ
trunk کی UUI encoding Hex ہے)۔ پھر `GET /v1/calls/{call_id}` کے ذریعے کال کھولیں:
`external_call_id` conversation id ہونا چاہیے۔

## حدود

- **SIP Headers حاصل کریں** ایکشن صرف ابتدائی `INVITE` پڑھتا ہے، اس لیے یہ
  ایجنٹ کے `REFER` سے کچھ نہیں پڑھ سکتا۔ ہینڈ آف صرف UUI کے ذریعے Genesys تک پہنچتا ہے۔
- جب کسی کال میں ایک سے زیادہ UUI header ہوں تو Genesys تمام UUI حذف کر دیتا ہے۔
- transfer address کو 254 حروف تک محدود رکھا جاتا ہے، اس لیے طویل UUI کو موزوں بنانے کے لیے کاٹ دیا جاتا ہے۔
  ہینڈ آف id ہمیشہ سما جاتا ہے۔
