# Webhooks

Nhận sự kiện của HiTechCloud qua webhook HTTPS: cảnh báo hạn mức, tạo và thu hồi khoá API, hoá đơn và trạng thái nguồn dữ liệu, kèm khoá ký để xác minh.

_Nguồn: https://developers.hitechcloud.vn/tai-lieu/webhooks · Tài liệu HiTechCloud Developers_

Webhook là địa chỉ HTTPS của bạn mà hệ thống gọi khi có sự kiện. Tạo và quản lý trong Cổng khách hàng, mục **Webhook**.

- Chỉ nhận địa chỉ **HTTPS công khai** — địa chỉ nội bộ, loopback hoặc link-local bị từ chối.
- Khoá ký dạng `whsec_…` **chỉ hiện một lần** khi tạo; dùng nó để xác thực nguồn gửi.
- Có thể tạm dừng / bật lại một webhook; lịch sử các lần gửi gần nhất hiện trong Cổng khách hàng.

## Sự kiện

| Sự kiện | Khi nào |
| --- | --- |
| `key.created` | Có người tạo khoá mới trong tổ chức. |
| `key.revoked` | Một khoá bị thu hồi. |
| `key.expiring` | Còn 7 ngày là khoá hết hạn. |
| `quota.threshold` | Đã dùng 80% hạn mức tháng. |
| `quota.exceeded` | Đã dùng hết hạn mức tháng. |
| `source.down` | Một nguồn dữ liệu ngoài ngừng phản hồi. |
| `member.joined` | Có người nhận lời mời vào tổ chức. |
| `invoice.issued` | Hoá đơn kỳ mới đã lập. |
| `access.approved` / `access.denied` | Đơn xin quyền endpoint hạn chế được duyệt / từ chối. |
| `announcement.published` | Quản trị hệ thống công bố thông báo. |

> Cấu trúc chi tiết của nội dung và header chữ ký sẽ được công bố tại đây khi dịch vụ gửi webhook chính thức mở.
