---
title: "Hubungkan dari Genesys Cloud"
description: "Kirim panggilan Genesys Cloud ke agen ThunderPhone melalui trunk BYOC Cloud dengan ID percakapan dan UUI, lalu terima kembali dengan hand-off di UUI."
---

Alur Architect Anda mengirim penelepon ke agen melalui trunk BYOC Cloud, dengan ID percakapan dan UUI apa pun yang Anda tetapkan. Saat penelepon memerlukan seseorang, agen mengirim SIP `REFER`, Genesys mengambil kembali panggilan, dan ID handoff tiba dalam UUI panggilan.

## Sebelum memulai

- Agen ThunderPhone dan [kunci API](/id/guides/api-keys) organisasi.
- Genesys Cloud dengan BYOC Cloud, serta trunk eksternal (jenis BYOC Carrier atau
  PBX) dengan pengaturan berikut diaktifkan
  ([pengaturan trunk eksternal](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Header Percakapan**, agar Genesys mengirim ID percakapannya dalam
    `x-inin-cnv`. Pengaturan ini dinonaktifkan secara default.
  - **Penerusan UUI**, dengan jenis header `User-To-User` dan pengodean Hex.
  - **Pengambilan Kembali dan Transfer**, agar Genesys menerima `REFER` dari agen.

## 1. Buat endpoint SIP

Genesys menjawab tantangan digest, jadi gunakan endpoint standar:

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

Simpan `password` dari respons segera; nilai ini hanya ditampilkan sekali. Pada
trunk:

| Pengaturan | Nilai |
|---|---|
| Server SIP | `sip.thunderphone.com`, port `5061` |
| Protokol | TLS |
| Autentikasi digest | `username` dan `password` endpoint |
| Codec | PCMU, PCMA, atau G.722 |

Tempatkan trunk pada rute keluar situs Anda yang rencana nomornya mencakup
alamat yang dipanggil oleh alur.

## 2. Kirim panggilan dengan konteks

Dalam alur Architect Anda:

1. Secara opsional, tambahkan tindakan **Atur Data UUI** dengan konteks untuk agen, seperti
   `account=12345`. Genesys merekomendasikan 128 karakter atau kurang.
2. Tambahkan tindakan **Transfer ke Nomor** dengan `sip_uri` endpoint, misalnya
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys mengirim ID percakapan dalam `x-inin-cnv`. ThunderPhone menyimpannya sebagai
`external_call_id` panggilan. UUI mencapai Prompt dalam keadaan didekode, sebagai
`{{sip_uui}}`.

Header kustom trunk bersifat statis di Genesys, jadi masukkan nilai per panggilan dalam UUI.
Genesys mencadangkan prefiks header `x-inin`, `x-genesys`, `x-pcv`, dan `x-gcv`
untuk dirinya sendiri.

## 3. Ambil kembali panggilan

Agen mentransfer dengan `REFER` ke alamat di Genesys, dengan ID handoff sebagai UUI heksadesimal di dalam alamat tersebut. Tambahkan nomor transfer ini (lihat
[Tambahkan nomor transfer](/id/guides/contact-centers/overview)
dan [Header di dalam alamat transfer](/id/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"
}
```

Ganti alamat tersebut dengan alamat yang merutekan kembali ke antrean atau alur yang harus
menangani penelepon; konfirmasikan formatnya dengan Genesys. `REFER` terlihat seperti ini:

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

Dengan **Pengambilan Kembali dan Transfer** diaktifkan, Genesys mengambil kembali panggilan dari trunk
dan merutekannya ke alamat tersebut. Genesys mendokumentasikan bahwa UUI masuk berada di
`Call.UUIData`; Genesys tidak mendokumentasikan ini untuk pengambilan kembali, jadi konfirmasikan dengan
Genesys, atau pada panggilan pengujian, bahwa alur yang menerima penelepon menemukan
ID handoff di sana. Untuk mendapatkan ringkasan dan intent, panggil pencarian handoff dengan
**Aksi Data Panggilan** pada integrasi Web Services Data Actions:

- Permintaan: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  diikuti oleh ID dari `Call.UUIData`.
- Kredensial: kunci API Anda, dikirim sebagai `Authorization: Bearer sk_live_…`.
- Output: petakan `handoff.summary` dan `handoff.intent` ke variabel alur.

Lihat [Cari panggilan yang dihandoff](/api-reference/calls#look-up-a-handed-off-call).

## Uji coba

Hubungi nomor yang mencapai flow, minta agen untuk menghubungkan Anda ke seseorang, lalu periksa bahwa
Genesys meneruskan panggilan ke alamat yang Anda tetapkan. Dalam flow tersebut, periksa bahwa
`Call.UUIData` menyimpan ID hand-off sebagai teks (jika menampilkan digit heksadesimal, periksa apakah encoding UUI trunk adalah Hex). Kemudian buka panggilan dengan `GET /v1/calls/{call_id}`:
`external_call_id` harus berupa ID percakapan.

## Batasan

- Tindakan **Dapatkan Header SIP** hanya membaca `INVITE` awal, sehingga tidak dapat
  membaca apa pun dari `REFER` agen. Hand-off mencapai Genesys hanya
  melalui UUI.
- Genesys menghapus semua UUI ketika panggilan membawa lebih dari satu header UUI.
- Alamat transfer dibatasi hingga 254 karakter, sehingga UUI yang panjang dipotong agar sesuai.
  ID hand-off selalu muat.
