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

Contact centers

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 /16 atau lebih sempit (IPv6 /48 atau 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 mengembalikan 409.

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 header To. 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-RouteType dan X-RouteValue memberi tahu skrip ke mana harus mengirim penelepon, dalam hal ini ke skill Support. Nilai untuk X-RouteType yang didokumentasikan oleh penyedia lain mencakup SkillTransfer, PhoneTransfer, Hangup, dan DispositionOnly; sepakati nilainya dengan pihak yang memelihara skrip. Untuk beberapa tujuan, tambahkan satu return per tujuan dengan nama dan X-RouteValue yang berbeda.
  • X-RouteReason membawa label intent agen, seperti billing_dispute.
  • X-CustomMetaData membawa ID handoff. BYE juga membawanya sebagai X-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 BYE dan tidak menyebutkan penerimaan REFER, sehingga pengembalian dilakukan sebagai transfer dingin oleh skrip.
  • Five9 membaca X-RouteType, X-RouteValue, X-RouteReason, dan X-CustomMetaData, bukan User-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.