---
title: "เชื่อมต่อจาก NICE CXone"
description: "ส่งสายจาก NICE CXone ไปยังเอเจนต์ ThunderPhone จากสคริปต์ Studio โดยใส่ ContactID ในส่วนหัว SIP และค้นหาการส่งต่อของเอเจนต์เมื่อสคริปต์ดำเนินต่อ"
---

สคริปต์ CXone Studio ของคุณจะโทรไปยังเอเจนต์พร้อมส่วนหัว SIP ที่มีรหัสผู้ติดต่อและบริบทอื่นๆ เมื่อเอเจนต์ดำเนินการเสร็จแล้ว เอเจนต์จะวางสาย และการดำเนินการ REST API ในสคริปต์จะดึงข้อมูลการส่งต่อ

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- กลุ่ม SIP trunk ของ CXone ที่ยอมรับส่วนหัวแบบกำหนดเอง ตัวแทนบัญชี NICE ของคุณต้องเปิดการตั้งค่านี้ก่อนที่ CXone จะส่งส่วนหัวเหล่านั้น

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

Placecall โทรออกไปยังหมายเลขโทรศัพท์ผ่านกลุ่ม trunk ของ CXone ไม่ใช่ที่อยู่ SIP NICE ไม่มีเอกสารข้อมูลรับรอง SIP สำหรับการดำเนินการนี้ และการผสานรวม CXone ของผู้ให้บริการ AI รายอื่นใช้ TLS ร่วมกับรายการอนุญาต IP ดังนั้นให้สร้างปลายทาง `ip_allowlist` โดยใช้หมายเลขที่สคริปต์จะโทรเป็นหมายเลขโทรเข้า (ดู[แพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์](/th/guides/sip-addresses)):

```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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: ช่วงการส่งสัญญาณ SIP ของคลัสเตอร์ CXone จาก NICE แต่ละช่วงต้องเป็นช่วง IPv4 สาธารณะ `/16` หรือแคบกว่า (IPv6 `/48` หรือแคบกว่า)
- `dial_in_numbers`: หมายเลขที่ Placecall จะโทร โดยเขียนในรูปแบบที่ CXone ส่ง ไม่จำเป็นต้องเป็นหมายเลขโทรศัพท์จริง และต้องไม่ได้ถูกใช้งานบน ThunderPhone อยู่แล้ว ไม่ว่าจะเป็นหมายเลขโทรศัพท์หรือบนปลายทางอื่น มิฉะนั้นจะได้รับ `409`

ที่อยู่ของ CXone ใช้ร่วมกันโดยลูกค้าทุกราย ดังนั้นลูกค้า CXone รายอื่นที่โทรไปยังหมายเลขนี้จะเข้าถึงเอเจนต์ของคุณได้ เมื่อเลือกหมายเลข ให้เลือกหมายเลขยาวที่ไม่มีใครเดาได้ (สูงสุด 15 หลัก) ตรวจสอบให้แน่ใจว่า CXone ส่งหมายเลขนั้นไปยัง ThunderPhone แทนที่จะส่งออกไปยังเครือข่ายโทรศัพท์ และอย่าเผยแพร่หมายเลขนั้น

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

ในสคริปต์ Studio ของคุณ ก่อน **Placecall**:

1. เพิ่มการดำเนินการ **Sipputheader** พร้อมส่วนหัว `X-Call-ID` และค่า `ContactID` CXone จะไม่ส่งส่วนหัวรหัสการโทรของตัวเอง ThunderPhone จะจัดเก็บค่านี้เป็น `external_call_id` ของสาย
2. เพิ่มการดำเนินการ **Sipputheader** สำหรับค่าอื่นแต่ละค่าที่เอเจนต์ควรทราบ เช่น ตั้งค่า `X-Skill` เป็น `support` ค่านี้จะเข้าสู่พรอมต์เป็น `{{sip_x_skill}}` Sipputheader รองรับ `User-to-User` ส่วนหัว `X-` ใดก็ได้ และส่วนหัว `P-` ส่วนใหญ่ โดย NICE แนะนำให้ใช้ค่าที่มีความยาวไม่เกิน 256 อักขระ

จากนั้นใช้ **Placecall** โทรไปยังหมายเลขนั้น ผ่านกลุ่ม trunk ที่ส่งสายไปยัง `sip.thunderphone.com` พร้อมหมายเลขทั้งใน URI คำขอและส่วนหัว `To` ปลายทางรองรับ TLS (พอร์ต 5061) หรือ TCP (พอร์ต 5060) และปฏิเสธ UDP โดย NICE ไม่มีเอกสารเกี่ยวกับการขนส่งของ trunk ดังนั้นตรวจสอบให้แน่ใจว่าไม่ได้ใช้ UDP

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

CXone อ่านส่วนหัว SIP เฉพาะบน `INVITE` และการตอบกลับสุดท้ายเท่านั้น ดังนั้นเอเจนต์จึงส่งสายกลับ: กล่าวลาและวางสาย แล้วสคริปต์ของคุณจะรับผู้โทรกลับมา เพิ่มหมายเลขโอนสายนี้ (ดู[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE ไม่มีเอกสารยืนยันว่าสคริปต์จะทำงานต่อหลัง Placecall เมื่อสายที่โทรออกสิ้นสุดลง การผสานรวม CXone ของผู้ให้บริการ AI รายอื่นจะส่งสัญญาณให้สคริปต์ผ่าน Signal API ของ CXone (`POST /interactions/{contactId}/signal`) ก่อนวางสายแทน แต่ ThunderPhone จะไม่เรียก API นี้ ยืนยันกับ NICE ว่าสคริปต์ของคุณรับผู้โทรกลับอย่างไร จากนั้นดึงข้อมูลการส่งต่อด้วยการดำเนินการ **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ตามด้วย `ContactID`
- ส่วนหัว `Authorization: Bearer sk_live_…`
- อ่าน `handoff.summary` และ `handoff.intent` จากการตอบกลับเพื่อกำหนดเส้นทางผู้ติดต่อ

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

## ทดสอบ

โทรไปยังหมายเลขที่เรียกใช้สคริปต์ ขอคุยกับบุคคลผ่านเอเจนต์ และตรวจสอบว่า
สคริปต์ทำงานต่อและแอ็กชัน REST API ส่งคืนการส่งต่อสาย หากสาย
ไม่ไปถึงเอเจนต์ ให้ตรวจสอบหมายเลขที่ CXone ส่งไป ที่อยู่ต้นทางอยู่ใน `allowed_source_cidrs`
และสายเข้ามาผ่าน TCP หรือ TLS จากนั้นเปิดข้อมูลสายด้วย
`GET /v1/calls/{call_id}`: `sip_headers` ควรแสดง `x-call-id` และ
`external_call_id` ควรเท่ากับ `ContactID`

## ข้อจำกัด

- CXone ส่งและอ่านส่วนหัวเฉพาะใน `INVITE` และ `2xx` สุดท้ายเท่านั้น ดังนั้น
  ข้อมูลใด ๆ ใน `BYE` ของเอเจนต์จะไปไม่ถึงสคริปต์
- NICE ไม่มีเอกสารระบุว่ารับ `REFER` จากเอเจนต์
- แอ็กชัน REST API จะหมดเวลาหลัง 10 วินาทีโดยค่าเริ่มต้น (สูงสุดต้องน้อยกว่า 90 วินาที)
  และอ่านการตอบกลับได้สูงสุด 32 KB
