---
title: "Genesys Cloud ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "Genesys Cloud ਕਾਲਾਂ ਨੂੰ conversation id ਅਤੇ UUI ਸਮੇਤ BYOC Cloud trunk ਰਾਹੀਂ ThunderPhone ਏਜੰਟ ਕੋਲ ਭੇਜੋ, ਅਤੇ UUI ਵਿੱਚ hand-off ਨਾਲ ਉਹਨਾਂ ਨੂੰ ਵਾਪਸ ਲਵੋ।"
---

ਤੁਹਾਡਾ Architect ਫਲੋ ਕਾਲਰ ਨੂੰ ਕਨਵਰਸੇਸ਼ਨ id ਅਤੇ ਤੁਹਾਡੇ ਵੱਲੋਂ ਸੈੱਟ ਕੀਤੇ ਕਿਸੇ ਵੀ UUI ਸਮੇਤ BYOC Cloud ਟਰੰਕ ਰਾਹੀਂ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਕਾਲਰ ਨੂੰ ਕਿਸੇ ਵਿਅਕਤੀ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਏਜੰਟ ਇੱਕ SIP `REFER` ਭੇਜਦਾ ਹੈ, Genesys ਕਾਲ ਵਾਪਸ ਲੈ ਲੈਂਦਾ ਹੈ, ਅਤੇ ਹੈਂਡ-ਆਫ਼ id ਕਾਲ ਦੇ UUI ਵਿੱਚ ਪਹੁੰਚਦੀ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ ਦੀ [API ਕੁੰਜੀ](/pa/guides/api-keys)।
- BYOC Cloud ਵਾਲਾ Genesys Cloud, ਅਤੇ ਇੱਕ ਬਾਹਰੀ ਟਰੰਕ (ਕਿਸਮ BYOC Carrier ਜਾਂ
  PBX) ਜਿਸ ਵਿੱਚ ਇਹ ਸੈਟਿੰਗਾਂ ਚਾਲੂ ਹੋਣ
  ([ਬਾਹਰੀ ਟਰੰਕ ਸੈਟਿੰਗਾਂ](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **ਕਨਵਰਸੇਸ਼ਨ ਹੈਡਰਜ਼**, ਤਾਂ ਜੋ Genesys ਆਪਣੀ ਕਨਵਰਸੇਸ਼ਨ id
    `x-inin-cnv` ਵਿੱਚ ਭੇਜੇ। ਇਹ ਮੂਲ ਰੂਪ ਵਿੱਚ ਬੰਦ ਹੁੰਦੀ ਹੈ।
  - **UUI ਪਾਸਥਰੂ**, ਹੈਡਰ ਕਿਸਮ `User-To-User` ਅਤੇ ਹੈਕਸ ਏਨਕੋਡਿੰਗ ਨਾਲ।
  - **ਟੇਕ ਬੈਕ ਐਂਡ ਟ੍ਰਾਂਸਫ਼ਰ**, ਤਾਂ ਜੋ 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. ਵਿਕਲਪਕ ਤੌਰ 'ਤੇ, ਏਜੰਟ ਲਈ ਸੰਦਰਭ ਦੇ ਨਾਲ ਇੱਕ **UUI ਡਾਟਾ ਸੈੱਟ ਕਰੋ** ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ, ਜਿਵੇਂ ਕਿ `account=12345`। Genesys 128 ਜਾਂ ਇਸ ਤੋਂ ਘੱਟ ਅੱਖਰਾਂ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕਰਦਾ ਹੈ।
2. ਐਂਡਪੌਇੰਟ ਦੇ `sip_uri` ਨਾਲ ਇੱਕ **ਨੰਬਰ 'ਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਕਰੋ** ਐਕਸ਼ਨ ਸ਼ਾਮਲ ਕਰੋ, ਉਦਾਹਰਨ ਲਈ `sip:agent-12-jhxmginwjx@sip.thunderphone.com`।

Genesys ਕਨਵਰਸੇਸ਼ਨ 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 ਹੈਕਸ UUI ਵਜੋਂ ਹੁੰਦੀ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ ([ਟ੍ਰਾਂਸਫ਼ਰ ਨੰਬਰ ਸ਼ਾਮਲ ਕਰੋ](/pa/guides/contact-centers/overview)
ਅਤੇ [ਟ੍ਰਾਂਸਫ਼ਰ ਪਤੇ ਦੇ ਅੰਦਰ ਹੈਡਰਜ਼](/pa/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 ਕੁੰਜੀ, ਜੋ `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 ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ।

## ਸੀਮਾਵਾਂ

- **Get SIP Headers** ਕਾਰਵਾਈ ਸਿਰਫ਼ ਸ਼ੁਰੂਆਤੀ `INVITE` ਨੂੰ ਪੜ੍ਹਦੀ ਹੈ, ਇਸ ਲਈ ਇਹ
  ਏਜੰਟ ਦੇ `REFER` ਤੋਂ ਕੁਝ ਵੀ ਨਹੀਂ ਪੜ੍ਹ ਸਕਦੀ। ਹੈਂਡ-ਆਫ਼ ਸਿਰਫ਼ UUI ਰਾਹੀਂ Genesys ਤੱਕ ਪਹੁੰਚਦਾ ਹੈ।
- ਜਦੋਂ ਕਾਲ ਵਿੱਚ ਇੱਕ ਤੋਂ ਵੱਧ UUI ਹੈਡਰ ਹੁੰਦੇ ਹਨ, Genesys ਸਾਰਾ UUI ਹਟਾ ਦਿੰਦਾ ਹੈ।
- ਟ੍ਰਾਂਸਫ਼ਰ ਪਤਾ 254 ਅੱਖਰਾਂ ਤੱਕ ਰੱਖਿਆ ਜਾਂਦਾ ਹੈ, ਇਸ ਲਈ ਲੰਬੇ UUI ਨੂੰ ਫਿੱਟ ਕਰਨ ਲਈ ਕੱਟ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ।
  ਹੈਂਡ-ਆਫ਼ id ਹਮੇਸ਼ਾਂ ਫਿੱਟ ਹੋ ਜਾਂਦੀ ਹੈ।
