Workflow - Quản lý cổng Webhook và nhật ký sự kiện Event Logs
Cấu hình endpoint nhận dữ liệu tự động từ bên thứ ba, bảo mật chữ ký và theo dõi nhật ký webhook.
## Mở Màn hình Quản lý Cổng Webhook trên nền tảng RedAI
Màn hình Quản lý Cổng Webhook là trung tâm thiết lập và giám sát các điểm tiếp nhận dữ liệu tự động từ các ứng dụng và dịch vụ bên ngoài gửi về nền tảng RedAI. Màn hình cho phép người dùng khởi tạo các địa chỉ kết nối công khai an toàn, quy định tiêu đề xác thực gói tin, theo dõi bảng điều khiển 6 chỉ số hiệu năng vận hành và phân tích nhật ký gói tin sự kiện theo thời gian thực để kích hoạt luồng xử lý kịch bản tự động hóa mà không cần can thiệp thủ công.
| Bước | Thao tác trên giao diện | Kết quả hiển thị tương ứng |
|---|---|---|
| 1 | Truy cập phân hệ Quy trình trên thanh điều hướng bên trái và chọn mục Cổng Webhook (hoặc truy cập trực tiếp địa chỉ chuẩn: https://app.redai.vn/workflows/webhook-registries) | Giao diện quản lý cổng webhook mở ra với thanh công cụ tìm kiếm đỉnh trang, bảng danh sách phẳng không viền và thanh phân trang ở góc dưới. |
| 2 | Nhận diện dải trạng thái kết nối mạng và quyền hạn thao tác | • Nếu đường truyền mạng ổn định: Toàn bộ danh sách cổng webhook và các nút tạo mới sẵn sàng hoạt động. • Nếu mất kết nối mạng hoặc máy chủ không phản hồi: Hệ thống hiển thị ngay dải băng màu hổ phách cảnh báo an toàn kèm nút Tải lại tại chỗ để phòng ngừa phát sinh lỗi khi gửi dữ liệu. |
| 3 | Quan sát bảng dữ liệu và thanh tác vụ | Bảng danh sách hiển thị rõ ràng: Tên webhook, Địa chỉ kết nối công khai dạng đơn sắc, Số lượng tiêu đề xác thực, Ngày tạo chuẩn địa phương và Menu 3 chấm thao tác ở cột cuối. |
📸 [Vị trí chèn ảnh chụp màn hình: Toàn cảnh giao diện Màn hình Quản lý Cổng Webhook tại địa chỉ https://app.redai.vn/workflows/webhook-registries bao gồm thanh công cụ đỉnh trang, bảng danh sách webhook phẳng không viền và cụm phân trang]
Các tính năng trên Màn hình Quản lý Cổng Webhook
1. Thanh công cụ tìm kiếm, điều hướng và dải cảnh báo kết nối
Thanh công cụ đỉnh trang được thiết kế theo phong cách phẳng hiện đại, triệt tiêu hoàn toàn viền hộp thẻ và hiệu ứng viền khi rê chuột, tập trung tối đa vào tốc độ tra cứu và tính an toàn của luồng dữ liệu.
| Thành phần giao diện | Biểu tượng nhận diện | Vai trò và tác vụ tương tác thực tế |
|---|---|---|
| Nút Quay lại danh sách quy trình |  | Nút điều hướng nhanh đặt ở đầu thanh công cụ; cho phép quay trở lại Màn hình Danh sách Kịch bản tại địa chỉ https://app.redai.vn/workflows. |
| Nút Tạo webhook mới |  | Nút màu xanh dương nổi bật; mở hộp thoại khởi tạo cổng tiếp nhận dữ liệu mới sẵn sàng cấp địa chỉ kết nối. |
| Ô tìm kiếm tức thời |  | Nhập từ khóa tên webhook; hệ thống tự động lọc danh sách với độ trễ 300 mili-giây giúp thao tác gõ luôn mượt mà. |
| Nút Làm mới dữ liệu |  | Đồng bộ tức thì danh sách cổng webhook mới nhất từ máy chủ của nền tảng RedAI. |
| Nút Xóa hàng loạt |  | Nút màu đỏ cảnh báo; tự động xuất hiện khi người dùng tích chọn từ một cổng webhook trở lên và có quyền xóa trong không gian làm việc. |
Cơ chế cảnh báo thông minh trên thanh công cụ:
- Dải băng cảnh báo mất kết nối: Khi mạng bị ngắt quãng hoặc máy chủ gián đoạn, một dải băng màu hổ phách lập tức xuất hiện phía trên thanh công cụ với chấm tròn nhấp nháy, tiêu đề “Đã mất kết nối mạng” và nút “Tải lại”, đồng thời tự động vô hiệu hóa nút tạo mới để bảo vệ an toàn dữ liệu.
- Trạng thái Màn hình Rỗng khi chưa có Webhook: Khi không gian làm việc chưa có cổng webhook nào, hệ thống hiển thị thông điệp “Chưa có webhook nào - Tạo webhook đầu tiên của bạn” kèm nút Tạo webhook chuyển màu đỏ cam rực rỡ để dẫn dắt người dùng mới.
📸 [Vị trí chèn ảnh chụp màn hình: Thanh công cụ đỉnh trang với nút quay lại danh sách quy trình, ô tìm kiếm, nút tải lại và nút xóa hàng loạt màu đỏ khi có dòng được chọn]
2. Bảng danh sách Cổng Webhook phẳng không viền và thanh tác vụ
Toàn bộ các cổng webhook được trình bày trong một bảng dữ liệu phẳng hiện đại, tuân thủ nghiêm ngặt quy tắc Không viền, kết hợp khả năng tự co giãn chữ và hỗ trợ thao tác chuột thông minh.
| Cột dữ liệu | Độ rộng và định dạng | Ý nghĩa nghiệp vụ và hướng dẫn tương tác |
|---|---|---|
| Hộp kiểm chọn dòng | 40 điểm ảnh | Tích chọn từng cổng webhook để phục vụ thao tác xóa hàng loạt hoặc tích chọn hộp kiểm ở dòng tiêu đề để chọn nhanh toàn bộ trang. |
| Tên webhook | Tự co giãn linh hoạt | Tiêu đề in đậm hiển thị tên định danh của cổng, hỗ trợ rút gọn một dòng chống tràn chữ và hiển thị đầy đủ tên gốc khi rê chuột. |
| Địa chỉ URL công khai | Kiểu chữ đơn sắc | Đường dẫn điểm cuối chuẩn tiếp nhận dữ liệu (ví dụ: https://app.redai.vn/v1/wf/webhook/:id), hiển thị chữ nhỏ rõ nét kèm tính năng nhấp sao chép nhanh. |
| Tiêu đề Headers tùy chọn | 120 điểm ảnh | Huy hiệu dạng viên nhộng xám đếm số lượng tiêu đề xác thực đã thiết lập (ví dụ: 2 headers) hoặc hiển thị dấu gạch ngang nếu không cài đặt tiêu đề riêng. |
| Ngày tạo | 160 điểm ảnh | Ngày giờ khởi tạo cổng webhook theo định dạng chuẩn Việt Nam, hỗ trợ sắp xếp tăng giảm theo thời gian. |
| Thao tác | 80 điểm ảnh | Menu 3 chấm gom gọn 4 lệnh tác vụ: Xem chi tiết (mở cửa sổ thống kê và nhật ký), Chỉnh sửa (sửa tên và headers), Sao chép URL (lưu địa chỉ vào bộ nhớ tạm) và Xóa (xóa an toàn). |
Thao tác một chạm: Người dùng có thể nhấp chuột vào bất kỳ vị trí nào trên dòng dữ liệu (ngoại trừ menu tác vụ) để mở ngay cửa sổ Chi tiết Webhook với đầy đủ thống kê hiệu năng và nhật ký sự kiện.
📸 [Vị trí chèn ảnh chụp màn hình: Cận cảnh bảng danh sách cổng webhook hiển thị cột Tên, cột URL công khai, huy hiệu đếm headers và menu 3 chấm thao tác]
3. Hộp thoại Khởi tạo và Tùy biến Cổng Webhook
Hộp thoại cấu hình là cửa sổ nổi kích thước lớn với thiết kế rõ ràng, chia tách mạch lạc giữa tên định danh và phân khu thiết lập tiêu đề xác thực bảo mật.
| Khối cấu hình | Thành phần giao diện | Hướng dẫn thiết lập chuẩn xác |
|---|---|---|
| Chế độ làm việc | Tiêu đề cửa sổ | • Tạo webhook mới: Khởi tạo cổng kết nối hoàn toàn mới. • Chỉnh sửa webhook: Tải lại thông tin sẵn có để người dùng cập nhật tên hoặc thêm bớt tiêu đề xác thực. |
| Tên webhook | Ô nhập văn bản bắt buộc | Nhập tên gọi mang tính nhận diện nghiệp vụ (ví dụ: Webhook Tiếp nhận Đơn hàng Shopee, Webhook Đăng ký Khách hàng Mới). Độ dài từ 1 đến 255 ký tự. Hệ thống tự động báo lỗi chữ đỏ nếu để trống. |
| Trình chỉnh sửa Tiêu đề Headers tùy chọn | Bảng cặp Khóa và Giá trị | Cho phép người dùng quy định các tiêu đề HTTP bắt buộc phải có khi ứng dụng bên ngoài gửi gói tin đến (ví dụ: Khóa X-Secret-Key, Giá trị chuoi_bao_mat_123).• Nút Thêm dòng: Nhấp để chèn thêm một cặp tiêu đề mới. • Phát hiện lỗi tự động: Hệ thống hiển thị cảnh báo đỏ tức thời nếu người dùng nhập trùng lặp tên khóa hoặc để trống tên khóa, đồng thời khóa lệnh Lưu để chống gửi dữ liệu sai lệch lên máy chủ. • Nút Thùng rác nhỏ: Nhấp để xóa nhanh từng dòng tiêu đề không còn dùng. |
| Thanh chân hộp thoại | Cụm nút hành động góc phải | • Nút Hủy (biểu tượng dấu nhân): Đóng hộp thoại và hủy bỏ các thay đổi. • Nút Lưu (biểu tượng đĩa mềm màu xanh dương): Thực thi lưu dữ liệu lên máy chủ, tự động hiển thị biểu tượng xoay tròn khi đang lưu và gửi thông báo thành công khi hoàn tất. |
📸 [Vị trí chèn ảnh chụp màn hình: Hộp thoại tạo mới và chỉnh sửa cổng webhook với trường nhập tên và bảng thiết lập cặp tiêu đề Headers có tính năng phát hiện lỗi trùng lặp]
4. Cửa sổ Chi tiết Cổng Webhook: Thống kê Hiệu năng và Nhật ký Sự kiện
Cửa sổ Chi tiết Cổng Webhook là trung tâm giám sát vận hành thời gian thực, mở ra dưới dạng cửa sổ nổi kích thước cực lớn chia thành 2 tab chuyên biệt giúp người dùng theo dõi toàn diện lưu lượng dữ liệu và kiểm tra sự cố tại chỗ.
Tiêu đề cửa sổ hiển thị rõ tên webhook kèm nút sao chép nhanh địa chỉ URL công khai. Người dùng có thể chuyển đổi linh hoạt giữa 2 tab:
Tab 1: Thống kê hiệu năng vận hành
Bảng điều khiển 6 chỉ số đo lường hiệu năng hiển thị dưới dạng lưới thẻ phẳng 3 cột trực quan:
| Thẻ chỉ số | Biểu tượng nhận diện | Màu sắc chỉ báo | Ý nghĩa giám sát vận hành |
|---|---|---|---|
| Tổng số lần gọi | Sóng xung điện | Xám than chì | Tổng lượt yêu cầu từ các dịch vụ bên ngoài gửi đến cổng webhook kể từ khi khởi tạo. |
| Thành công | Dấu tích tròn | Xanh lá cây | Số lượt yêu cầu được hệ thống tiếp nhận trơn tru và trả về mã thành công. |
| Lỗi | Dấu nhân tròn | Đỏ cảnh báo | Số lượt yêu cầu bị lỗi do sai tiêu đề xác thực, sai cấu trúc dữ liệu hoặc lỗi máy chủ. |
| Tỷ lệ thành công | Phần trăm | Mặc định | Tỷ lệ phần trăm giữa các yêu cầu thành công trên tổng số yêu cầu, thể hiện mức độ ổn định của cổng. |
| Thời gian phản hồi trung bình | Đồng hồ bấm giờ | Mặc định | Tốc độ xử lý trung bình của máy chủ tính bằng mili-giây cho mỗi lượt gọi webhook. |
| Lần gọi gần nhất | Tờ lịch | Mặc định | Ghi nhận chính xác ngày giờ của cuộc gọi gần đây nhất hoặc hiển thị “Chưa có cuộc gọi nào”. |
Tab 2: Nhật ký gói tin sự kiện thời gian thực
Bảng nhật ký ghi lại từng sự kiện gửi đến cổng webhook với đầy đủ thông số kỹ thuật:
| Cột nhật ký | Định dạng hiển thị | Ý nghĩa kỹ thuật |
|---|---|---|
| Phương thức | Chữ in hoa đơn sắc | Phương thức gửi dữ liệu HTTP như GET, POST, PUT hoặc DELETE. |
| Mã trạng thái | Khung màu phân loại | • Màu xanh lá cây (Mã 2xx): Yêu cầu hợp lệ, hệ thống đã tiếp nhận thành công. • Màu vàng hổ phách (Mã 4xx): Lỗi từ phía người gửi (như thiếu tiêu đề, sai đường dẫn). • Màu đỏ (Mã 5xx): Lỗi xử lý từ phía máy chủ. |
| Thời gian phản hồi | Số mili-giây | Thời gian xử lý trọn vẹn của gói tin (ví dụ: 45 ms). |
| Thời điểm gọi | Ngày giờ chi tiết | Thời điểm gói tin cập bến máy chủ của nền tảng RedAI. |
| Địa chỉ IP nguồn | Dãy số IP | Địa chỉ máy chủ của dịch vụ bên ngoài đã phát đi gói tin. |
| Đã nhận sự kiện | Biểu tượng tròn | Dấu tích xanh tròn biểu thị sự kiện đã được đưa vào hàng đợi xử lý của kịch bản, dấu nhân xám biểu thị sự kiện bị từ chối. |
Trình soi chi tiết gói tin khi mở rộng dòng: Nhấp chuột vào bất kỳ hàng nhật ký nào, hệ thống sẽ mở rộng một khung chi tiết ngay bên dưới hiển thị trọn vẹn:
- Khối thông báo lỗi: Xuất hiện khung viền đỏ nếu yêu cầu bị lỗi, nêu rõ nguyên nhân từ chối.
- Tiêu đề yêu cầu: Toàn bộ danh sách tiêu đề HTTP mà ứng dụng bên ngoài đã gửi lên.
- Tham số truy vấn: Toàn bộ các tham số đính kèm phía sau dấu hỏi chấm trên đường dẫn URL.
- Nội dung gói tin gửi lên: Cấu trúc dữ liệu JSON đầy đủ do đối tác phát đi.
- Nội dung phản hồi trả về: Gói dữ liệu mà máy chủ phản hồi lại, được trang bị cơ chế bảo vệ tự động cắt ngắn ở mức 50 kilobyte để tránh làm treo trình duyệt khi gói tin quá lớn.
📸 [Vị trí chèn ảnh chụp màn hình: Cửa sổ chi tiết Webhook hiển thị tab Thống kê 6 thẻ chỉ số hiệu năng và tab Nhật ký sự kiện mở rộng chi tiết các phân khu JSON request/response]
5. Kết nối Cổng Webhook với Nút Kích hoạt trên Khung vẽ Canvas
Cổng Webhook trên màn hình quản lý liên kết hữu cơ chặt chẽ với Khung vẽ Canvas thông qua nút kích hoạt mang tên Trigger Webhook. Đây là mắt xích quan trọng giúp biến một đường dẫn tiếp nhận dữ liệu thành một quy trình tự động hóa thực thụ.
| Bước | Thao tác trên Khung vẽ Canvas | Chi tiết cấu hình kỹ thuật |
|---|---|---|
| 1 | Chèn Nút Trigger Webhook vào Canvas | Mở Ngăn kéo Thư viện Nút của Canvas, tìm kiếm nhóm sự kiện kích hoạt và kéo nút Trigger Webhook vào mặt phẳng sơ đồ. |
| 2 | Chọn Cổng Webhook đã thiết lập | Nhấp vào nút để mở cửa sổ trượt cấu hình bên sườn phải. Danh sách thả xuống tự động tải toàn bộ các Cổng Webhook đã tạo. Người dùng chỉ cần nhấp chọn cổng tương ứng (hoặc có thể tạo nhanh một cổng mới ngay tại form này). |
| 3 | Khai thác dữ liệu trong các bước tiếp theo | Khi cổng webhook nhận được gói tin từ bên ngoài, kịch bản tự động kích hoạt phiên chạy tức thì. Người dùng sử dụng các biểu thức sau để chuyển tiếp dữ liệu sang các bước kế tiếp: • Dữ liệu nội dung gửi lên: {{$node.0.main.body.ten_truong}}• Tiêu đề xác thực gửi kèm: {{$node.0.main.headers.ten_header}}• Tham số trên đường dẫn: {{$node.0.main.query.ten_tham_so}} |
📸 [Vị trí chèn ảnh chụp màn hình: Cửa sổ cấu hình Nút Trigger Webhook trên Khung vẽ Canvas hiển thị danh sách chọn cổng webhook và địa chỉ URL công khai tương ứng]
6. Dọn dẹp và Xóa an toàn Cổng Webhook
Nhằm phòng ngừa nguy cơ vô tình làm gián đoạn các luồng tích hợp đang vận hành từ các ứng dụng bên ngoài, thao tác xóa cổng webhook được bảo vệ qua hộp thoại xác nhận nghiêm ngặt.
| Bước | Thao tác thực hiện | Chi tiết ghi nhận trên hệ thống |
|---|---|---|
| 1 | Lựa chọn lệnh xóa | • Xóa một cổng: Nhấp vào menu 3 chấm trên dòng cần loại bỏ và chọn Xóa. • Xóa nhiều cổng: Tích chọn các hộp kiểm ở đầu dòng và nhấp vào biểu tượng thùng rác màu đỏ trên thanh công cụ đỉnh trang. |
| 2 | Đọc kỹ thông báo cảnh báo an toàn | Hộp thoại xác nhận an toàn mở ra, hiển thị rõ tên của cổng webhook (hoặc số lượng cổng được chọn) kèm lời nhắc nhở: Khi xóa, toàn bộ các ứng dụng bên ngoài gửi dữ liệu đến địa chỉ này sẽ nhận về thông báo lỗi không tìm thấy. |
| 3 | Xác nhận xóa khỏi hệ thống | Nhấp nút Xác nhận xóa màu đỏ. Máy chủ tiến hành thu hồi điểm cuối và cập nhật lại danh sách. Nếu có một số cổng đã bị xóa trước đó, máy chủ tự động bỏ qua và vẫn hoàn tất việc xóa các cổng hợp lệ còn lại mà không làm lỗi toàn bộ thao tác. |
📸 [Vị trí chèn ảnh chụp màn hình: Hộp thoại xác nhận xóa an toàn cổng webhook với thông điệp cảnh báo rõ ràng và nút Xác nhận xóa màu đỏ nổi bật]
Hướng dẫn thao tác qua Trợ lý ảo AI Agent
Toàn bộ các tác vụ tra cứu danh sách, lấy địa chỉ URL công khai, khởi tạo cổng mới, tùy biến tiêu đề xác thực và dọn dẹp cổng webhook trên nền tảng RedAI đều có thể được chỉ đạo trực tiếp thông qua Trợ lý ảo AI Agent.
Thông số cấu hình Kỹ năng và Bộ công cụ
| Thông số hệ thống | Giá trị cấu hình trên nền tảng RedAI |
|---|---|
| Tên Kỹ năng chuyên môn | RedAI - Module - AI Workflow |
| Mã định danh Kỹ năng | f25229db-9fad-4567-a65e-88af1e31f6a7 |
| Tên Bộ công cụ | RedAI - Module - AI Workflow |
| Mã định danh Bộ công cụ | 7c6818a0-dd73-4503-99c9-0e0d83fc9b73 |
| Quy mô công cụ sẵn sàng | 71 công cụ nghiệp vụ chính thức sẵn sàng trên hệ thống máy chủ |
Bảng đối chiếu 5 công cụ AI Agent chuyên sâu về Webhook
| Tên công cụ AI Agent | Nhóm chức năng | Tác vụ thực tế trên hệ thống |
|---|---|---|
workflow_webhook_list | Tra cứu danh sách | Quét toàn bộ danh mục các cổng webhook đang hoạt động trong không gian làm việc hoặc lọc theo từ khóa tìm kiếm. |
workflow_webhook_get_detail | Đọc cấu hình chi tiết | Lấy toàn bộ thông tin định danh, địa chỉ URL công khai và các tiêu đề xác thực đã thiết lập cho cổng webhook. |
workflow_webhook_create | Khởi tạo cổng mới | Tạo một cổng webhook mới với tên chỉ định, tự động cấp địa chỉ URL tiếp nhận và thiết lập tiêu đề xác thực tùy chọn. |
workflow_webhook_update | Cập nhật cổng | Thay đổi tên hiển thị của cổng webhook hoặc cập nhật lại danh sách các cặp tiêu đề xác thực. |
workflow_webhook_delete | Xóa an toàn | Thực hiện thu hồi và xóa an toàn điểm tiếp nhận webhook không còn nhu cầu sử dụng ra khỏi cơ sở dữ liệu. |
5 Câu lệnh mẫu chuẩn hóa dành cho Trợ lý ảo AI Agent
1. Tra cứu danh sách các cổng webhook hiện có: "Hãy liệt kê toàn bộ các cổng webhook đang hoạt động trong không gian làm việc của tôi. Cho tôi biết tên webhook, địa chỉ URL công khai và số lượng tiêu đề xác thực của từng cổng." 2. Tạo cổng webhook mới có bảo mật tiêu đề: "Hãy tạo mới một cổng webhook có tên là [webhookName] và cấu hình một tiêu đề xác thực bắt buộc với khóa [headerKey] và giá trị là [headerValue] giúp tôi." 3. Đọc chi tiết thông số và URL của cổng webhook: "Hãy kiểm tra thông tin chi tiết của cổng webhook có mã định danh [webhookId] và lấy đường dẫn URL công khai để tôi cấu hình sang ứng dụng đối tác." 4. Cập nhật tiêu đề xác thực cho cổng webhook: "Hãy cập nhật cổng webhook [webhookId] để bổ sung thêm tiêu đề xác thực mới có tên [newKey] với giá trị là [newValue]." 5. Rà soát và xóa an toàn cổng webhook cũ: "Hãy kiểm tra xem cổng webhook có mã [webhookId] có đang được gắn vào nút kích hoạt trong kịch bản nào không. Nếu an toàn, hãy xóa cổng này khỏi hệ thống giúp tôi." Bảng kiểm tra xác nhận kết quả hai chiều
| Thao tác thực hiện qua Trợ lý ảo AI Agent | Dấu hiệu phản hồi của AI Agent | Trạng thái đồng bộ trên giao diện Cổng Webhook |
|---|---|---|
| Yêu cầu tạo cổng webhook mới | Trợ lý ảo AI Agent thông báo đã khởi tạo thành công kèm địa chỉ URL công khai của webhook vừa tạo. | Khi tải lại trang, cổng webhook mới xuất hiện ngay trên bảng danh sách phẳng không viền với đầy đủ địa chỉ URL. |
| Yêu cầu cập nhật tiêu đề xác thực | Trợ lý ảo AI Agent phản hồi thông báo đã lưu các tiêu đề mới vào cấu hình webhook. | Mở hộp thoại chỉnh sửa của cổng webhook, bảng tiêu đề Headers đã được điền sẵn các cặp khóa - giá trị mới. |
| Yêu cầu xóa dọn dẹp cổng webhook | Trợ lý ảo AI Agent xác nhận đã thu hồi điểm cuối và xóa an toàn cổng webhook khỏi hệ thống. | Cổng webhook biến mất hoàn toàn khỏi bảng danh sách và không còn xuất hiện trong danh sách chọn của Canvas. |
📸 [Vị trí chèn ảnh chụp màn hình: Khung trò chuyện tương tác với Trợ lý ảo AI Agent thể hiện lệnh quản trị cổng webhook và phản hồi xác nhận thành công của AI Agent]
Bảng câu hỏi thường gặp khi quản lý cổng webhook
| Tình huống thực tế | Bản chất kỹ thuật trên nền tảng RedAI | Hướng xử lý an toàn tối ưu |
|---|---|---|
| Địa chỉ URL webhook công khai trên nền tảng RedAI có an toàn không và làm sao ngăn chặn người lạ gửi dữ liệu giả? | Mọi cổng webhook đều được cấp một đường dẫn ngẫu nhiên duy nhất trên máy chủ. Tuy nhiên, nếu đường dẫn bị lộ, người khác vẫn có thể gửi dữ liệu đến nếu không cài đặt bảo mật. | Luôn tận dụng tính năng Tiêu đề Headers tùy chọn khi tạo webhook để cài đặt một khóa bí mật (ví dụ: X-Webhook-Secret). Ứng dụng bên ngoài bắt buộc phải đính kèm tiêu đề này thì máy chủ mới chấp nhận gói tin. |
| Trường Tiêu đề Headers tùy chọn có bắt buộc phải nhập khi tạo webhook không? | Trường này hoàn toàn không bắt buộc. Nếu để trống, cổng webhook sẽ hoạt động ở chế độ mở, chấp nhận mọi gói tin hợp lệ gửi đến địa chỉ URL đó. | Để trống đối với các ứng dụng nội bộ thử nghiệm hoặc các dịch vụ không hỗ trợ tùy biến tiêu đề; bắt buộc cài đặt đối với các luồng thanh toán, tài chính hoặc đơn hàng thực tế. |
| Khi một dịch vụ bên ngoài gửi dữ liệu đến thì kịch bản mất bao lâu để kích hoạt? | Hệ thống máy chủ của nền tảng RedAI tiếp nhận gói tin qua hàng đợi xử lý siêu tốc, phản hồi mã thành công cho đối tác trong vòng vài chục mili-giây và kích hoạt kịch bản gần như tức thì theo thời gian thực. | Người dùng có thể mở tab Nhật ký trong cửa sổ chi tiết của webhook để quan sát từng gói tin cập bến và kiểm tra thời gian phản hồi thực tế. |
| Sự khác biệt giữa Mã trạng thái 2xx, 4xx và 5xx trên bảng nhật ký sự kiện là gì? | • Mã 2xx (Xanh lá): Yêu cầu hoàn toàn hợp lệ, kịch bản đã tiếp nhận xử lý. • Mã 4xx (Vàng): Lỗi từ phía đối tác gửi sai đường dẫn, thiếu tiêu đề xác thực hoặc sai cấu trúc. • Mã 5xx (Đỏ): Lỗi nội bộ phát sinh từ phía máy chủ trong quá trình tiếp nhận gói tin. | Khi thấy xuất hiện mã 4xx hoặc 5xx, hãy nhấp mở rộng dòng nhật ký đó để xem khối thông báo lỗi màu đỏ và gói dữ liệu gửi lên để tìm nguyên nhân cụ thể. |
Các bước tiếp theo và Chuyên đề liên quan
Chúc mừng người dùng đã hoàn thành chuyên đề cuối cùng trong bộ tài liệu 13 chuyên đề hướng dẫn sử dụng Phân hệ Kịch bản Tự động hóa trên nền tảng RedAI. Người dùng có thể quay lại kết nối với các phân khu nghiệp vụ cốt lõi sau:
| Chuyên đề tiếp theo | Địa chỉ truy cập chuẩn | Giá trị nghiệp vụ mang lại |
|---|---|---|
| [03. Khung vẽ Canvas và Thanh Điều hướng Thao tác](03. Khung vẽ Canvas và thanh điều hướng.md) | https://app.redai.vn/workflows/:id | Quay lại không gian Khung vẽ Canvas để chèn nút Trigger Webhook và ráp nối các sự kiện vừa thiết lập thành quy trình tự động hóa hoàn chỉnh. |
| [06. Cửa sổ trượt Cấu hình Thuộc tính Nút và Biểu thức Động](06. Cửa sổ trượt cấu hình thuộc tính nút.md) | https://app.redai.vn/workflows/:id | Nắm vững kỹ thuật trích xuất dữ liệu nội dung, tiêu đề và tham số từ gói tin webhook sang các bước xử lý kế tiếp thông qua bộ tạo biểu thức động. |
| [08. Ngăn trượt Lịch sử Phiên chạy và Đo lường Hiệu năng](08. Ngăn trượt lịch sử phiên chạy và đo lường hiệu năng.md) | https://app.redai.vn/workflows/:id | Giám sát toàn bộ các phiên chạy thực tế trong quá khứ được kích hoạt tự động từ các sự kiện webhook và phân tích biểu đồ hiệu năng vận hành. |