---
title: "Genesys Cloud-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക"
description: "conversation id, UUI എന്നിവ ഉപയോഗിച്ച് BYOC Cloud ട്രങ്കിലൂടെ Genesys Cloud കോളുകൾ ഒരു ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക. hand-off UUI-യിൽ ഉൾപ്പെടുത്തി അവ തിരിച്ചെടുക്കുക."
---

നിങ്ങളുടെ Architect ഫ്ലോ, നിങ്ങൾ സജ്ജമാക്കുന്ന conversation id യും ഏതെങ്കിലും UUI യും സഹിതം, ഒരു BYOC Cloud ട്രങ്കിലൂടെ കോളറെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. കോളർക്ക് ഒരു വ്യക്തിയുമായി സംസാരിക്കേണ്ടിവരുമ്പോൾ, ഏജന്റ് ഒരു SIP `REFER` അയയ്ക്കുന്നു, Genesys കോൾ തിരികെ എടുക്കുന്നു, കൈമാറ്റ ഐഡി കോളിന്റെ UUI-യിൽ എത്തുന്നു.

## ആരംഭിക്കുന്നതിന് മുമ്പ്

- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ [API കീ](/ml/guides/api-keys)യും.
- BYOC Cloud ഉള്ള Genesys Cloud, കൂടാതെ ഈ ക്രമീകരണങ്ങൾ ഓണാക്കിയിട്ടുള്ള ഒരു ബാഹ്യ ട്രങ്ക് (തരം BYOC Carrier അല്ലെങ്കിൽ PBX)
  ([ബാഹ്യ ട്രങ്ക് ക്രമീകരണങ്ങൾ](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Conversation Headers**, അതുവഴി Genesys അതിന്റെ conversation id `x-inin-cnv`-ൽ അയയ്ക്കും. ഇത് ഡിഫോൾട്ടായി ഓഫാണ്.
  - `User-To-User` എന്ന ഹെഡർ തരവും ഹെക്സ് എൻകോഡിംഗും ഉള്ള **UUI Passthrough**.
  - ഏജന്റിന്റെ `REFER` Genesys സ്വീകരിക്കുന്നതിനായി **Take Back and Transfer**.

## 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`. 128 അക്ഷരങ്ങളോ അതിൽ കുറവോ ഉപയോഗിക്കാൻ Genesys ശുപാർശ ചെയ്യുന്നു.
2. എൻഡ്‌പോയിന്റിന്റെ `sip_uri` ഉപയോഗിച്ച് ഒരു **നമ്പറിലേക്ക് ട്രാൻസ്ഫർ ചെയ്യുക** ആക്ഷൻ ചേർക്കുക, ഉദാഹരണത്തിന് `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys conversation id `x-inin-cnv`-ൽ അയയ്ക്കുന്നു. ThunderPhone അത് കോളിന്റെ `external_call_id` ആയി സംഭരിക്കുന്നു. UUI ഡീകോഡ് ചെയ്ത നിലയിൽ `{{sip_uui}}` ആയി prompt-ലെത്തും.

ട്രങ്ക് കസ്റ്റം ഹെഡറുകൾ Genesys-ൽ സ്റ്റാറ്റിക്കാണ്, അതിനാൽ ഓരോ കോളിലുമുള്ള മൂല്യങ്ങൾ UUI-യിൽ ചേർക്കുക. `x-inin`, `x-genesys`, `x-pcv`, `x-gcv` എന്നീ ഹെഡർ പ്രിഫിക്സുകൾ Genesys അതിനായി സംവരണം ചെയ്തിരിക്കുന്നു.

## 3. കോൾ തിരികെ നേടുക

ഏജന്റ് Genesys-ലെ ഒരു വിലാസത്തിലേക്ക് `REFER` ഉപയോഗിച്ച് ട്രാൻസ്ഫർ ചെയ്യുന്നു; ആ വിലാസത്തിനുള്ളിൽ ഹെക്സ് UUI ആയി കൈമാറ്റ ഐഡി ഉണ്ടാകും. ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക ([ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക](/ml/guides/contact-centers/overview), [ട്രാൻസ്ഫർ വിലാസത്തിനുള്ളിലെ ഹെഡറുകൾ](/ml/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>
```

**Take Back and Transfer** ഓണായിരിക്കുമ്പോൾ, Genesys ട്രങ്കിൽനിന്ന് കോൾ തിരികെ എടുത്ത് ആ വിലാസത്തിലേക്ക് റൂട്ട് ചെയ്യുന്നു. ഇൻകമിംഗ് UUI `Call.UUIData`-യിൽ എത്തുമെന്ന് Genesys രേഖപ്പെടുത്തുന്നു; തിരികെ എടുക്കലിന് ഇത് രേഖപ്പെടുത്തുന്നില്ല, അതിനാൽ കോളറെ സ്വീകരിക്കുന്ന ഫ്ലോ അവിടെ കൈമാറ്റ ഐഡി കണ്ടെത്തുന്നുവെന്ന് Genesys-നോടോ ഒരു ടെസ്റ്റ് കോളിലോ സ്ഥിരീകരിക്കുക. സംഗ്രഹവും ഉദ്ദേശ്യവും ലഭിക്കാൻ, Web Services Data Actions ഇന്റഗ്രേഷനിലെ ഒരു **കോൾ ഡാറ്റ ആക്ഷൻ** ഉപയോഗിച്ച് കൈമാറ്റ ലുക്കപ്പ് വിളിക്കുക:

- അഭ്യർത്ഥന: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  തുടർന്ന് `Call.UUIData`-യിൽനിന്നുള്ള ഐഡി.
- ക്രെഡൻഷ്യലുകൾ: `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` സംഭാഷണ ഐഡി ആയിരിക്കണം.

## പരിധികൾ

- **SIP ഹെഡറുകൾ നേടുക** പ്രവർത്തനം പ്രാരംഭ `INVITE` മാത്രമേ വായിക്കൂ, അതിനാൽ ഏജന്റിന്റെ `REFER`-ൽ നിന്ന് അതിന് ഒന്നും വായിക്കാൻ കഴിയില്ല. UUI വഴിയിലൂടെ മാത്രമാണ് കൈമാറ്റം Genesys-ലേക്ക് എത്തുന്നത്.
- ഒരു കോളിൽ ഒന്നിലധികം UUI ഹെഡറുകൾ ഉണ്ടെങ്കിൽ Genesys എല്ലാ UUI-യും ഒഴിവാക്കും.
- കൈമാറ്റ വിലാസം 254 പ്രതീകങ്ങളായി പരിമിതപ്പെടുത്തിയിരിക്കുന്നു, അതിനാൽ ദൈർഘ്യമേറിയ UUI അനുയോജ്യമാക്കാൻ വെട്ടിച്ചുരുക്കപ്പെടും. ഒരു കൈമാറ്റ ഐഡി എപ്പോഴും ഉൾക്കൊള്ളും.
