---
title: "Kết nối từ Zoom Contact Center"
description: "Chuyển cuộc gọi từ Zoom Contact Center đến một tác nhân AI ThunderPhone bằng trình kết nối voicebot của bên thứ ba, rồi chuyển lại cho tác nhân con người bằng SIP REFER."
---

Một tiện ích Bot trong luồng Zoom Contact Center của bạn gửi người gọi đến tác nhân AI kèm call sid của Zoom. Khi người gọi cần một người hỗ trợ, tác nhân AI gửi SIP `REFER`
đến địa chỉ tác nhân con người của Zoom, và luồng của bạn lấy lần chuyển tiếp theo call sid.

## Trước khi bắt đầu

- Một tác nhân AI ThunderPhone và một [API key](/vi/guides/api-keys) của tổ chức.
- Một **Ứng dụng chung** trên Zoom Marketplace, do quản trị viên của bạn quản lý và cung cấp
  cho Contact Center, có connector cho tiện ích Bot
  ([hướng dẫn voicebot bên thứ ba của Zoom](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)).
- Một SIP trunk từ Zoom đến nhà cung cấp bot. Đội ISV của Zoom xây dựng trunk này theo
  các giai đoạn (khảo sát, trunk thử nghiệm, rồi đến production), và Tên công ty của ứng dụng
  phải khớp chính xác với bản ghi trunk. Thiết lập này bắt đầu cùng bộ phận hỗ trợ ThunderPhone
  và Zoom, không chỉ trong tài khoản Zoom của bạn.

## 1. Tạo endpoint SIP

Connector của Zoom gọi một số gồm 15 chữ số bắt đầu bằng `999`, không phải địa chỉ SIP.
Việc lưu connector sẽ tạo số đó. Trunk của Zoom dùng TLS 1.2
trên cổng 5061 với SRTP cho âm thanh, và được đưa vào danh sách cho phép bằng subnet của Zoom thay
vì mật khẩu. Vì vậy, hãy tạo endpoint `ip_allowlist` với số của connector
làm số gọi vào và yêu cầu SRTP (xem
[Các nền tảng gọi một số điện thoại](/vi/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`: Các subnet báo hiệu SIP của Zoom, do Zoom cung cấp. Mỗi subnet phải
  là dải IPv4 công khai `/16` hoặc hẹp hơn (IPv6 `/48` hoặc hẹp hơn).
- `dial_in_numbers`: Số của connector đúng như cách Zoom gửi, không có
  `+`.
- `srtp`: `required`, vì trunk của Zoom luôn dùng SRTP.

Địa chỉ của Zoom được dùng chung cho tất cả khách hàng của họ, vì vậy bất kỳ khách hàng Zoom nào khác
gọi số này đều sẽ đến tác nhân AI của bạn. Zoom chỉ định số này; không
công khai số đó.

## 2. Gửi cuộc gọi kèm ngữ cảnh

Thêm tiện ích **Bot** vào luồng của bạn và liên kết tiện ích đó với connector. Yêu cầu đội ISV
của Zoom trỏ trunk đến `sip.thunderphone.com`, dùng TLS trên cổng 5061, với
số của connector trong cả URI yêu cầu và tiêu đề `To`. Endpoint
từ chối UDP, vì vậy hãy đảm bảo trunk không chuyển sang dùng UDP.

Zoom gửi:

- `X-ZOOM-Call-Sid`, được lưu dưới dạng `external_call_id` của cuộc gọi. Trang ánh xạ dữ liệu
  của Zoom không liệt kê mục này; tài liệu tích hợp Zoom của một nhà cung cấp AI khác có đề cập
  đến mục này, vì vậy hãy kiểm tra trong cuộc gọi thử nghiệm đầu tiên.
- `X-ZOOM-DNIS`, số mà người gọi đã gọi đến, dưới dạng `{{sip_x_zoom_dnis}}`.
- `X-ZOOM-WEBHOOK`, Static URL của connector.

## 3. Nhận lại cuộc gọi

Tác nhân AI gửi `REFER` đến địa chỉ tác nhân con người trên SBC của Zoom. Thêm
số chuyển này (xem
[Thêm số chuyển](/vi/guides/contact-centers/overview)),
với địa chỉ SBC do Zoom cung cấp:

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

Hướng dẫn của Zoom mô tả hai cách bot truyền ngữ cảnh: `POST` đến URL tĩnh của
trình kết nối trước `REFER` (các sự kiện `voicebot_metadata` và tương tự), và
các tiêu đề SIP được ánh xạ trong **Đến từ Bot**. ThunderPhone không gửi POST
đến URL tĩnh. Hướng dẫn của Zoom không nói liệu Zoom có đọc các tiêu đề được
ánh xạ từ `REFER` hay không; nếu bạn muốn thử, hãy thêm `headers` như
`"X-Handoff-Id": "{{handoff_id}}"` vào mục nhập và kiểm tra bằng một cuộc gọi
thử. Đồng thời xác nhận với Zoom rằng hệ thống chấp nhận `REFER` không có
metadata `POST` trước đó.

Để nhận chuyển giao mà không phụ thuộc vào cách nào trong hai cách trên, hãy để
luồng của bạn tra cứu sau tiện ích Bot bằng tiện ích **Cuộc gọi HTTP** hoặc
**Tập lệnh**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  theo sau bởi SID cuộc gọi.
- Tiêu đề `Authorization: Bearer sk_live_…`.
- Dùng `handoff.summary` và `handoff.intent` để định tuyến người gọi và cung
  cấp tóm tắt cho người nhận cuộc gọi.

Zoom không công bố tài liệu cấp trường cho các tiện ích này, vì vậy hãy xác
nhận trong tài khoản của bạn rằng tiện ích có thể gửi tiêu đề `Authorization`.
Xem
[Tra cứu cuộc gọi đã được chuyển giao](/api-reference/calls#look-up-a-handed-off-call).

## Kiểm tra

Gọi đến một số dẫn đến tiện ích Bot, yêu cầu tác nhân AI chuyển cho một người,
và kiểm tra rằng người gọi đến được tác nhân con người cũng như tiện ích trả về
dữ liệu chuyển giao. Sau đó mở cuộc gọi bằng `GET /v1/calls/{call_id}`:
`sip_headers` phải liệt kê `x-zoom-call-sid`, và `external_call_id` phải khớp
với SID cuộc gọi mà luồng của bạn sử dụng.

## Giới hạn

- ThunderPhone không gửi POST đến URL tĩnh của trình kết nối, vì vậy Zoom nhận
  dữ liệu chuyển giao thông qua tra cứu, hoặc qua các tiêu đề được ánh xạ nếu
  thử nghiệm của bạn cho thấy Zoom đọc chúng từ `REFER`.
- Trunk được đội ngũ ISV của Zoom xây dựng, vì vậy bạn không thể tự thiết lập
  hoặc kiểm tra nó.
