---
title: "เชื่อมต่อจาก Talkdesk"
description: "ส่งสาย Talkdesk ไปยังเอเจนต์ ThunderPhone ด้วย Connect to Autopilot Voice และส่งต่อกลับด้วยรหัสการส่งต่อใน UUI"
---

โฟลว์ Talkdesk Studio ของคุณส่งผู้โทรไปยังเอเจนต์พร้อมรหัสการโต้ตอบและ UUI เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่งต่อด้วย SIP `REFER` ไปยัง Talkdesk และรหัสการส่งต่อจะอยู่ในตัวแปร Studio

## ก่อนเริ่มต้น

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- ไลเซนส์ Talkdesk **Conversation Orchestrator** ซึ่งครอบคลุมคอมโพเนนต์ Studio **เชื่อมต่อกับ Autopilot Voice** ในโหมด **สตรีมเสียงภายนอก** ([บทความของ Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259))
  Talkdesk คิดค่าบริการต่อนาทีในระหว่างที่เอเจนต์รับสายไว้

## 1. สร้างปลายทาง SIP

Talkdesk ระบุเอกสารเฉพาะรายการอนุญาต IP ดังนั้นให้สร้างปลายทางที่รับสายตามที่อยู่ต้นทาง:

```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"
  }'
```

บทความของ Talkdesk ระบุว่าส่งเสียงผ่าน SRTP และ `"srtp": "optional"`
จะตอบรับ SRTP เมื่อ Talkdesk เสนอมา บทความไม่ได้ระบุว่า Talkdesk
ต้องใช้ SRTP หรือไม่ หาก Talkdesk แจ้งว่าต้องใช้ ให้ตั้งค่า `srtp` เป็น `required` ซึ่ง
จะปฏิเสธสายที่ไม่มี SRTP

รับช่วงการส่งสัญญาณ SIP ของ Talkdesk จาก Talkdesk แต่ละช่วงต้องเป็นช่วง IPv4 สาธารณะ
ขนาด `/16` หรือแคบกว่า (IPv6 `/48` หรือแคบกว่า) ดู
[แพลตฟอร์มที่ตรวจสอบสิทธิ์ด้วย IP ต้นทาง](/th/guides/sip-addresses)
Talkdesk ส่ง SIP จากเครือข่ายของ Twilio ซึ่งมีที่อยู่ที่ลูกค้า Twilio ทุกรายใช้ร่วมกัน
ดังนั้นที่อยู่ของปลายทางจึงเป็นสิ่งที่ป้องกันผู้โทรรายอื่น: อย่าเผยแพร่ที่อยู่นี้
เก็บค่า `sip_uri` จากการตอบกลับไว้ ตัวอย่างเช่น
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`

## 2. ส่งสายพร้อมบริบท

ในโฟลว์ Studio ให้เพิ่ม **เชื่อมต่อกับ Autopilot Voice** ในโหมด **สตรีมเสียงภายนอก**
และตั้งค่าเป้าหมายเป็น `sip_uri` ของปลายทางโดยต่อท้ายด้วย `;transport=tls` ตัวอย่างเช่น
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls` ปลายทางจะปฏิเสธสายผ่าน UDP
ซึ่งเป็นโปรโตคอลที่ SIP ของ Twilio ใช้หากไม่ได้ระบุเป็นอย่างอื่น

Talkdesk ส่งข้อมูลดังนี้:

- `X-Talkdesk-Interaction-Id` ซึ่งจัดเก็บเป็น `external_call_id` ของสาย
- `User-to-User` ที่เข้ารหัสแบบเลขฐานสิบหก เช่น `business_hours=open` โดยจะส่งถึง
  พรอมต์หลังถอดรหัสเป็น `{{sip_uui}}`

คอมโพเนนต์เวอร์ชัน 2.1 ยังสามารถส่ง **ส่วนหัวที่กำหนด** ได้ หน้าการตั้งค่าของ Talkdesk
อธิบายว่าส่วนหัวเหล่านี้เป็น JSON ที่ส่งผ่าน WebSocket ดังนั้นควรยืนยันกับ
Talkdesk ว่าส่วนหัวเหล่านี้มาถึงในรูปแบบส่วนหัว SIP ก่อนนำไปใช้งาน

## 3. รับสายกลับ

เอเจนต์จะยกระดับด้วย `REFER` ไปยังที่อยู่สำหรับการยกระดับของ Talkdesk โดยมีรหัส hand-off เป็น UUI แบบเลขฐานสิบหกภายในที่อยู่นั้น ซึ่งเป็นตำแหน่งเดียวที่ Talkdesk อ่านค่า เพิ่มหมายเลขโอนสายนี้ (ดู
[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)
และ [ส่วนหัวภายในที่อยู่โอนสาย](/th/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"
}
```

ใช้ที่อยู่ตามบทความของ Talkdesk คอมโพเนนต์เวอร์ชัน 2.1
อ่าน `autopilot_result=` ส่วนเวอร์ชัน 1.7 อ่าน `escalate_to=` ดังนั้นให้ใช้คีย์ดังกล่าวใน
1.7 `REFER` มีลักษณะดังนี้:

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

Talkdesk จะใส่ค่าไว้ในตัวแปร Studio หากต้องการรับสรุปและเจตนา
ให้เพิ่มขั้นตอน **ดำเนินการ** ในการผสานรวมแบบกำหนดเองที่สร้างด้วย
Connections:

- ประเภทการตรวจสอบสิทธิ์ **คีย์ API** ชื่อส่วนหัว `Authorization` ค่า
  `Bearer sk_live_…`
- คำขอ: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ตามด้วยรหัสจากตัวแปร คุณยังค้นหาสายได้ด้วย
  `external_call_id` โดยใช้รหัสการโต้ตอบ
- กำหนดเส้นทางตาม `handoff.intent` และแสดง `handoff.summary` ให้ผู้รับ
  สาย

ดู [ค้นหาสายที่ส่งต่อ](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

เริ่มสายผ่านโฟลว์ Studio ขอให้เอเจนต์โอนสายไปยังบุคคล และตรวจสอบว่า
โฟลว์ดำเนินต่อผ่านคอมโพเนนต์พร้อมรหัส hand-off ในตัวแปร จากนั้นเปิดสายด้วย `GET /v1/calls/{call_id}`:
`external_call_id` ควรเป็นรหัสการโต้ตอบของ Talkdesk

## ข้อจำกัด

- Talkdesk อ่าน UUI ได้สูงสุด 256 ไบต์ และไม่อนุญาตให้ใช้ค่าที่คั่นด้วย
  `|` หรือ `;` ดังนั้นให้ส่งค่าเดียว รหัส hand-off มีขนาดพอดี
- API ของ Talkdesk ไม่สามารถอ่านทรานสคริปต์ของเอเจนต์ได้ ให้ใช้การค้นหา hand-off หรือ
  `GET /v1/calls/{call_id}` แทน
