---
title: "เชื่อมต่อจาก Genesys Cloud"
description: "ส่งสายจาก Genesys Cloud ไปยังเอเจนต์ ThunderPhone ผ่านทรังก์ BYOC Cloud พร้อมรหัสการสนทนาและ UUI และรับสายกลับพร้อมการส่งต่อใน UUI"
---

โฟลว์ Architect ของคุณจะส่งผู้โทรไปยังเอเจนต์ผ่านทรังก์ BYOC Cloud พร้อมรหัสการสนทนาและ UUI ใดๆ ที่คุณตั้งค่าไว้ เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่ง SIP `REFER` แล้ว Genesys จะรับสายกลับ และรหัสแฮนด์ออฟจะมาถึงใน UUI ของสาย

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- Genesys Cloud ที่มี BYOC Cloud และทรังก์ภายนอก (ประเภท BYOC Carrier หรือ PBX) โดยเปิดใช้การตั้งค่าต่อไปนี้
  ([การตั้งค่าทรังก์ภายนอก](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **ส่วนหัวการสนทนา** เพื่อให้ Genesys ส่งรหัสการสนทนาใน
    `x-inin-cnv` ซึ่งปิดใช้งานเป็นค่าเริ่มต้น
  - **การส่งต่อ UUI** โดยมีประเภทส่วนหัวเป็น `User-To-User` และการเข้ารหัสแบบ Hex
  - **รับสายกลับและโอนสาย** เพื่อให้ Genesys ยอมรับ `REFER` ของเอเจนต์

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

Genesys ตอบกลับ Digest challenge ดังนั้นให้ใช้ปลายทางมาตรฐาน:

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

จัดเก็บ `password` จากการตอบกลับทันที โดยจะแสดงเพียงครั้งเดียว บนทรังก์:

| การตั้งค่า | ค่า |
|---|---|
| เซิร์ฟเวอร์ SIP | `sip.thunderphone.com`, พอร์ต `5061` |
| โพรโทคอล | TLS |
| การยืนยันตัวตน Digest | `username` และ `password` ของปลายทาง |
| โคเดก | PCMU, PCMA หรือ G.722 |

กำหนดทรังก์บนเส้นทางขาออกของไซต์ที่มีแผนหมายเลขครอบคลุมที่อยู่ที่โฟลว์โทรออก

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

ในโฟลว์ Architect ของคุณ:

1. หากต้องการ ให้เพิ่มการดำเนินการ **ตั้งค่าข้อมูล UUI** พร้อมบริบทสำหรับเอเจนต์ เช่น `account=12345` Genesys แนะนำให้ใช้ไม่เกิน 128 อักขระ
2. เพิ่มการดำเนินการ **โอนไปยังหมายเลข** ด้วย `sip_uri` ของปลายทาง เช่น `sip:agent-12-jhxmginwjx@sip.thunderphone.com`

Genesys ส่งรหัสการสนทนาใน `x-inin-cnv` ThunderPhone จัดเก็บเป็น `external_call_id` ของสาย UUI จะส่งถึงพรอมป์ต์ในรูปแบบที่ถอดรหัสแล้วเป็น `{{sip_uui}}`

ส่วนหัวกำหนดเองของทรังก์เป็นค่าแบบคงที่ใน Genesys ดังนั้นให้ใส่ค่าต่อสายใน UUI Genesys สงวนคำนำหน้าส่วนหัว `x-inin`, `x-genesys`, `x-pcv` และ `x-gcv` ไว้ใช้เอง

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

เอเจนต์โอนสายด้วย `REFER` ไปยังที่อยู่บน Genesys โดยมีรหัสแฮนด์ออฟเป็น UUI แบบ Hex ภายในที่อยู่นั้น เพิ่มหมายเลขโอนสายนี้ (ดู
[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)
และ[ส่วนหัวภายในที่อยู่สำหรับโอนสาย](/th/guides/call-transfers)):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

แทนที่อยู่ด้วยที่อยู่ที่กำหนดเส้นทางกลับไปยังคิวหรือโฟลว์ที่ควรรับผู้โทร และยืนยันรูปแบบกับ Genesys `REFER` มีลักษณะดังนี้:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

เมื่อเปิด **รับสายกลับและโอนสาย** Genesys จะรับสายกลับจากทรังก์และกำหนดเส้นทางไปยังที่อยู่นั้น Genesys ระบุว่า UUI ขาเข้าจะอยู่ใน `Call.UUIData` แต่ไม่ได้ระบุเรื่องนี้สำหรับการรับสายกลับ ดังนั้นให้ยืนยันกับ Genesys หรือทดสอบการโทร เพื่อให้แน่ใจว่าโฟลว์ที่รับผู้โทรพบรหัสแฮนด์ออฟที่นั่น หากต้องการรับข้อมูลสรุปและเจตนา ให้เรียกการค้นหาแฮนด์ออฟด้วย **การดำเนินการข้อมูลการโทร** บนการผสานรวม Web Services Data Actions:

- คำขอ: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ตามด้วยรหัสจาก `Call.UUIData`
- ข้อมูลรับรอง: คีย์ API ของคุณ ซึ่งส่งเป็น `Authorization: Bearer sk_live_…`
- เอาต์พุต: แมป `handoff.summary` และ `handoff.intent` ไปยังตัวแปรของโฟลว์

ดู[ค้นหาสายที่แฮนด์ออฟแล้ว](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

โทรไปยังหมายเลขที่เข้าถึงโฟลว์ ขอให้เอเจนต์โอนสายไปยังบุคคลหนึ่ง และตรวจสอบว่า
Genesys นำสายไปยังที่อยู่ที่คุณตั้งค่าไว้ ในโฟลว์นั้น ให้ตรวจสอบว่า
`Call.UUIData` เก็บรหัสการส่งต่อเป็นข้อความ (หากแสดงเลขฐานสิบหก ให้ตรวจสอบว่า
การเข้ารหัส UUI ของทรังก์เป็น Hex) จากนั้นเปิดการเรียกด้วย `GET /v1/calls/{call_id}`:
`external_call_id` ควรเป็นรหัสการสนทนา

## ข้อจำกัด

- การดำเนินการ **รับส่วนหัว SIP** อ่านได้เฉพาะ `INVITE` เริ่มต้น จึงไม่สามารถ
  อ่านข้อมูลใดๆ จาก `REFER` ของเอเจนต์ได้ การส่งต่อจะไปถึง Genesys ผ่าน UUI เท่านั้น
- Genesys จะละทิ้ง UUI ทั้งหมดเมื่อการเรียกมีส่วนหัว UUI มากกว่าหนึ่งรายการ
- ที่อยู่สำหรับโอนสายจำกัดไว้ที่ 254 อักขระ ดังนั้น UUI ที่ยาวจะถูกตัดให้พอดี
  รหัสการส่งต่อจะพอดีเสมอ
