ThunderPhone v3 kini tersedia.Gunakan langsung secara mandiri, mulai 2¢/menit.Baca pengumumannya

Contact centers

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-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:

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:

PengaturanNilai
Server SIPsip.thunderphone.com, port 5061
ProtokolTLS
Autentikasi digestusername dan password endpoint
CodecPCMU, 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 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 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.

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.