Lịch sử gửi webhook - Theo dõi và tra soát các lần gửi
Tab Lịch sử gửi webhook ghi lại toàn bộ các lần hệ thống gửi webhook cho cửa hàng — thành công hay thất bại — giúp bạn theo dõi vận hành và tra soát khi có sự cố.
Tổng quan
Truy cập Cài đặt → Cài đặt cửa hàng → API Key, chọn tab Lịch sử gửi webhook. Bảng danh sách hiển thị các cột:
| Cột | Ý nghĩa |
|---|---|
| Thời gian | Thời điểm sự kiện được ghi nhận |
| Sự kiện | Loại sự kiện (ví dụ: Đơn hàng được tạo, Đổi số điện thoại...) |
| Trạng thái | Chờ gửi / Đã gửi / Thất bại |
| Số lần thử | Số lần hệ thống đã gửi (bao gồm cả các lần thử lại) |
| HTTP status | Mã phản hồi từ máy chủ nhận ở lần gửi gần nhất |
| Thao tác | Nút Xem để mở chi tiết |
Bộ lọc
Có thể lọc danh sách theo:
- Sự kiện — chọn một loại sự kiện cụ thể
- Trạng thái — Chờ gửi / Đã gửi / Thất bại
- Khoảng ngày — chọn từ ngày đến ngày
Ý nghĩa các trạng thái
| Trạng thái | Ý nghĩa |
|---|---|
| Chờ gửi (cam) | Đang trong hàng đợi hoặc đang chờ tới lượt thử lại |
| Đã gửi (xanh) | Máy chủ nhận đã phản hồi mã 2xx |
| Thất bại (đỏ) | Đã thử đủ 4 lần nhưng đều không thành công |
Khi một lần gửi lỗi (máy chủ trả mã lỗi, quá thời gian 10 giây, không kết nối được...), hệ thống tự động thử lại theo lịch giãn cách: sau 5 phút → 30 phút → 3 giờ. Tổng cộng tối đa 4 lần gửi; hết lượt mà vẫn lỗi thì bản ghi chuyển sang Thất bại.
Xem chi tiết một lần gửi
Nhấn Xem ở dòng bất kỳ để mở cửa sổ chi tiết, gồm:
- Loại sự kiện và trạng thái
- Số lần thực hiện và mã HTTP phản hồi
- Thời điểm gửi thành công
- URL đã gửi tới
- Payload JSON đầy đủ — đúng nội dung
datađã gửi sang máy chủ nhận - Thông báo lỗi gần nhất (nếu có)
Khắc phục sự cố thường gặp
| Hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| Nhiều bản ghi Thất bại, HTTP status trống | Máy chủ nhận không truy cập được (sập, sai domain, chặn firewall) | Kiểm tra máy chủ nhận; dùng nút Kiểm tra ở tab Webhook để xác nhận URL còn sống |
| Thất bại với mã 401 / 403 | Máy chủ nhận từ chối xác thực | Đối chiếu cấu hình header / Secret giữa hai bên |
| Thất bại với mã 404 | Sai đường dẫn endpoint | Kiểm tra lại URL trong tab Webhook |
| Thất bại với mã 429 | Máy chủ nhận giới hạn tần suất request (rate limit) — nhiều sự kiện gửi dồn dập vượt ngưỡng cho phép | Tăng rate limit phía nhận cho IP/route nhận webhook, hoặc xử lý bất đồng bộ (trả 200 ngay rồi queue xử lý sau) để không bị nghẽn khi có nhiều sự kiện liên tiếp. Hệ thống hiện thử lại theo lịch cố định (5 phút → 30 phút → 3 giờ), không tự giãn cách thêm theo header Retry-After |
| Thất bại với mã 500 | Lỗi xử lý phía máy chủ nhận | Xem payload trong chi tiết lần gửi, tái hiện lỗi phía bên nhận |
| Trạng thái Chờ gửi kéo dài | Đang chờ tới lượt thử lại theo lịch (tối đa 3 giờ) | Chờ hệ thống thử lại hoặc kiểm tra máy chủ nhận trước lượt kế tiếp |
| Không thấy bản ghi nào phát sinh | Webhook chưa Kích hoạt, hoặc sự kiện chưa được đăng ký | Mở tab Webhook kiểm tra công tắc Kích hoạt và danh sách sự kiện đã chọn |
Payload trong cửa sổ chi tiết là đúng dữ liệu đã gửi đi — chia sẻ nội dung này cho đội kỹ thuật bên nhận là cách nhanh nhất để xác định lỗi nằm ở phía nào.
Hiện chưa hỗ trợ gửi lại thủ công một bản ghi thất bại từ giao diện — hệ thống chỉ thử lại tự động theo lịch. Nếu bản ghi đã Thất bại (hết 4 lượt), sự kiện đó cần được đối soát lại qua API dữ liệu tương ứng.