ThunderPhone v3 đã chính thức ra mắt.Tự đăng ký và sử dụng, chỉ từ 2¢/phút.Xem thông báo ra mắt

Contact centers

Kết nối từ Microsoft Dynamics 365

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 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): 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). 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:

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.

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).

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):

{"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). 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.

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.