Webhook
Cách cấu hình webhook trong VergeOS cho nhắn tin dạng push tới các hệ thống bên ngoài, bao gồm tạo webhook, thiết lập payload của tác vụ và cấu hình trình kích hoạt sự kiện.
Webhook cho phép nhắn tin theo cơ chế đẩy tới các hệ thống bên ngoài khi các sự kiện cụ thể xảy ra. Khi một sự kiện kích hoạt diễn ra, webhook sẽ gửi một yêu cầu HTTP (thường là POST) tới một URL được định sẵn. Cơ chế đẩy này hiệu quả hơn việc thăm dò định kỳ cho cả thông báo lẫn tự động hóa quy trình, vì hệ thống nhận không cần kiểm tra cập nhật theo chu kỳ.
Ví dụ sử dụng Webhook
Webhook của VergeOS cho phép cấu hình linh hoạt cao cho giao tiếp dựa trên sự kiện với các hệ thống bên thứ ba, cung cấp nhiều cơ hội tinh gọn. Các ví dụ cơ bản sau đây minh họa cảnh báo và tự động hóa quy trình làm việc có thể thực hiện bằng webhooks:
Gửi thông báo Slack tới kênh quản trị khi một tác vụ đồng bộ phát sinh lỗi
Gửi đến hệ thống kế toán khi một tenant VergeOS hoạt động, kích hoạt tính phí tự động
Kích hoạt một quy trình Zapier khi một VM cụ thể bật lên, khởi tạo các hành động xuyên ứng dụng (ví dụ: báo cáo, email, thông báo, v.v.)
Các bước cấu hình
Để đưa webhook vào hoạt động, hãy làm theo các bước sau:
Tạo một Webhook: xác định URL đích, phương thức xác thực và mọi header tùy chỉnh mà hệ thống bên ngoài yêu cầu
Tạo một Tác vụ: xác định payload cần gửi
Tạo một Sự kiện: chỉ định một sự kiện sẽ kích hoạt tác vụ
Thiết kế mô-đun
Danh sách Công cụ Tác vụ VergeOS cho phép điều phối linh hoạt webhooks, tác vụ và sự kiện. Bạn có thể gán nhiều tác vụ hoặc sự kiện cho một webhook duy nhất, và một tác vụ duy nhất có thể được kích hoạt bởi nhiều sự kiện khác nhau. Kiến trúc ghép nối linh hoạt này hỗ trợ các quy trình làm việc có thể mở rộng, tái sử dụng, phù hợp với nhu cầu của hệ thống bạn.
Tạo một Webhook
Đi tới Hệ thống > Bảng điều khiển Tác vụ.
Nhấp Webhook mới ở menu bên trái.
Cấu hình webhook:
Tên: Cung cấp một tên mô tả cho webhook.
URL: Nhập endpoint API do hệ thống đích cung cấp để nhận các yêu cầu HTTP POST.
Thông thường, bạn sẽ cần cấp cho hệ thống VergeOS của mình quyền truy cập rõ ràng vào endpoint này trên hệ thống đích
Loại ủy quyền
Mã thông báo Bearer - Chỉ nhập chuỗi bearer token (Không bao gồm từ "Bearer")
Khóa API - Chỉ nhập chuỗi khóa API thô. (Không bao gồm bất kỳ tiền tố hay từ khóa nào)
Cơ bản - Nhập tên người dùng và mật khẩu vào các trường nhập được cung cấp.
Không
Header
Theo mặc định, một header được bao gồm để chỉ định payload content-type: application/json. Header này có thể được xóa hoặc chỉnh sửa khi cần, và có thể cấu hình thêm các header bổ sung theo yêu cầu hoặc được hệ thống đích hỗ trợ (ví dụ: thay đổi kiểu nội dung, định tuyến sự kiện, giới hạn tốc độ, mức ưu tiên, v.v.) - Để thay đổi thứ tự của các header tùy chỉnh: chọn ô kiểm của (các) header mong muốn và dùng các nút mũi tên Lên/Xuống - Dùng nút Dấu cộng để thêm header bổ sung - Nút bút chì chuyển đổi giữa việc nhập cặp khóa/giá trị header và nhập thủ công cú pháp đầy đủ của header
Cho phép chứng chỉ không an toàn: Tùy chọn này nhằm hỗ trợ chứng chỉ tự ký cho môi trường kiểm thử/phát triển. Việc sử dụng chứng chỉ không an toàn cho hệ thống và dữ liệu sản xuất (đặc biệt là các URL công khai) là rủi ro và không được khuyến nghị.
Hết thời gian chờ: Xác định số giây tối đa để chờ phản hồi từ hệ thống đích (phải từ 3 trở lên)
Thử lại: Số lần thử lại khi không có phản hồi hoặc có lỗi trả về từ hệ thống đích
Nhấp Gửi để lưu webhook.
Tạo một Tác vụ
Đi tới Hệ thống > Bảng điều khiển Tác vụ.
Nhấp Tác vụ mới ở menu bên trái.
Cấu hình tác vụ:
Tên: Cung cấp một tên mô tả cho tác vụ.
Mô tả (tùy chọn): Có thể lưu trữ thêm thông tin cho tác vụ, ví dụ: mục đích, kết quả mong đợi, v.v.
Xóa tác vụ sau khi chạy: xác định một lần kích hoạt duy nhất; hệ thống sẽ tự động xóa tác vụ sau khi nó đã chạy một lần.
Loại đối tượng: Webhook
Đối tượng: Chọn webhook đã tạo ở bước trước.
Hành động: Gửi
Tin nhắn: Xác định payload sẽ gửi tới hệ thống bên ngoài. - Payload mặc định bao gồm một cặp khóa-giá trị cơ bản với chuỗi "Webhook" làm giá trị; xóa hoặc sửa đổi khi cần để tạo payload mong muốn.
Có thể sử dụng các biến trong payload của tin nhắn:
${DATE} - ngày/giờ hiện tại ở định dạng chuỗi đầy đủ, ví dụ: Thu, 16 Oct 2025 11:38:07 EDT
${TIMESTAMP} - ngày/giờ hiện tại ở dạng giá trị số (thời gian epoch), ví dụ: 1760629087
${RANDOM} - số nguyên được tạo ngẫu nhiên
${NAME} - tên của đối tượng VergeOS tương ứng
Nhấp Gửi để lưu tác vụ.
Tạo một Sự kiện
Đi tới Hệ thống > Bảng điều khiển Tác vụ.
Nhấp Sự kiện mới ở menu bên trái.
Cấu hình sự kiện:
Kiểu: Chọn khu vực tương ứng của hệ thống VergeOS nơi trình kích hoạt sẽ xảy ra.
Sự kiện: Danh sách sự kiện sẽ thay đổi tùy theo loại đã chọn ở trên. Chọn sự kiện mong muốn sẽ đóng vai trò là trình kích hoạt.
Chọn một phiên bản đối tượng cụ thể hoặc thẻ để kích hoạt sự kiện: (Một số loại đã chọn, chẳng hạn như Cảnh báo áp dụng ở mức chung và không cung cấp tùy chọn cho thẻ hoặc đối tượng cụ thể.)
Chọn một phiên bản cụ thể của loại đối tượng từ danh sách thả xuống (Ví dụ: "Users" là loại đã chọn - chọn một người dùng cụ thể từ Người dùng danh sách thả xuống; "Virtual Machines" là loại đã chọn - chọn một VM cụ thể từ Máy ảo danh sách thả xuống.)
HOẶC
Bật Dùng thẻ và chọn một thẻ khả dụng từ danh sách thả xuống để dựa sự kiện trên các đối tượng có thẻ tương ứng đó. (Ví dụ: nếu "Virtual Machines" là loại đã chọn và "production" được chọn trong Thẻ danh sách thả xuống, trình kích hoạt sự kiện sẽ tương ứng với bất kỳ VM nào được gán thẻ "production".)
Tác vụ: Chọn tác vụ đã tạo ở bước trước.
Nhấp Gửi để lưu sự kiện.
Tương thích phiên bản: Chức năng này có sẵn trong VergeOS 26.0 trở lên.
Cập nhật lần cuối
Nội dung này có hữu ích không?