---
title: "เชื่อมต่อจาก Zoom Contact Center"
description: "ส่งสายจาก Zoom Contact Center ไปยังเอเจนต์ ThunderPhone ด้วยตัวเชื่อมต่อ voicebot ของบุคคลที่สาม และโอนกลับไปยังเอเจนต์มนุษย์ด้วย SIP REFER"
---

วิดเจ็ตบอตในโฟลว์ Zoom Contact Center จะส่งผู้โทรไปยังเอเจนต์พร้อม call sid ของ Zoom เมื่อผู้โทรต้องการพูดคุยกับบุคคล เอเจนต์จะส่ง SIP `REFER` ไปยังที่อยู่เอเจนต์มนุษย์ของ Zoom และโฟลว์ของคุณจะดึงการส่งต่อสายด้วย call sid

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- **แอปทั่วไป**ของ Zoom Marketplace ที่ผู้ดูแลระบบของคุณจัดการและเปิดใช้สำหรับ Contact Center พร้อมตัวเชื่อมต่อสำหรับวิดเจ็ตบอต
  ([คู่มือ voicebot ของบุคคลที่สามจาก Zoom](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/))
- SIP trunk จาก Zoom ไปยังผู้ให้บริการบอต ทีม ISV ของ Zoom จะสร้างเป็นขั้นตอน
  (การสำรวจ trunk สำหรับสภาพแวดล้อมทดสอบ แล้วจึงใช้งานจริง) และชื่อบริษัทของแอปต้องตรงกับระเบียน trunk ทุกประการ การตั้งค่านี้เริ่มต้นร่วมกับฝ่ายสนับสนุน ThunderPhone และ Zoom ไม่ใช่ดำเนินการในบัญชี Zoom ของคุณเพียงลำพัง

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

ตัวเชื่อมต่อของ Zoom จะโทรไปยังหมายเลข 15 หลักที่ขึ้นต้นด้วย `999` ไม่ใช่ที่อยู่ SIP การบันทึกตัวเชื่อมต่อจะสร้างหมายเลขดังกล่าว trunk ของ Zoom ใช้ TLS 1.2 บนพอร์ต 5061 พร้อม SRTP สำหรับเสียง และอนุญาตการเชื่อมต่อด้วยรายการอนุญาตของเครือข่ายย่อย Zoom แทนรหัสผ่าน ดังนั้นให้สร้างปลายทาง `ip_allowlist` โดยใช้หมายเลขของตัวเชื่อมต่อเป็นหมายเลขโทรเข้าและบังคับใช้ SRTP (ดู
[แพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์](/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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
```

- `allowed_source_cidrs`: เครือข่ายย่อยสำหรับสัญญาณ SIP ของ Zoom ซึ่งได้รับจาก Zoom แต่ละรายการต้องเป็นช่วง IPv4 สาธารณะขนาด `/16` หรือแคบกว่า (IPv6 `/48` หรือแคบกว่า)
- `dial_in_numbers`: หมายเลขของตัวเชื่อมต่อที่ตรงตามที่ Zoom ส่งมา โดยไม่มี `+`
- `srtp`: `required` เนื่องจาก trunk ของ Zoom ใช้ SRTP เสมอ

ที่อยู่ของ Zoom ใช้ร่วมกันระหว่างลูกค้าทั้งหมด ดังนั้นลูกค้า Zoom รายอื่นที่โทรไปยังหมายเลขนี้จะติดต่อเอเจนต์ของคุณได้ Zoom เป็นผู้กำหนดหมายเลข อย่าเผยแพร่หมายเลขดังกล่าว

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

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

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

- `X-ZOOM-Call-Sid` จัดเก็บเป็น `external_call_id` ของสาย หน้าการแมปข้อมูลของ Zoom เองไม่ได้ระบุข้อมูลนี้ แต่เอกสารการผสานรวม Zoom ของผู้ให้บริการ AI รายอื่นระบุไว้ ดังนั้นให้ตรวจสอบในการทดสอบสายครั้งแรก
- `X-ZOOM-DNIS` หมายเลขที่ผู้โทรโทรเข้า เป็น `{{sip_x_zoom_dnis}}`
- `X-ZOOM-WEBHOOK` Static URL ของตัวเชื่อมต่อ

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

เอเจนต์ส่ง `REFER` ไปยังที่อยู่ของเอเจนต์ที่เป็นมนุษย์บน SBC ของ Zoom เพิ่มหมายเลขโอนสายนี้ (ดู
[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview))
พร้อมที่อยู่ SBC ที่ Zoom ให้คุณ:

```json
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}
```

คู่มือของ Zoom อธิบาย 2 วิธีที่บอตส่งบริบท: `POST` ไปยัง Static URL ของ
คอนเน็กเตอร์ก่อน `REFER` (เหตุการณ์ `voicebot_metadata` และเหตุการณ์ที่คล้ายกัน)
และส่วนหัว SIP ที่แมปไว้ภายใต้ **ขาเข้าจากบอต** ThunderPhone จะไม่โพสต์ไปยัง Static URL
คู่มือของ Zoom ไม่ได้ระบุว่าอ่านส่วนหัวที่แมปจาก `REFER` หรือไม่ หากต้องการลอง ให้เพิ่ม
`headers` เช่น `"X-Handoff-Id": "{{handoff_id}}"` ลงในรายการ แล้วตรวจสอบด้วยสายทดสอบ
นอกจากนี้ ให้ยืนยันกับ Zoom ว่ายอมรับ `REFER` ที่ไม่มี metadata `POST` ก่อนหน้านั้น

หากต้องการรับข้อมูลการส่งต่อโดยไม่ต้องพึ่งพาวิธีใดวิธีหนึ่ง ให้โฟลว์ของคุณค้นหาหลังวิดเจ็ตบอต
ด้วยวิดเจ็ต **การเรียก HTTP** หรือ **สคริปต์**:

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

Zoom ไม่เผยแพร่เอกสารระดับฟิลด์สำหรับวิดเจ็ตเหล่านี้ ดังนั้นให้ยืนยันในบัญชีของคุณว่าวิดเจ็ตสามารถส่งส่วนหัว
`Authorization` ได้ ดู
[ค้นหาสายที่ส่งต่อแล้ว](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

โทรไปยังหมายเลขที่เข้าถึงวิดเจ็ตบอต ขอคุยกับเอเจนต์ที่เป็นมนุษย์ และตรวจสอบว่าผู้โทรไปถึงเอเจนต์ที่เป็นมนุษย์
และวิดเจ็ตส่งคืนข้อมูลการส่งต่อ จากนั้นเปิดสายด้วย `GET /v1/calls/{call_id}`: `sip_headers`
ควรแสดง `x-zoom-call-sid` และ `external_call_id` ควรตรงกับ SID ของสายที่โฟลว์ของคุณใช้

## ข้อจำกัด

- ThunderPhone จะไม่โพสต์ไปยัง Static URL ของคอนเน็กเตอร์ ดังนั้น Zoom จะได้รับข้อมูลการส่งต่อผ่านการค้นหา
  หรือผ่านส่วนหัวที่แมป หากการทดสอบของคุณแสดงว่า Zoom อ่านส่วนหัวเหล่านั้นจาก `REFER`
- ทรังก์สร้างโดยทีม ISV ของ Zoom ดังนั้นคุณจึงไม่สามารถตั้งค่าหรือทดสอบได้ด้วยตนเอง
