---
title: "Genesys Cloud இலிருந்து இணைக்கவும்"
description: "உரையாடல் id மற்றும் UUI உடன் BYOC Cloud trunk வழியாக Genesys Cloud அழைப்புகளை ThunderPhone ஏஜென்ட்டுக்கு அனுப்பி, UUI-யில் hand-off உடன் அவற்றை மீண்டும் பெறுங்கள்."
---

உங்கள் Architect ஃப்ளோ, நீங்கள் அமைக்கும் உரையாடல் ஐடி மற்றும் எந்த UUI-யுடனும், அழைப்பாளரை BYOC Cloud டிரங்க் வழியாக ஏஜென்ட்டுக்கு அனுப்புகிறது. அழைப்பாளருக்கு ஒரு நபர் தேவைப்படும்போது, ஏஜென்ட் ஒரு SIP `REFER` அனுப்புகிறது, Genesys அழைப்பைத் திரும்பப் பெறுகிறது, மேலும் கையளிப்பு ஐடி அழைப்பின் UUI-யில் வருகிறது.

## தொடங்குவதற்கு முன்

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு அமைப்பு [API விசை](/ta/guides/api-keys).
- BYOC Cloud கொண்ட Genesys Cloud மற்றும் பின்வரும் அமைப்புகள் இயக்கப்பட்ட வெளிப்புற டிரங்க் (வகை BYOC Carrier அல்லது PBX)
  ([வெளிப்புற டிரங்க் அமைப்புகள்](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **உரையாடல் ஹெடர்கள்**, இதனால் Genesys தனது உரையாடல் ஐடியை
    `x-inin-cnv`-இல் அனுப்பும். இது இயல்பாக முடக்கப்பட்டிருக்கும்.
  - ஹெடர் வகை `User-To-User` மற்றும் ஹெக்ஸ் குறியாக்கத்துடன் **UUI கடத்தல்**.
  - ஏஜென்ட்டின் `REFER`-ஐ Genesys ஏற்கும் வகையில் **திரும்பப் பெறுதல் மற்றும் மாற்றல்**.

## 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 தரவை அமை** செயலைச் சேர்க்கவும். 128 அல்லது அதற்குக் குறைவான எழுத்துகளைப் பயன்படுத்த Genesys பரிந்துரைக்கிறது.
2. எண்ட்பாயிண்ட்டின் `sip_uri`-யுடன், உதாரணமாக `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, ஒரு **எண்ணுக்கு மாற்று** செயலைச் சேர்க்கவும்.

Genesys உரையாடல் ஐடியை `x-inin-cnv`-இல் அனுப்புகிறது. ThunderPhone அதை அழைப்பின் `external_call_id` ஆகச் சேமிக்கிறது. UUI, டிகோட் செய்யப்பட்ட நிலையில், `{{sip_uui}}` ஆக prompt-ஐ அடைகிறது.

டிரங்க் தனிப்பயன் ஹெடர்கள் Genesys-இல் நிலையானவை; எனவே ஒவ்வொரு அழைப்பிற்குமான மதிப்புகளை UUI-யில் வைக்கவும். `x-inin`, `x-genesys`, `x-pcv`, மற்றும் `x-gcv` ஹெடர் முன்னொட்டுகளை Genesys தனக்காக ஒதுக்கியுள்ளது.

## 3. அழைப்பைத் திரும்பப் பெறவும்

ஏஜென்ட், அந்த முகவரிக்குள் ஹெக்ஸ் UUI ஆக கையளிப்பு ஐடியுடன், Genesys-இலுள்ள ஒரு முகவரிக்கு `REFER` மூலம் மாற்றுகிறது. இந்த மாற்றல் எண்ணைச் சேர்க்கவும் ([மாற்றல் எண்ணைச் சேர்க்கவும்](/ta/guides/contact-centers/overview)
மற்றும் [மாற்றல் முகவரிக்குள் உள்ள ஹெடர்கள்](/ta/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 ஆவணப்படுத்துகிறது; திரும்பப் பெறுதலுக்காக இதை ஆவணப்படுத்தவில்லை. எனவே, அழைப்பாளரைப் பெறும் ஃப்ளோ அங்கு கையளிப்பு ஐடியைக் கண்டுபிடிக்கிறதா என்பதை 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` ஹேண்ட்-ஆஃப் id-ஐ உரையாக வைத்திருக்கிறதா என்பதைச் சரிபார்க்கவும் (அது hex இலக்கங்களைக் காட்டினால், டிரங்கின் UUI குறியாக்கம் Hex ஆக உள்ளதா என்பதைச் சரிபார்க்கவும்). பின்னர் `GET /v1/calls/{call_id}` மூலம் அழைப்பைத் திறக்கவும்:
`external_call_id` உரையாடல் id ஆக இருக்க வேண்டும்.

## வரம்புகள்

- **SIP தலைப்புகளைப் பெறு** செயல் ஆரம்ப `INVITE`-ஐ மட்டும் படிக்கும்; எனவே ஏஜென்டின் `REFER`-இலிருந்து எதையும் படிக்க முடியாது. ஹேண்ட்-ஆஃப் UUI மூலம் மட்டுமே Genesys-ஐ அடையும்.
- ஒரு அழைப்பில் ஒன்றுக்கு மேற்பட்ட UUI தலைப்புகள் இருந்தால் Genesys அனைத்து UUI-யையும் நீக்கிவிடும்.
- பரிமாற்ற முகவரி 254 எழுத்துகளுக்கு மட்டுமே வைக்கப்படுகிறது; எனவே நீண்ட UUI பொருந்தும் வகையில் வெட்டப்படும்.
  ஹேண்ட்-ஆஃப் id எப்போதும் பொருந்தும்.
