---
title: "Genesys Cloud నుండి కనెక్ట్ చేయండి"
description: "సంభాషణ ID మరియు UUIతో కూడిన Genesys Cloud కాల్‌లను BYOC Cloud ట్రంక్ ద్వారా ThunderPhone ఏజెంట్‌కు పంపి, UUIలోని హ్యాండ్-ఆఫ్‌తో వాటిని తిరిగి తీసుకురండి."
---

మీ Architect ఫ్లో కాలర్‌ను సంభాషణ ID మరియు మీరు సెట్ చేసిన ఏదైనా UUIతో పాటు BYOC Cloud ట్రంక్ ద్వారా ఏజెంట్‌కు పంపుతుంది. కాలర్‌కు వ్యక్తి అవసరమైనప్పుడు, ఏజెంట్ SIP `REFER`ను పంపుతుంది, Genesys కాల్‌ను తిరిగి తీసుకుంటుంది, మరియు హ్యాండ్-ఆఫ్ ID కాల్ యొక్క UUIలో చేరుతుంది.

## ప్రారంభించడానికి ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/guides/api-keys).
- BYOC Cloudతో కూడిన Genesys Cloud, మరియు ఈ సెట్టింగ్‌లు ఆన్ చేసి ఉన్న బాహ్య ట్రంక్ (రకం BYOC Carrier లేదా PBX)
  ([బాహ్య ట్రంక్ సెట్టింగ్‌లు](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **సంభాషణ హెడర్‌లు**, తద్వారా Genesys తన సంభాషణ IDని
    `x-inin-cnv`లో పంపుతుంది. ఇది డిఫాల్ట్‌గా ఆఫ్‌లో ఉంటుంది.
  - హెడర్ రకం `User-To-User` మరియు ఎన్‌కోడింగ్ Hexతో **UUI పాస్‌త్రూ**.
  - **తిరిగి తీసుకోవడం మరియు బదిలీ**, తద్వారా 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. ఐచ్ఛికంగా, `account=12345` వంటి ఏజెంట్ కోసం సందర్భంతో **UUI డేటాను సెట్ చేయండి** చర్యను జోడించండి. Genesys 128 అక్షరాలు లేదా అంతకంటే తక్కువ ఉండాలని సిఫార్సు చేస్తుంది.
2. ఉదాహరణకు `sip:agent-12-jhxmginwjx@sip.thunderphone.com` వంటి ఎండ్‌పాయింట్ యొక్క `sip_uri`తో **నంబర్‌కు బదిలీ చేయండి** చర్యను జోడించండి.

Genesys సంభాషణ IDని `x-inin-cnv`లో పంపుతుంది. ThunderPhone దాన్ని కాల్ యొక్క `external_call_id`గా నిల్వ చేస్తుంది. UUI డీకోడ్ చేయబడి, `{{sip_uui}}`గా promptకు చేరుతుంది.

ట్రంక్ కస్టమ్ హెడర్‌లు Genesysలో స్థిరంగా ఉంటాయి, కాబట్టి ప్రతి-కాల్ విలువలను UUIలో ఉంచండి. Genesys తన కోసం `x-inin`, `x-genesys`, `x-pcv` మరియు `x-gcv` హెడర్ ఉపసర్గలను కేటాయించుకుంటుంది.

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

ఏజెంట్ Genesysలోని చిరునామాకు `REFER`తో బదిలీ చేస్తుంది, ఆ చిరునామాలో హ్యాండ్-ఆఫ్ ID hex UUIగా ఉంటుంది. ఈ బదిలీ నంబర్‌ను జోడించండి ([బదిలీ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview)
మరియు [బదిలీ చిరునామాలోని హెడర్‌లు](/te/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 ట్రంక్ నుండి కాల్‌ను తిరిగి తీసుకుని ఆ చిరునామాకు రూట్ చేస్తుంది. ఇన్‌కమింగ్ UUI `Call.UUIData`లో చేరుతుందని Genesys డాక్యుమెంట్ చేస్తుంది; తిరిగి తీసుకునే సందర్భంలో దీన్ని డాక్యుమెంట్ చేయదు, కాబట్టి కాలర్‌ను స్వీకరించే ఫ్లో అక్కడ హ్యాండ్-ఆఫ్ IDని కనుగొంటుందో లేదో Genesysతో లేదా పరీక్షా కాల్‌లో నిర్ధారించండి. సారాంశం మరియు ఉద్దేశాన్ని పొందడానికి, వెబ్ సర్వీసెస్ డేటా చర్యల ఇంటిగ్రేషన్‌లో **కాల్ డేటా చర్య**తో హ్యాండ్-ఆఫ్ లుకప్‌ను కాల్ చేయండి:

- అభ్యర్థన: `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` హ్యాండ్-ఆఫ్ idని టెక్స్ట్‌గా కలిగి ఉందో చూడండి (అది హెక్స్ అంకెలను చూపితే, ట్రంక్ యొక్క UUI ఎన్‌కోడింగ్ Hexగా ఉందో తనిఖీ చేయండి). ఆపై `GET /v1/calls/{call_id}`తో కాల్‌ను తెరవండి:
`external_call_id` సంభాషణ id అయి ఉండాలి.

## పరిమితులు

- **Get SIP Headers** చర్య ప్రారంభ `INVITE`ను మాత్రమే చదువుతుంది, కాబట్టి ఏజెంట్ యొక్క `REFER` నుండి ఏదీ చదవలేదు. హ్యాండ్-ఆఫ్ UUI ద్వారా మాత్రమే Genesys‌కు చేరుతుంది.
- ఒక కాల్‌లో ఒకటి కంటే ఎక్కువ UUI హెడర్‌లు ఉన్నప్పుడు Genesys అన్ని UUIలను తొలగిస్తుంది.
- బదిలీ అడ్రస్‌ను 254 అక్షరాలకు పరిమితం చేస్తారు, కాబట్టి పొడవైన UUI సరిపోవడానికి కత్తిరించబడుతుంది. హ్యాండ్-ఆఫ్ id ఎల్లప్పుడూ సరిపోతుంది.
