Cơ chế Retry và Thông báo kết nối Webhook

1. Tổng quan

Định nghĩa: Cơ chế Retry (tự động gửi lại) và Thông báo gián đoạn kết nối là hai tính năng xử lý sự cố mặc định của Mobio khi quá trình đẩy dữ liệu qua Webhook gặp lỗi (như server đối tác quá tải, mất kết nối hoặc phản hồi lỗi 5xx).
Lợi ích:
- Đảm bảo tính toàn vẹn dữ liệu, tránh mất mát thông tin khi hệ thống đối tác gặp sự cố tạm thời.
- Cảnh báo kịp thời qua email cho người quản trị khi Webhook bị gián đoạn để chủ động kiểm tra, xử lý.
Đối tượng sử dụng: Admin hệ thống, CS.

Tần suất retry: tần suất tự động gửi lại dữ liệu lỗi theo các khoảng thời gian tăng dần (5 phút, 5 phút, 10 phút, 15 phút, 25 phút, 40 phút…).
Tự động ngắt kết nối: Khi phát sinh lỗi liên tục quá 6 lần thông báo (khoảng 1 giờ), hệ thống sẽ tự động chuyển connector sang trạng thái Ngắt kết nối để bảo vệ tài nguyên.

Bài viết trước: Danh sách Event đồng bộ qua Webhook.
Phân quyền truy cập RBAC chi tiết (Role-Based Access Control):
- Nhóm chức năng chính (Module): Tích chọn nhóm INTEGRATION (Tích hợp).
- Đường dẫn phân quyền chi tiết: Cài đặt > Cài đặt doanh nghiệp > Đồng bộ dữ liệu > Data Flow > Đích đến.
- Quyền thao tác: Cần có quyền Xem chi tiết và Sửa Đích đến để nhập danh sách email nhận thông báo gián đoạn kết nối tại tab Thông báo kết nối.
- Xem hướng dẫn thiết lập & phân quyền truy cập RBAC chi tiết tại đây.

Khi một bản tin Webhook bị lỗi (phản hồi khác 200 OK hoặc quá 2 giây không phản hồi):

Hệ thống tự động lưu bản tin bị lỗi vào hàng chờ retry.
Lần retry đầu tiên được thực hiện sau 5 phút kể từ khi xảy ra lỗi.
Các lần retry tiếp theo được thực hiện theo các khoảng thời gian tăng dần.
Hệ thống duy trì thử lại tối đa trong vòng 3 ngày. Sau 3 ngày, nếu vẫn bị lỗi, bản tin sẽ dừng và không thể thử lại. Dữ liệu lỗi được lưu trữ trong 7 ngày trước khi bị xóa vĩnh viễn.

Ngay khi phát sinh lượt đẩy dữ liệu lỗi đầu tiên, hệ thống gửi email thông báo lần 1 tới danh sách email đã đăng ký tại tab Thông báo kết nối.
Nếu sự cố tiếp diễn, hệ thống sẽ duy trì việc gửi email cảnh báo 10 phút/lần (tối đa 6 lần).
Sau 6 lần gửi cảnh báo liên tục (tương đương 1 giờ) mà kết nối chưa phục hồi, hệ thống tự động chuyển Connector Webhook sang trạng thái Ngắt kết nối và gửi email thông báo ngắt kết nối lần cuối cùng.

Sau khi bên đối tác đã sửa lỗi server Webhook, Admin truy cập Cài đặt → Tích hợp dữ liệu → Đích dữ liệu.
Chọn Connector Webhook tương ứng và bấm nút Bật kết nối để khôi phục tiến trình đồng bộ dữ liệu.

Luồng gửi email thông báo chạy độc lập với luồng retry dữ liệu.
Khi connector chuyển sang trạng thái Ngắt kết nối, luồng thu thập event sẽ dừng cho đến khi Admin chủ động bấm Bật kết nối lại.

Hỏi: Nếu server Webhook của tôi bị chết trong 2 tiếng, dữ liệu có bị mất không?
- Trả lời: Không. Trong 2 tiếng đó, hệ thống Mobio đã lưu các bản tin lỗi và luồng Retry sẽ liên tục thử gửi lại trong 3 ngày. Sau khi bạn khắc phục server xong và bấm “Bật kết nối” lại trên Mobio, dữ liệu trong hàng chờ retry sẽ tiếp tục được đẩy bình thường.