Open in
Hubungkan dari Five9
Kirim panggilan Five9 ke agen ThunderPhone melalui SIP dengan AI Agent Connect, lalu terima kembali dengan header perutean yang dibaca skrip IVR Anda.
Skrip IVR Five9 Anda mengirim penelepon ke agen beserta detail panggilan
Five9. Setelah agen selesai, agen mengakhiri panggilan dengan header perutean pada SIP
BYE, yang dibaca skrip ke dalam variabel panggilan untuk merutekan penelepon.
Sebelum memulai
- Agen ThunderPhone dan kunci API organisasi.
- Add-on AI Agent Connect Five9. Five9 membatasinya pada penyedia AI yang telah diakreditasi, dan tim implementasi Five9 menyiapkannya: tim mengimpor template skrip IVR penyedia, membuat variabel panggilan, dan mengarahkan modul Transfer Pihak Ketiga skrip ke penyedia. ThunderPhone belum ada dalam daftar terakreditasi Five9: tanyakan kepada tim akun Five9 atau dukungan ThunderPhone sebelum Anda mengandalkannya dalam perencanaan.
1. Buat endpoint SIP
Modul Transfer Pihak Ketiga Five9 menghubungi nomor telepon, bukan alamat SIP,
dan integrasi Five9 dari penyedia lain mengautentikasi Five9 berdasarkan alamat
sumber, bukan kata sandi. Jadi, buat endpoint ip_allowlist dengan nomor yang
akan dihubungi Five9 sebagai nomor dial-in (lihat
Platform yang menghubungi nomor telepon):
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: rentang pensinyalan SIP pusat data Five9 Anda, dari Five9. Masing-masing harus berupa rentang IPv4 publik/16atau lebih sempit (IPv6/48atau lebih sempit).dial_in_numbers: nomor yang akan dihubungi skrip Five9, ditulis dengan cara Five9 mengirimkannya. Nomor ini tidak harus berupa nomor telepon nyata. Nomor ini tidak boleh sudah digunakan di ThunderPhone, sebagai nomor telepon atau pada endpoint lain: kondisi tersebut mengembalikan409.
Alamat Five9 digunakan bersama oleh semua pelanggannya, sehingga pelanggan Five9 lain yang menghubungi nomor tersebut akan tersambung ke agen Anda. Saat memilih nomor, pilih nomor panjang yang tidak akan ditebak siapa pun (hingga 15 digit), pastikan Five9 mengirimkannya ke ThunderPhone, bukan ke jaringan telepon, dan jangan publikasikan nomor tersebut.
2. Kirim panggilan dengan konteks
Minta tim implementasi Five9 untuk:
- Mengirim panggilan dari modul Transfer Pihak Ketiga ke
sip:+14155550188@sip.thunderphone.com, dengan nomor tersebut dalam URI permintaan dan headerTo. Modul ini menerima nomor tersebut, dengan domain SIP penyedia dalam header. - Mengirimkannya melalui TLS (port 5061) atau TCP (port 5060). Endpoint menolak UDP, dan Five9 tidak memublikasikan transport yang digunakannya, jadi pastikan transport tersebut bukan UDP.
- Mengaktifkan Kembali Setelah Panggilan Pihak Ketiga, agar skrip berlanjut saat agen mengakhiri panggilan (Five9 mengizinkan hingga 3.600 detik untuk panggilan pihak ketiga).
Panduan Five9 mencantumkan nilai yang dikirimnya (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name dan lainnya), bukan nama
headernya. Integrasi Five9 dari penyedia AI lain mendokumentasikannya dalam transmisi
sebagai X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
dan X-AgentID; periksa semuanya pada panggilan uji pertama Anda. Masing-masing masuk ke Prompt sebagai variabel, seperti
{{sip_x_callcampaign}}. X-CallID disimpan sebagai
external_call_id panggilan.
3. Kembalikan panggilan
Agen mengembalikan panggilan: agen mengucapkan selamat tinggal dan menutup panggilan, lalu BYE membawa
empat header yang dibaca skrip Five9. Tambahkan nomor transfer ini (lihat
Tambahkan nomor transfer):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypedanX-RouteValuememberi tahu skrip ke mana harus mengirim penelepon, dalam hal ini ke skill Support. Nilai untukX-RouteTypeyang didokumentasikan oleh penyedia lain mencakupSkillTransfer,PhoneTransfer,Hangup, danDispositionOnly; sepakati nilainya dengan pihak yang memelihara skrip. Untuk beberapa tujuan, tambahkan satu return per tujuan dengan nama danX-RouteValueyang berbeda.X-RouteReasonmembawa label intent agen, sepertibilling_dispute.X-CustomMetaDatamembawa ID handoff.BYEjuga membawanya sebagaiX-TP-Handoff-Id, yang tidak dibaca oleh Five9.
Skrip Five9 memetakan keempat header ke dalam variabel panggilan. Untuk ringkasan
agen, minta skrip memanggil pencarian handoff dengan modul IVR Kueri:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= diikuti oleh
call.call_id, dengan Profil Otorisasi yang mengirimkan
Authorization: Bearer dan kunci API Anda. Lihat
Cari panggilan yang dialihkan.
Uji
Hubungi skrip IVR, minta agen menghubungkan Anda ke seseorang, lalu periksa bahwa skrip
merutekan penelepon dengan variabel panggilan terisi. Jika panggilan tidak pernah sampai ke
agen, periksa bahwa nomor dalam URI permintaan dan header To cocok dengan
nomor dial-in, bahwa alamat sumber Five9 ada dalam allowed_source_cidrs, dan
bahwa panggilan datang melalui TCP atau TLS. Kemudian buka panggilan dengan
GET /v1/calls/{call_id}: sip_headers harus mencantumkan x-callid, dan
external_call_id harus cocok dengan call.call_id di Five9.
Batasan
- Panduan Five9 mendokumentasikan data perutean pada
BYEdan tidak menyebutkan penerimaanREFER, sehingga pengembalian dilakukan sebagai transfer dingin oleh skrip. - Five9 membaca
X-RouteType,X-RouteValue,X-RouteReason, danX-CustomMetaData, bukanUser-to-User. ThunderPhone mengirim setiap nilai header dengan panjang maksimal 256 byte. - Five9 merekomendasikan untuk membatasi header kustom hingga sekitar sepuluh agar menghindari fragmentasi paket.