Open in
Hubungkan dari Genesys Cloud
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 organisasi.
- Genesys Cloud dengan BYOC Cloud, serta trunk eksternal (jenis BYOC Carrier atau
PBX) dengan pengaturan berikut diaktifkan
(pengaturan trunk eksternal):
- Header Percakapan, agar Genesys mengirim ID percakapannya dalam
x-inin-cnv. Pengaturan ini dinonaktifkan secara default. - Penerusan UUI, dengan jenis header
User-To-Userdan pengodean Hex. - Pengambilan Kembali dan Transfer, agar Genesys menerima
REFERdari agen.
- Header Percakapan, agar Genesys mengirim ID percakapannya dalam
1. Buat endpoint SIP
Genesys menjawab tantangan digest, jadi gunakan endpoint standar:
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:
- Secara opsional, tambahkan tindakan Atur Data UUI dengan konteks untuk agen, seperti
account=12345. Genesys merekomendasikan 128 karakter atau kurang. - Tambahkan tindakan Transfer ke Nomor dengan
sip_uriendpoint, misalnyasip: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
dan Header di dalam alamat transfer):
{
"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 dariCall.UUIData. - Kredensial: kunci API Anda, dikirim sebagai
Authorization: Bearer sk_live_…. - Output: petakan
handoff.summarydanhandoff.intentke variabel alur.
Lihat Cari panggilan yang dihandoff.
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
INVITEawal, sehingga tidak dapat membaca apa pun dariREFERagen. 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.