Open in
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 sebagaiexternal_call_idpanggilan;User-to-User, dikodekan dalam heksadesimal, sepertibusiness_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, nilaiBearer sk_live_…. - Permintaan:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=diikuti oleh id dari variabel. Anda juga dapat mencari panggilan berdasarkanexternal_call_iddengan id interaksi. - Buat rute berdasarkan
handoff.intent, dan tampilkanhandoff.summarykepada 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.