---
title: "Kết nối từ Microsoft Dynamics 365"
description: "Gửi cuộc gọi từ Dynamics 365 Contact Center và Copilot Studio đến tác nhân AI ThunderPhone thông qua SBC của bạn bằng X-header, và tra cứu việc chuyển giao của tác nhân qua HTTP."
---

Dynamics 365 Contact Center gửi người gọi đến tác nhân AI thông qua bộ điều khiển biên phiên (SBC) của bạn, với tối đa năm tiêu đề X bao gồm id cuộc trò chuyện. Khi tác nhân AI hoàn tất, tác nhân sẽ ngắt cuộc gọi, SBC của bạn đưa người gọi trở lại Dynamics 365 và một nút HTTP Request truy xuất thông tin bàn giao.

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

- Một tác nhân AI ThunderPhone và [API key](/vi/guides/api-keys) của tổ chức.
- Kênh thoại Dynamics 365 Contact Center, được kết nối qua Azure Communication Services **Định tuyến trực tiếp** đến một SBC do bạn vận hành
  ([yêu cầu về SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  một SBC được hỗ trợ có chứng chỉ công khai, TLS 1.2 trên cổng 5061 và SRTP
  hướng đến Microsoft.
- **Hỗ trợ tiêu đề SIP X** trên nút **Chuyển cuộc trò chuyện**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Xác nhận tính năng này có sẵn trong môi trường của bạn.

Dynamics 365 chỉ chuyển đến một số điện thoại, và Microsoft xác thực Định tuyến trực tiếp bằng chứng chỉ, không phải mật khẩu. SBC của bạn nằm giữa Microsoft và ThunderPhone, đồng thời chuyển số đó thành địa chỉ SIP của tác nhân AI.

## 1. Tạo endpoint SIP

Cuộc gọi đến ThunderPhone từ SBC của bạn, vì vậy hãy tạo một endpoint tiêu chuẩn để
SBC sử dụng:

```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": "Dynamics 365 SBC"}'
```

Lưu ngay `password` từ phản hồi; mật khẩu này chỉ hiển thị một lần và
SBC của bạn dùng nó để trả lời thử thách của ThunderPhone. Nếu SBC của bạn không thể thực hiện xác thực digest, hãy tạo endpoint với `auth` được đặt thành `ip_allowlist` và địa chỉ công khai của SBC; xem
[Các nền tảng xác thực theo IP nguồn](/vi/guides/sip-addresses).

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

1. Chọn một số điện thoại cho tác nhân AI trên SBC của bạn, chẳng hạn `+14155550188`.
2. Trên SBC, định tuyến cuộc gọi đến số đó tới `sip_uri` của endpoint, ví dụ
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, qua TLS trên cổng
   `5061`. ThunderPhone tìm endpoint bằng phần người dùng
   (`agent-12-jhxmginwjx`), phần này phải có trong cả URI yêu cầu và tiêu đề
   `To`. Chuyển tiếp nguyên vẹn các tiêu đề X.
3. Trong Copilot Studio, thêm một nút **Chuyển cuộc trò chuyện** với
   **Chuyển đến số điện thoại bên ngoài** đến số đó, rồi thêm các tiêu đề X:
   - `X-Call-ID`: id cuộc trò chuyện Dynamics 365. Không có tiêu đề Microsoft nào mang
     giá trị này, vì vậy hãy thêm tại đây; ThunderPhone lưu giá trị đó làm
     `external_call_id` của cuộc gọi. Xác nhận trong Copilot Studio biến nào chứa
     id cuộc trò chuyện.
   - Tối đa bốn tiêu đề khác, chẳng hạn `X-Customer-Tier`.

Microsoft gửi tối đa năm tiêu đề X, với tên dài tối đa 64 ký tự và
giá trị dài tối đa 256 ký tự, sử dụng chữ cái, chữ số và `= ; . ! % * _ + ~ -`. Microsoft ghi
tiền tố dưới dạng chữ thường `x-`; ThunderPhone đối chiếu tên tiêu đề không phân biệt hoa thường,
vì vậy `x-customer-tier` đến prompt dưới dạng `{{sip_x_customer_tier}}`.

Nếu thay vào đó bạn xây dựng cuộc gọi bằng Azure Communication Services Call Automation,
`AddSipX` mặc định ghi tên `X-MS-Custom-`. Truyền
`SipHeaderPrefix.X` để `X-Call-ID` giữ nguyên tên
([ngữ cảnh tùy chỉnh](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

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

Tác nhân kết thúc cuộc gọi: chào tạm biệt và gác máy. Thêm số chuyển tiếp này (xem
[Thêm số chuyển tiếp](/vi/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

Đưa người gọi trở lại Dynamics 365 là nhiệm vụ của SBC của bạn. Microsoft
tài liệu hóa một cách để nhận cuộc gọi kèm ngữ cảnh: một cuộc gọi mới qua SBC đến
một số đã đăng ký trong Dynamics 365, với UUI có các khóa khớp với biến ngữ cảnh
bạn đã thiết lập trong **Luồng công việc → Cài đặt nâng cao**
([chuyển tiếp IVR bên thứ ba](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Trao đổi với nhà cung cấp SBC về cách người gọi đến được số đó khi
ThunderPhone gác máy, đồng thời chuyển id cuộc hội thoại mà bạn đã gửi trong `X-Call-ID`
để luồng có thể tìm thấy cuộc gọi.

Sau đó, truy xuất thông tin bàn giao bằng nút **Yêu cầu HTTP** của Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  theo sau bởi id cuộc hội thoại.
- Header `Authorization: Bearer sk_live_…`.
- Phân tích phản hồi vào một biến và sử dụng `handoff.summary` cùng
  `handoff.intent`.

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

## Kiểm thử

Gọi đến một số Dynamics 365 có thể đến nút chuyển tiếp, yêu cầu tác nhân kết nối
với một người, rồi kiểm tra người gọi có quay lại Dynamics 365 hay không. Sau đó, mở
cuộc gọi bằng `GET /v1/calls/{call_id}`: `sip_headers` phải liệt kê `x-call-id`, và
`external_call_id` phải là id cuộc hội thoại. Nếu cuộc gọi không bao giờ đến được
tác nhân và SBC của bạn ghi log SIP `404`, URI yêu cầu hoặc header `To` của nó không
mang phần người dùng của endpoint.

## Giới hạn

- Cần có SBC. Microsoft không thể quay số đến địa chỉ SIP hoặc trả lời thử thách
  digest.
- Microsoft gửi tối đa năm X-header và chỉ giữ năm header đầu tiên trên một
  cuộc gọi đến. Dynamics 365 nhận tối đa 128 ký tự UUI.
- Microsoft không tài liệu hóa việc đọc header trên `BYE`, vì vậy thông tin bàn giao
  chỉ được trả về thông qua tra cứu.
