Định nghĩa: Connector Webhook cho phép thiết lập đường dẫn để tự động đẩy dữ liệu từ Mobio sang địa chỉ URL Webhook của ứng dụng bên thứ ba theo phương thức HTTP POST.
Lợi ích: Tự động gửi các thông điệp dữ liệu real-time khi phát sinh sự kiện trên Mobio, giúp tích hợp mượt mà với các hệ thống ERP hoặc phần mềm quản trị của doanh nghiệp.
Đối tượng sử dụng: Admin hệ thống, Kỹ sư tích hợp.
2. Giải thích Thuật ngữ & Thông số
Webhook URL: Địa chỉ API của phía đối tác/hệ thống đã sẵn sàng tiếp nhận request chứa dữ liệu từ Mobio.
Application (Ứng dụng): Ứng dụng tích hợp được đăng ký trên Mobio dùng để xác thực và ủy quyền kết nối. Một Application có thể được sử dụng linh hoạt cho nhiều connector khác nhau ở cả luồng dữ liệu vào (Data In) và luồng dữ liệu ra (Data Out). Xem hướng dẫn Quản lý ứng dụng (Application) tại đây.
Request Header (X-mevent-signature): Mã chữ ký đã được mã hóa SHA-256, tự động điền trong Header request để bên nhận xác thực dữ liệu đúng từ Mobio.
Đường dẫn truy cập: Cài đặt → Tích hợp dữ liệu → Đích dữ liệu → Thêm mới
4. Các bước thực hiện
Bước 1: Chọn thêm mới đích dữ liệu Webhook
Truy cập menu Cài đặt → Cài đặt doanh nghiệp → Tích hợp dữ liệu → Đích dữ liệu.
Bấm nút Thêm mới (hoặc Tạo mới). Tại popup, chọn loại connector, sau đó chọn Webhook.
Bước 2: Khai báo thông tin cấu hình Webhook
Điền các thông tin trong biểu mẫu thiết lập:
Tên đích đến: Đặt tên nhận diện cho connector (tối đa 200 ký tự).
Mô tả: Nhập thông tin ghi chú về mục đích sử dụng (nếu cần).
Webhook URL: Nhập chính xác địa chỉ URL để tiếp nhận request.
Application: Chọn ứng dụng ủy quyền trong danh sách dropdown (hoặc bấm “Tạo ứng dụng mới”).
Mẹo nhỏ: Một Application có thể dùng chung cho nhiều connector (bao gồm cả connector Data In và Data Out). Bạn có thể chọn lại ứng dụng đã tạo trước đó để tiếp tục sử dụng. Xem hướng dẫn Quản lý ứng dụng (Application) tại đây.
Phương thức: Mặc định là POST (để đẩy dữ liệu) và GET (để test kết nối).
Bước 3: Gửi thử nghiệm Webhook (Test Connection)
Trước khi lưu connector, bắt buộc phải kiểm tra kết nối bằng cách nhấn nút Kiểm tra kết nối.
Hệ thống sẽ gửi request mẫu đến URL Webhook, kết quả phản hồi HTTP Status Code (Response 200 OK là đạt).
Bước 4: Lưu thông tin
Sau khi kết nối thành công (mã phản hồi 200 OK), bấm nút Lưu để hoàn tất việc tạo Connector Webhook.
5. Quy tắc vận hành
Bắt buộc phải kiểm tra kết nối thành công trước khi được lưu connector.
Một Application có thể được dùng chung cho nhiều connector khác nhau trên cả luồng Data In và Data Out.
6. Các câu hỏi thường gặp (FAQ)
Hỏi: Tôi có thể dùng chung 1 Application cho cả Data In và Data Out được không?
Trả lời: Được. Nền tảng Mobio hỗ trợ 1 Application có thể được liên kết dùng chung cho nhiều connector khác nhau ở cả luồng dữ liệu vào (Data In) và luồng dữ liệu ra (Data Out). Xem hướng dẫn Quản lý ứng dụng (Application) tại đây.
Hỏi: Khi gửi thử nghiệm bị báo lỗi 404 hoặc 500 thì xử lý như thế nào?
Trả lời: Hãy kiểm tra đường dẫn Webhook URL đã nhập chính xác chưa, server đã mở port/firewall cho Mobio chưa và đường dẫn endpoint có xử lý thành công hàm nhận request không.
