# Cấu hình tích hợp phê duyệt WeCom

Canonical: https://www.nsecsoft.com/vi/docs/ping64-platform/platform/integrations/wecom-integration/

Language: vi-VN

Updated: 2026-11-15T03:17:34.324716Z

Tích hợp WeCom cho phép quản trị viên đã liên kết truy cập trang phê duyệt và nhận nhắc việc đang chờ theo cấu hình. Tạo ứng dụng, công tắc chức năng, liên kết người dùng, quy trình phê duyệt và việc gửi đến thực tế là các giai đoạn riêng. Lưu hoặc kiểm tra kết nối thành công không chứng minh đã liên kết hoặc gửi thông báo thành công.

## Chuẩn bị

-   Dùng tài khoản quản trị có quyền xem, cấu hình và vận hành tích hợp nền tảng; phối hợp với quản trị viên WeCom và trang phê duyệt. Xác nhận trang đã triển khai và người thử có thể truy cập.
-   Chuẩn bị ID doanh nghiệp, AgentID và Secret tương ứng của ứng dụng WeCom tự xây dựng; kiểm tra trạng thái và phạm vi người thử nhìn thấy ứng dụng. Secret là thông tin nhạy cảm, chỉ nhập vào mục cấu hình được phép, không đưa vào tài liệu, phiếu sự cố hoặc trò chuyện.
-   Chuẩn bị trang chủ ứng dụng, miền tin cậy và IP công cộng đi ra của máy chủ theo yêu cầu hiện tại của quản trị WeCom. Lưu trong Ping64 không tự thay đổi phía WeCom; cần kiểm tra cả hai phía.

## Tạo và cấu hình ứng dụng

Tên bên dưới theo giao diện tiếng Anh và có thể khác tùy ngôn ngữ bảng điều khiển.

1.  Mở **Platform Integrations** trong cài đặt hệ thống và vào **WeCom**. Trong thông tin cơ bản, chọn **Add Application**, nhập tên ứng dụng, ID doanh nghiệp, AgentID và Secret tương ứng, kiểm tra rồi lưu. Khi sửa ứng dụng, để trống Secret giữ giá trị cũ; nhập và lưu giá trị mới sẽ thay thế. Không thể đổi ID doanh nghiệp và AgentID sau khi tạo. Khi đổi doanh nghiệp hoặc ứng dụng thực tế, hãy tạo cấu hình ứng dụng mới.
2.  Trở lại danh sách, kiểm tra và bật ứng dụng khi cần. Cần lưu trước khi bật, tắt, xóa hoặc quản lý liên kết. Đánh giá ảnh hưởng đến người dùng và quy trình phê duyệt trước khi thay đổi. Khi tắt, các phiên phê duyệt đăng nhập qua ứng dụng này mất hiệu lực và thông báo phê duyệt qua ứng dụng dừng lại; các liên kết người dùng hiện có vẫn được giữ.
3.  Trong cấu hình chức năng phê duyệt, chọn ứng dụng và bật riêng **Allow Sign-in** và **Send Approval Notifications** khi cần. Khi bật thông báo, nhập lối vào trang phê duyệt đã triển khai vào **Notification Base URL** và chọn ngôn ngữ. Không nhập trang cụ thể hoặc tham số truy vấn; môi trường vận hành dùng HTTPS được tổ chức chấp thuận.
4.  Lưu cấu hình chức năng. Dùng liên kết tham khảo trang chủ và hướng dẫn trên trang để hoàn tất riêng cấu hình quản trị WeCom; kiểm tra phạm vi hiển thị, miền tin cậy và IP công cộng đi ra thực tế.
5.  Dùng **Test Connection** và kiểm tra kết quả. Kiểm tra không lưu thay đổi chưa lưu hoặc bật ứng dụng. Lưu trước rồi xác minh riêng đăng nhập, liên kết và thông báo thực tế.

Ngôn ngữ thông báo có thể là tiếng Trung giản thể hoặc tiếng Anh, áp dụng cho nội dung cố định như tiêu đề và nút, không thay đổi ngôn ngữ bảng điều khiển quản trị. Kiểm tra kết nối có thể dùng Secret mới đã nhập nhưng chưa lưu; kiểm tra thành công không có nghĩa Secret đã được lưu. Khi thay đổi thông tin xác thực, hãy lưu, kiểm tra lại và xác minh thông báo thực tế.

## Liên kết và xác minh

1.  Quản trị viên thử được phép mở trang phê duyệt từ ứng dụng WeCom, xác minh tài khoản Ping64 theo hướng dẫn để liên kết. Việc xử lý yêu cầu phụ thuộc quyền nghiệp vụ.
2.  Trong **Bound Users**, kiểm tra liên kết hợp lệ của ứng dụng. Trước khi bỏ liên kết, đánh giá ảnh hưởng: phiên đăng nhập qua ứng dụng này mất hiệu lực và nhắc việc dừng; muốn dùng lại phải xác minh tài khoản. Liên kết của ứng dụng khác không thay đổi.
3.  Gửi yêu cầu thử trong quy trình kiểm soát; xác minh riêng đăng nhập, nhắc việc, xem hoặc xử lý theo quyền và kết quả nghiệp vụ cuối cùng trước khi mở rộng.

## Xử lý sự cố

-   **Không tạo, bật hoặc kiểm tra được:** Kiểm tra quyền tích hợp, trạng thái lưu, ID doanh nghiệp, AgentID, thông tin xác thực, trạng thái ứng dụng và mạng đi ra. Không ghi thông tin xác thực trong phiếu sự cố.
-   **Không đăng nhập hoặc liên kết được:** Kiểm tra phạm vi hiển thị, truy cập trang phê duyệt, công tắc đăng nhập, miền tin cậy và quyền tài khoản Ping64. Cấu hình WeCom phải hoàn tất riêng.
-   **Kiểm tra kết nối thành công nhưng không có thông báo:** Kiểm tra công tắc thông báo, địa chỉ cơ sở, trạng thái ứng dụng, liên kết và yêu cầu đang chờ, rồi xác minh bằng yêu cầu thử. Kiểm tra kết nối không chứng minh đã gửi đến.