---
title: "Genesys Cloudમાંથી કનેક્ટ કરો"
description: "Genesys Cloud કૉલ્સને conversation id અને UUI સાથે BYOC Cloud ટ્રંક મારફતે ThunderPhone એજન્ટને મોકલો અને UUIમાં હેન્ડ-ઓફ સાથે તેમને પાછા લો."
---

તમારો Architect ફ્લો કોલરને BYOC Cloud ટ્રંક મારફતે એજન્ટ પાસે મોકલે છે, જેમાં conversation id અને તમે સેટ કરેલ કોઈપણ UUI હોય છે. જ્યારે કોલરને વ્યક્તિની જરૂર પડે છે, ત્યારે એજન્ટ SIP `REFER` મોકલે છે, Genesys કોલ પાછો લે છે અને હેન્ડ-ઓફ id કોલના UUIમાં આવે છે.

## શરૂ કરતા પહેલાં

- ThunderPhone એજન્ટ અને સંસ્થાની [API key](/gu/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` વડે ટ્રાન્સફર કરે છે, જેમાં તે સરનામાની અંદર હેન્ડ-ઓફ id hex UUI તરીકે હોય છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
[ટ્રાન્સફર નંબર ઉમેરો](/gu/guides/contact-centers/overview)
અને [ટ્રાન્સફર સરનામાની અંદરના હેડર્સ](/gu/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 શોધે છે. સારાંશ અને ઇન્ટેન્ટ મેળવવા માટે, Web Services Data Actions ઇન્ટિગ્રેશનમાં **કોલ ડેટા ઍક્શન** દ્વારા હેન્ડ-ઓફ લુકઅપ કૉલ કરો:

- વિનંતી: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ત્યારબાદ `Call.UUIData`માંથી id.
- ઓળખપત્રો: તમારી API key, `Authorization: Bearer sk_live_…` તરીકે મોકલવામાં આવે છે.
- આઉટપુટ: `handoff.summary` અને `handoff.intent`ને ફ્લો વેરિએબલ્સ સાથે મેપ કરો.

જુઓ [હેન્ડ-ઓફ કરેલા કોલને શોધો](/api-reference/calls#look-up-a-handed-off-call).

## તેને ચકાસો

ફ્લો સુધી પહોંચતા નંબર પર કૉલ કરો, એજન્ટને કોઈ વ્યક્તિ માટે પૂછો અને Genesys કૉલને તમે સેટ કરેલા સરનામે લઈ જાય છે કે નહીં તે તપાસો. તે ફ્લોમાં, `Call.UUIData` હેન્ડ-ઓફ idને ટેક્સ્ટ તરીકે ધરાવે છે કે નહીં તે તપાસો (જો તે hex અંકો બતાવે, તો ટ્રંકનું UUI એન્કોડિંગ Hex છે કે નહીં તે તપાસો). પછી `GET /v1/calls/{call_id}` વડે કૉલ ખોલો:
`external_call_id` conversation id હોવી જોઈએ.

## મર્યાદાઓ

- **SIP હેડર્સ મેળવો** ક્રિયા ફક્ત પ્રારંભિક `INVITE` વાંચે છે, તેથી તે એજન્ટના `REFER`માંથી કંઈ વાંચી શકતી નથી. હેન્ડ-ઓફ માત્ર UUI મારફતે Genesys સુધી પહોંચે છે.
- જ્યારે કૉલમાં એકથી વધુ UUI હેડર હોય ત્યારે Genesys તમામ UUI કાઢી નાખે છે.
- ટ્રાન્સફર સરનામું 254 અક્ષરો સુધી રાખવામાં આવે છે, તેથી લાંબું UUI ફિટ કરવા માટે કાપવામાં આવે છે. હેન્ડ-ઓફ id હંમેશા ફિટ થાય છે.
