---
title: "Kết nối từ Talkdesk"
description: "Gửi cuộc gọi Talkdesk đến một tác nhân AI ThunderPhone bằng Connect to Autopilot Voice, rồi chuyển tiếp lại bằng mã hand-off trong UUI."
---

Luồng Talkdesk Studio của bạn gửi người gọi đến tác nhân AI cùng với mã tương tác
và UUI. Khi người gọi cần gặp người thật, tác nhân AI chuyển cuộc gọi bằng SIP
`REFER` đến Talkdesk, và mã chuyển giao được lưu vào một biến Studio.

## 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.
- Giấy phép Talkdesk **Điều phối cuộc trò chuyện**, bao gồm thành phần Studio
  **Kết nối với Giọng nói Autopilot** ở chế độ **Luồng thoại bên ngoài**
  ([bài viết của Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk tính phí theo phút trong khi tác nhân AI giữ cuộc gọi.

## 1. Tạo điểm cuối SIP

Talkdesk chỉ cung cấp tài liệu về danh sách cho phép IP, vì vậy hãy tạo một điểm cuối chấp nhận
cuộc gọi theo địa chỉ nguồn:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

Bài viết của Talkdesk cho biết Talkdesk gửi âm thanh qua SRTP, và `"srtp": "optional"`
phản hồi bằng SRTP khi Talkdesk đề xuất. Bài viết không cho biết liệu Talkdesk
có yêu cầu SRTP hay không; nếu Talkdesk cho bạn biết có yêu cầu, hãy đặt `srtp` thành `required`, giá trị này
từ chối cuộc gọi không có SRTP.

Lấy các dải báo hiệu SIP của Talkdesk từ Talkdesk. Mỗi dải phải là dải IPv4 công khai
`/16` hoặc hẹp hơn (IPv6 `/48` hoặc hẹp hơn). Xem
[Các nền tảng xác thực bằng IP nguồn](/vi/guides/sip-addresses).
Talkdesk gửi SIP từ mạng của Twilio, nơi mọi khách hàng Twilio đều dùng chung
địa chỉ, vì vậy địa chỉ của điểm cuối là thứ ngăn các người gọi khác truy cập: không
công khai địa chỉ đó.
Giữ lại `sip_uri` trong phản hồi, ví dụ
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

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

Trong luồng Studio của bạn, hãy thêm **Kết nối với Giọng nói Autopilot** ở chế độ **Luồng thoại bên ngoài**
và đặt mục tiêu thành `sip_uri` của điểm cuối với `;transport=tls` được thêm vào, ví dụ
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Điểm cuối
từ chối cuộc gọi qua UDP, giao thức mà SIP của Twilio sử dụng nếu không được chỉ định khác.

Talkdesk gửi:

- `X-Talkdesk-Interaction-Id`, được lưu dưới dạng `external_call_id` của cuộc gọi;
- `User-to-User`, được mã hóa hex, chẳng hạn `business_hours=open`. Giá trị này đến
  prompt ở dạng đã giải mã, dưới dạng `{{sip_uui}}`.

Phiên bản 2.1 của thành phần cũng có thể gửi **Tiêu đề được xác định**. Trang
tùy chọn của Talkdesk mô tả chúng là JSON được gửi qua WebSocket, vì vậy hãy xác nhận với
Talkdesk liệu chúng có đến dưới dạng tiêu đề SIP hay không trước khi dựa vào chúng.

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

Tác nhân AI chuyển cuộc gọi bằng `REFER` đến địa chỉ chuyển cấp của Talkdesk, với
id chuyển giao dưới dạng UUI hệ thập lục phân trong địa chỉ đó — nơi duy nhất Talkdesk đọc giá trị này.
Thêm số chuyển tiếp này (xem
[Thêm số chuyển tiếp](/vi/guides/contact-centers/overview)
và [Header trong địa chỉ chuyển tiếp](/vi/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Địa chỉ này là địa chỉ trong bài viết của Talkdesk. Phiên bản 2.1 của thành phần
đọc `autopilot_result=`; phiên bản 1.7 đọc `escalate_to=`, vì vậy hãy dùng khóa đó trên
1.7. `REFER` có dạng như sau:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk đặt giá trị này vào một biến Studio. Để lấy bản tóm tắt và ý định,
thêm bước **Thực thi hành động** vào một tích hợp tùy chỉnh được xây dựng bằng
Connections:

- Loại xác thực **Khóa API**, tên header `Authorization`, giá trị
  `Bearer sk_live_…`.
- Yêu cầu: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  theo sau bởi id từ biến. Bạn cũng có thể tra cứu cuộc gọi theo
  `external_call_id` bằng id tương tác.
- Định tuyến theo `handoff.intent`, và hiển thị `handoff.summary` cho người tiếp nhận
  cuộc gọi.

Xem [Tra cứu cuộc gọi đã chuyển giao](/api-reference/calls#look-up-a-handed-off-call).

## Kiểm tra

Bắt đầu một cuộc gọi qua luồng Studio, yêu cầu tác nhân AI chuyển bạn đến một người, rồi kiểm tra
luồng tiếp tục qua thành phần với id chuyển giao trong biến của thành phần đó. Sau đó mở cuộc gọi bằng `GET /v1/calls/{call_id}`:
`external_call_id` phải là id tương tác Talkdesk.

## Giới hạn

- Talkdesk chỉ đọc tối đa 256 byte UUI và không cho phép các giá trị được phân tách bằng
  `|` hoặc `;`, vì vậy hãy gửi một giá trị duy nhất. Id chuyển giao có kích thước phù hợp.
- API của Talkdesk không thể đọc bản chép lời của tác nhân AI. Thay vào đó, hãy dùng tra cứu chuyển giao hoặc
  `GET /v1/calls/{call_id}`.
