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

Contact centers

Hubungkan dari Talkdesk

Kirim panggilan Talkdesk ke agen ThunderPhone dengan Connect to Autopilot Voice, lalu eskalasikan kembali dengan ID hand-off di UUI.

Alur Talkdesk Studio Anda mengirim penelepon ke agen dengan ID interaksi dan UUI. Saat penelepon memerlukan seseorang, agen melakukan eskalasi dengan SIP REFER ke Talkdesk, dan ID pengalihan masuk ke dalam variabel Studio.

Sebelum memulai

  • Agen ThunderPhone dan kunci API organisasi.
  • Lisensi Talkdesk Conversation Orchestrator, yang mencakup komponen Studio Hubungkan ke Autopilot Voice dalam mode Aliran Suara Eksternal (artikel Talkdesk). Talkdesk menagihnya per menit selama agen mempertahankan panggilan.

1. Buat endpoint SIP

Talkdesk hanya mendokumentasikan daftar izin IP, jadi buat endpoint yang menerima panggilan berdasarkan alamat sumber:

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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'

Artikel Talkdesk menyatakan bahwa audio dikirim melalui SRTP, dan "srtp": "optional" menjawab dengan SRTP saat Talkdesk menawarkannya. Artikel tersebut tidak menjelaskan apakah Talkdesk memerlukan SRTP; jika Talkdesk memberi tahu Anda bahwa SRTP diperlukan, atur srtp ke required, yang menolak panggilan tanpa SRTP.

Dapatkan rentang pensinyalan SIP Talkdesk dari Talkdesk. Setiap rentang harus berupa rentang IPv4 publik /16 atau lebih sempit (IPv6 /48 atau lebih sempit). Lihat Platform yang mengautentikasi berdasarkan IP sumber. Talkdesk mengirim SIP dari jaringan Twilio, yang alamatnya digunakan bersama oleh setiap pelanggan Twilio, jadi alamat endpoint inilah yang mencegah penelepon lain masuk: jangan publikasikan alamat tersebut. Simpan sip_uri dari respons, misalnya sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Kirim panggilan dengan konteks

Dalam alur Studio Anda, tambahkan Hubungkan ke Autopilot Voice dalam mode Aliran Suara Eksternal dan atur targetnya ke sip_uri endpoint dengan ;transport=tls ditambahkan, misalnya sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Endpoint menolak panggilan melalui UDP, yang digunakan SIP Twilio kecuali ditentukan sebaliknya.

Talkdesk mengirim:

  • X-Talkdesk-Interaction-Id, disimpan sebagai external_call_id panggilan;
  • User-to-User, dikodekan dalam heksadesimal, seperti business_hours=open. Nilai ini sampai ke Prompt dalam keadaan didekodekan, sebagai {{sip_uui}}.

Komponen versi 2.1 juga dapat mengirim Header yang Ditentukan. Halaman preferensi Talkdesk menjelaskannya sebagai JSON yang dikirim melalui WebSocket, jadi konfirmasikan kepada Talkdesk apakah header tersebut tiba sebagai header SIP sebelum Anda mengandalkannya.

3. Dapatkan panggilan kembali

Agen melakukan eskalasi dengan REFER ke alamat eskalasi Talkdesk, dengan id serah-terima sebagai UUI heksadesimal di dalam alamat tersebut, satu-satunya tempat Talkdesk membacanya. Tambahkan nomor transfer ini (lihat Tambahkan nomor transfer dan Header di dalam alamat transfer):

{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

Alamat tersebut adalah yang ada di artikel Talkdesk. Komponen versi 2.1 membaca autopilot_result=; versi 1.7 membaca escalate_to=, jadi gunakan kunci tersebut pada 1.7. REFER terlihat seperti ini:

Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>

Talkdesk menempatkan nilai tersebut dalam variabel Studio. Untuk mendapatkan ringkasan dan intent, tambahkan langkah Jalankan Tindakan pada integrasi kustom yang dibuat dengan Connections:

  • Jenis autentikasi Kunci API, nama header Authorization, nilai Bearer sk_live_….
  • Permintaan: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= diikuti oleh id dari variabel. Anda juga dapat mencari panggilan berdasarkan external_call_id dengan id interaksi.
  • Buat rute berdasarkan handoff.intent, dan tampilkan handoff.summary kepada orang yang menerima panggilan.

Lihat Cari panggilan yang diserahterimakan.

Uji

Mulai panggilan melalui alur Studio, minta agen untuk menghubungkan Anda ke seseorang, dan periksa bahwa alur berlanjut melewati komponen dengan id serah-terima dalam variabelnya. Kemudian buka panggilan dengan GET /v1/calls/{call_id}: external_call_id harus berupa id interaksi Talkdesk.

Batasan

  • Talkdesk membaca maksimal 256 byte UUI dan tidak mengizinkan nilai yang dipisahkan oleh | atau ;, jadi kirim satu nilai. Id serah-terima muat.
  • API Talkdesk tidak dapat membaca transkrip agen. Gunakan pencarian serah-terima atau GET /v1/calls/{call_id} sebagai gantinya.