---
title: "Hubungkan dari Talkdesk"
description: "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](/id/guides/api-keys) organisasi.
- Lisensi Talkdesk **Conversation Orchestrator**, yang mencakup komponen Studio
  **Hubungkan ke Autopilot Voice** dalam mode **Aliran Suara Eksternal**
  ([artikel Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  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:

```bash
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](/id/guides/sip-addresses).
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](/id/guides/contact-centers/overview)
dan [Header di dalam alamat transfer](/id/guides/call-transfers)):

```json
{
  "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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
