---
title: "Genesys Cloud'dan bağlanın"
description: "Genesys Cloud çağrılarını, görüşme kimliği ve UUI ile bir BYOC Cloud trunk üzerinden ThunderPhone ajanına gönderin ve aktarma bilgisi UUI içinde olacak şekilde geri alın."
---

Architect akışınız, konuşma kimliği ve ayarladığınız tüm UUI verileriyle birlikte arayanı BYOC Cloud trunk üzerinden yapay zeka ajanına gönderir. Arayanın bir insana ihtiyacı olduğunda yapay zeka ajanı bir SIP `REFER` gönderir, Genesys çağrıyı geri alır ve aktarma kimliği çağrının UUI verilerinde gelir.

## Başlamadan önce

- Bir ThunderPhone ajanı ve bir kuruluş [API anahtarı](/tr/guides/api-keys).
- BYOC Cloud içeren Genesys Cloud ve şu ayarların etkin olduğu harici bir trunk (BYOC Carrier veya PBX türünde)
  ([harici trunk ayarları](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - Genesys'in konuşma kimliğini `x-inin-cnv` içinde göndermesi için **Conversation Headers**. Varsayılan olarak kapalıdır.
  - `User-To-User` başlık türü ve Hex kodlamasıyla **UUI Passthrough**.
  - Genesys'in yapay zeka ajanının `REFER` isteğini kabul etmesi için **Take Back and Transfer**.

## 1. SIP uç noktası oluşturun

Genesys bir digest doğrulama isteğine yanıt verir; bu nedenle standart bir uç nokta kullanın:

```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"}'
```

Yanıttaki `password` değerini hemen saklayın; yalnızca bir kez gösterilir. Trunk üzerinde:

| Ayar | Değer |
|---|---|
| SIP sunucusu | `sip.thunderphone.com`, bağlantı noktası `5061` |
| Protokol | TLS |
| Digest kimlik doğrulama | uç noktanın `username` ve `password` değerleri |
| Codec'ler | PCMU, PCMA veya G.722 |

Trunk'ı, numara planı akışın çevirdiği adresi kapsayan sitenizin giden yönlendirmesine ekleyin.

## 2. Çağrıları bağlamla gönderin

Architect akışınızda:

1. İsteğe bağlı olarak, yapay zeka ajanına `account=12345` gibi bağlam sağlamak için bir **UUI Verisi Ayarla** eylemi ekleyin. Genesys 128 veya daha az karakter önerir.
2. Örneğin `sip:agent-12-jhxmginwjx@sip.thunderphone.com` gibi, uç noktanın `sip_uri` değeriyle bir **Numaraya Aktar** eylemi ekleyin.

Genesys konuşma kimliğini `x-inin-cnv` içinde gönderir. ThunderPhone bunu çağrının `external_call_id` değeri olarak saklar. UUI verileri isteme kodu çözülmüş olarak `{{sip_uui}}` şeklinde ulaşır.

Trunk özel başlıkları Genesys'te statiktir; bu nedenle çağrı başına değerleri UUI verilerine koyun. Genesys `x-inin`, `x-genesys`, `x-pcv` ve `x-gcv` başlık öneklerini kendi kullanımı için ayırır.

## 3. Çağrıyı geri alın

Yapay zeka ajanı, aktarma kimliği bu adresin içinde hex UUI olarak yer alacak şekilde Genesys üzerindeki bir adrese `REFER` ile aktarır. Bu aktarma numarasını ekleyin ([Aktarma numarasını ekleyin](/tr/guides/contact-centers/overview) ve [Aktarma adresindeki başlıklar](/tr/guides/call-transfers) bölümlerine bakın):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Adresi, arayanı alması gereken kuyruğa veya akışa geri yönlendiren bir adresle değiştirin; biçimini Genesys ile doğrulayın. `REFER` şöyle görünür:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

**Take Back and Transfer** etkin olduğunda Genesys çağrıyı trunk'tan geri alır ve bu adrese yönlendirir. Genesys, gelen UUI verilerinin `Call.UUIData` alanına geldiğini belgeler; bunu geri alma işlemi için belgelemez. Bu nedenle Genesys ile veya bir test çağrısında, arayanı alan akışın aktarma kimliğini burada bulduğunu doğrulayın. Özeti ve amacı almak için Web Services Data Actions entegrasyonunda bir **Çağrı Verisi Eylemi** ile aktarma aramasını çağırın:

- İstek: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ardından `Call.UUIData` içindeki kimlik.
- Kimlik bilgileri: `Authorization: Bearer sk_live_…` olarak gönderilen API anahtarınız.
- Çıktı: `handoff.summary` ve `handoff.intent` değerlerini akış değişkenlerine eşleyin.

[Bir aktarılmış çağrıyı arayın](/api-reference/calls#look-up-a-handed-off-call) bölümüne bakın.

## Test edin

Akışa ulaşan bir numarayı arayın, ajandan bir insan isteyin ve Genesys'in
aramayı ayarladığınız adrese götürdüğünü doğrulayın. Bu akışta,
`Call.UUIData` alanının aktarım kimliğini metin olarak içerdiğini doğrulayın
(onaltılık basamaklar gösteriyorsa trunk'ın UUI kodlamasının Hex olduğunu
kontrol edin). Ardından çağrıyı `GET /v1/calls/{call_id}` ile açın:
`external_call_id`, konuşma kimliği olmalıdır.

## Sınırlar

- **Get SIP Headers** eylemi yalnızca ilk `INVITE` isteğini okur; bu nedenle
  ajanın `REFER` isteğinden hiçbir şey okuyamaz. Aktarım Genesys'e yalnızca
  UUI üzerinden ulaşır.
- Genesys, bir çağrı birden fazla UUI üst bilgisi taşıdığında tüm UUI verilerini
  bırakır.
- Aktarım adresi 254 karakterle sınırlıdır; bu nedenle uzun bir UUI sığacak
  şekilde kesilir. Aktarım kimliği her zaman sığar.
