---
title: "เชื่อมต่อจาก Five9"
description: "ส่งสาย Five9 ไปยังเอเจนต์ ThunderPhone ผ่าน SIP ด้วย AI Agent Connect และรับสายกลับพร้อมส่วนหัวการกำหนดเส้นทางที่สคริปต์ IVR ของคุณอ่านได้"
---

สคริปต์ IVR ของ Five9 จะส่งผู้โทรไปยังเอเจนต์พร้อมรายละเอียดการโทรของ Five9 เมื่อเอเจนต์ดำเนินการเสร็จแล้ว ระบบจะวางสายโดยส่งส่วนหัวการกำหนดเส้นทางบน SIP `BYE` ซึ่งสคริปต์จะอ่านเข้าสู่ตัวแปรการโทรเพื่อกำหนดเส้นทางผู้โทร

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- ส่วนเสริม **AI Agent Connect** ของ Five9 Five9 จำกัดการใช้งานไว้สำหรับผู้ให้บริการ AI ที่ได้รับการรับรอง และทีมติดตั้งใช้งานของ Five9 จะเป็นผู้ตั้งค่า โดยนำเข้าเทมเพลตสคริปต์ IVR ของผู้ให้บริการ สร้างตัวแปรการโทร และชี้โมดูล **การโอนสายไปยังบุคคลที่สาม** ของสคริปต์ไปยังผู้ให้บริการ ThunderPhone ยังไม่อยู่ในรายชื่อผู้ให้บริการที่ Five9 รับรอง โปรดสอบถามทีมดูแลบัญชี Five9 หรือฝ่ายสนับสนุน ThunderPhone ก่อนวางแผนโดยอิงกับการใช้งานนี้

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

โมดูลการโอนสายไปยังบุคคลที่สามของ Five9 โทรไปยังหมายเลขโทรศัพท์ ไม่ใช่ที่อยู่ SIP และการผสานรวม Five9 ของผู้ให้บริการรายอื่นยืนยันตัวตน Five9 ด้วยที่อยู่ต้นทางแทนรหัสผ่าน ดังนั้นให้สร้างปลายทาง `ip_allowlist` โดยใช้หมายเลขที่ Five9 จะโทรเป็นหมายเลขโทรเข้า (ดู[แพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์](/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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

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

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

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

ขอให้ทีมติดตั้งใช้งานของ Five9 ดำเนินการดังนี้:

- ส่งสายจากโมดูล **การโอนสายไปยังบุคคลที่สาม** ไปยัง `sip:+14155550188@sip.thunderphone.com` โดยระบุหมายเลขทั้งใน URI คำขอและส่วนหัว `To` โมดูลจะรับหมายเลข โดยมีโดเมน SIP ของผู้ให้บริการอยู่ในส่วนหัว
- ส่งผ่าน TLS (พอร์ต 5061) หรือ TCP (พอร์ต 5060) ปลายทางจะปฏิเสธ UDP และ Five9 ไม่ได้เผยแพร่ว่าใช้การขนส่งแบบใด ดังนั้นตรวจสอบให้แน่ใจว่าไม่ได้ใช้ UDP
- เปิด **กลับมาหลังการโทรไปยังบุคคลที่สาม** เพื่อให้สคริปต์ทำงานต่อเมื่อเอเจนต์วางสาย (Five9 อนุญาตให้การโทรไปยังบุคคลที่สามนานสูงสุด 3,600 วินาที)

คู่มือของ Five9 ระบุค่าที่ส่ง (`call.ANI`, `call.DNIS`, `call.call_id`, `call.session_id`, `call.campaign_name` และอื่นๆ) แต่ไม่ได้ระบุชื่อส่วนหัว การผสานรวม Five9 ของผู้ให้บริการ AI รายอื่นบันทึกค่าเหล่านี้บนเครือข่ายเป็น `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
และ `X-AgentID`; ตรวจสอบค่าเหล่านี้ในการโทรทดสอบครั้งแรกของคุณ แต่ละค่าจะเข้าถึงพรอมต์ในรูปแบบตัวแปร เช่น
`{{sip_x_callcampaign}}` โดย `X-CallID` จะถูกจัดเก็บเป็น
`external_call_id` ของการโทร

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

เอเจนต์ส่งสายกลับ โดยกล่าวลาและวางสาย และ `BYE` มีเฮดเดอร์ 4 รายการที่สคริปต์ของ Five9 อ่าน เพิ่มหมายเลขโอนสายนี้ (ดู [เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` และ `X-RouteValue` บอกสคริปต์ว่าต้องส่งผู้โทรไปที่ใด ซึ่งในที่นี้คือทักษะ Support ค่าที่ผู้ให้บริการรายอื่นระบุไว้สำหรับ `X-RouteType` ได้แก่ `SkillTransfer`, `PhoneTransfer`, `Hangup` และ `DispositionOnly` ตกลงค่าเหล่านี้กับผู้ที่ดูแลสคริปต์ สำหรับปลายทางหลายแห่ง ให้เพิ่มการส่งกลับหนึ่งรายการต่อปลายทาง โดยใช้ชื่อและ `X-RouteValue` ที่ต่างกัน
- `X-RouteReason` มีป้ายกำกับเจตนาของเอเจนต์ เช่น `billing_dispute`
- `X-CustomMetaData` มี ID การส่งต่อสาย `BYE` ยังมีค่านี้ในรูปแบบ `X-TP-Handoff-Id` ซึ่ง Five9 ไม่ได้อ่าน

สคริปต์ของ Five9 แมปเฮดเดอร์ทั้ง 4 รายการไปยังตัวแปรการโทร สำหรับสรุปของเอเจนต์ ให้สคริปต์เรียกการค้นหาการส่งต่อสายด้วยโมดูล IVR **Query**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` ตามด้วย
`call.call_id` โดยใช้ Authorization Profile ที่ส่ง
`Authorization: Bearer` และคีย์ API ของคุณ ดู
[ค้นหาสายที่ส่งต่อแล้ว](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

โทรเข้าสคริปต์ IVR ขอให้เอเจนต์โอนสายไปยังบุคคลหนึ่ง และตรวจสอบว่าสคริปต์กำหนดเส้นทางผู้โทรพร้อมตัวแปรการโทรที่กรอกครบถ้วน หากสายไปไม่ถึงเอเจนต์ ให้ตรวจสอบว่าหมายเลขใน request URI และเฮดเดอร์ `To` ตรงกับหมายเลขโทรเข้า ว่าที่อยู่ต้นทางของ Five9 อยู่ใน `allowed_source_cidrs` และว่าสายเข้ามาผ่าน TCP หรือ TLS จากนั้นเปิดข้อมูลสายด้วย
`GET /v1/calls/{call_id}`: `sip_headers` ควรแสดง `x-callid` และ
`external_call_id` ควรตรงกับ `call.call_id` ใน Five9

## ข้อจำกัด

- คู่มือของ Five9 ระบุข้อมูลการกำหนดเส้นทางใน `BYE` และไม่ได้กล่าวถึงการรับ `REFER` ดังนั้นการส่งกลับจึงเป็นการโอนสายแบบ cold transfer โดยสคริปต์
- Five9 อ่าน `X-RouteType`, `X-RouteValue`, `X-RouteReason` และ
  `X-CustomMetaData` ไม่ใช่ `User-to-User` ThunderPhone ส่งค่าเฮดเดอร์แต่ละรายการได้ยาวสูงสุด 256 ไบต์
- Five9 แนะนำให้มีเฮดเดอร์แบบกำหนดเองประมาณ 10 รายการเพื่อหลีกเลี่ยงการแตกส่วนของแพ็กเก็ต
