---
title: "Genesys Cloud वरून कनेक्ट करा"
description: "संवाद आयडी आणि UUI सह BYOC Cloud ट्रंकद्वारे Genesys Cloud कॉल ThunderPhone एजंटकडे पाठवा आणि UUI मधील हँड-ऑफसह ते परत घ्या."
---

तुमचा Architect फ्लो कॉलरला BYOC Cloud ट्रंकवरून एजंटकडे पाठवतो, तसेच
conversation id आणि तुम्ही सेट केलेला कोणताही UUI पाठवतो. कॉलरला व्यक्तीची गरज
भासल्यावर, एजंट SIP `REFER` पाठवतो, Genesys कॉल परत घेते आणि hand-off id
कॉलच्या UUI मध्ये येतो.

## सुरू करण्यापूर्वी

- ThunderPhone एजंट आणि संस्थेची [API की](/mr/guides/api-keys).
- BYOC Cloud असलेले Genesys Cloud आणि खालील सेटिंग्ज चालू असलेला बाह्य ट्रंक
  (प्रकार BYOC Carrier किंवा PBX)
  ([बाह्य ट्रंक सेटिंग्ज](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **संभाषण हेडर्स**, जेणेकरून Genesys त्याचा conversation id
    `x-inin-cnv` मध्ये पाठवेल. हे डीफॉल्टनुसार बंद असते.
  - हेडर प्रकार `User-To-User` आणि Hex एन्कोडिंगसह **UUI पासथ्रू**.
  - **टेक बॅक आणि ट्रान्सफर**, जेणेकरून Genesys एजंटचा `REFER` स्वीकारेल.

## 1. SIP एंडपॉइंट तयार करा

Genesys digest challenge ला उत्तर देते, म्हणून मानक एंडपॉइंट वापरा:

```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 |
| Digest प्रमाणीकरण | एंडपॉइंटचा `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 conversation 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` सह ट्रान्सफर करतो, ज्यामध्ये त्या
पत्त्यात hex UUI म्हणून hand-off id असतो. हा ट्रान्सफर क्रमांक जोडा (पहा
[ट्रान्सफर क्रमांक जोडा](/mr/guides/contact-centers/overview)
आणि [ट्रान्सफर पत्त्यामधील हेडर्स](/mr/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"
}
```

कॉलरकडे जाणाऱ्या queue किंवा फ्लोकडे परत रूट होणारा पत्ता याच्या जागी वापरा;
त्याचे स्वरूप Genesys कडे पुष्टी करा. `REFER` असे दिसते:

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

**टेक बॅक आणि ट्रान्सफर** चालू असल्यास, Genesys ट्रंककडून कॉल परत घेते आणि त्या
पत्त्यावर रूट करते. Genesys दस्तऐवजीकरणानुसार येणारा UUI `Call.UUIData` मध्ये
येतो; टेक-बॅकसाठी ते याचे दस्तऐवजीकरण करत नाही, म्हणून Genesys कडे किंवा चाचणी
कॉलवर पुष्टी करा की कॉलर स्वीकारणाऱ्या फ्लोला तिथे hand-off id सापडतो. सारांश
आणि हेतू मिळवण्यासाठी, Web Services Data Actions इंटिग्रेशनवरील **कॉल डेटा
कृती** वापरून hand-off lookup कॉल करा:

- विनंती: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  यानंतर `Call.UUIData` मधील id.
- क्रेडेन्शियल्स: `Authorization: Bearer sk_live_…` म्हणून पाठवलेली तुमची API की.
- आउटपुट: `handoff.summary` आणि `handoff.intent` यांना फ्लो व्हेरिएबल्सशी मॅप करा.

पहा [हँड-ऑफ केलेला कॉल शोधा](/api-reference/calls#look-up-a-handed-off-call).

## चाचणी करा

फ्लोपर्यंत पोहोचणाऱ्या नंबरवर कॉल करा, एजंटकडे एखाद्या व्यक्तीची विनंती करा आणि
Genesys ने कॉल तुम्ही सेट केलेल्या पत्त्यावर नेला आहे का ते तपासा. त्या फ्लोमध्ये,
`Call.UUIData` मध्ये हँड-ऑफ आयडी मजकूर म्हणून आहे का ते तपासा (त्यात हेक्स अंक दिसत असल्यास, ट्रंकचे UUI एन्कोडिंग Hex आहे का ते तपासा). त्यानंतर `GET /v1/calls/{call_id}` सह कॉल उघडा:
`external_call_id` हा संभाषण आयडी असावा.

## मर्यादा

- **Get SIP Headers** क्रिया फक्त सुरुवातीचा `INVITE` वाचते, त्यामुळे ती
  एजंटच्या `REFER` मधून काहीही वाचू शकत नाही. हँड-ऑफ Genesys पर्यंत फक्त UUI द्वारे पोहोचतो.
- कॉलमध्ये एकापेक्षा जास्त UUI हेडर असल्यास Genesys सर्व UUI वगळते.
- ट्रान्सफर पत्ता 254 वर्णांपर्यंत मर्यादित ठेवला जातो, त्यामुळे लांब UUI बसण्यासाठी कापला जातो.
  हँड-ऑफ आयडी नेहमी बसतो.
