Bỏ qua, đến nội dung chính
Công nghệ khách sạn

API, webhook, MQTT và MCP

Bốn từ này chỉ bốn cách để hệ thống này nói chuyện với hệ thống khác. API là hỏi và nhận theo yêu cầu, webhook là được báo khi có sự kiện, MQTT là kênh nhắn tin nhẹ cho thiết bị, MCP là cách để trợ lý AI đọc dữ liệu. Khách sạn nên biết khi nào cần cái nào, và ai sở hữu dữ liệu đi ra.

6 phút đọcCập nhật 08/11/20262 nguồnThông lệ, mỗi nơi điều chỉnh

Biên soạn: Đội ngũ nghiệp vụ TingHotel.

Bốn cách nói chuyện, bốn việc khác nhau

Cách Ai khởi đầu Ví dụ trong khách sạn
API Hệ ngoài hỏi Kế toán lấy doanh thu theo mã giao dịch mỗi tối
Webhook Phần mềm báo Báo cho hệ chấm công khi nhân viên vào ca
MQTT Thiết bị phát, máy chủ nhận Thiết bị biên gửi thay đổi trạng thái phòng
MCP Trợ lý AI hỏi Quản lý hỏi tối qua phòng nào bị DND quá lâu

Không cái nào thay cái nào. Một khách sạn có thể dùng cả bốn ở các chỗ khác nhau.

Khi nào chỉ cần xuất Excel?

Nếu kế toán hay nhân sự chỉ cần số liệu cuối ngày hoặc cuối tháng, xuất CSV hoặc Excel là đủ và ít rủi ro hơn. API chỉ đáng làm khi dữ liệu phải chạy liên tục, lặp lại và không muốn ai phải xuất tay.

Nguyên tắc tốt là xuất dữ liệu sạch, người dùng tự tổng hợp. Xem bài dữ liệu sạch cho kế toán và nhân sự.

Quyền và khóa truy cập

Mỗi khóa API nên gắn với một quyền hẹp, không dùng một khóa quản trị cho mọi việc. Khóa lộ thì chỉ lộ phần được cấp, và thu hồi được riêng từng khóa.

Với trợ lý AI, quyền chỉ đọc là mặc định hợp lý. Việc ghi dữ liệu nghiệp vụ nên đi qua người có quyền trên màn hình thường, để còn nhật ký ai đã làm gì.

Nên hỏi nhà cung cấp phần mềm gì?

  1. API có tài liệu công khai không, có giới hạn tần suất gọi không?
  2. Webhook gửi lại thế nào khi hệ nhận bị lỗi?
  3. Khóa API cấp theo quyền nào, thu hồi ra sao?
  4. Dữ liệu cá nhân của khách đi ra ngoài qua API có được ghi vết không?
  5. Làm tích hợp mới thì tính phí một lần hay theo tháng?

Sai ở đâu thường gặp?

  • Cấp một khóa toàn quyền cho nhà thầu rồi quên thu hồi.
  • Làm webhook mà không lưu sự kiện để gửi lại.
  • Đưa dữ liệu khách vào trợ lý AI công cộng mà chưa kiểm tra chính sách dữ liệu.
  • Tích hợp xong không ai chịu trách nhiệm theo dõi khi hệ ngoài đổi giao diện.

TingHotel hỗ trợ thế nào?

Xuất Excel và CSV cho mọi bảng nghiệp vụ có từ gói Operations. API mở bằng khóa API, MCP chỉ đọc, nhận chấm công và nhân sự từ hệ ngoài, nhận phí từ POS thuộc gói Enterprise, làm theo dự án. Trên đường từ khách sạn lên máy chủ, thiết bị biên dùng MQTT.

Xem bài bảo mật và phân quyền hệ thống.

Hỏi nhanh

API và webhook khác nhau thế nào?
API là hệ ngoài chủ động hỏi để lấy hoặc gửi dữ liệu. Webhook là phần mềm chủ động báo cho hệ ngoài khi có sự kiện, ví dụ vừa check-in. Dùng API khi cần lấy theo lịch, dùng webhook khi cần phản ứng ngay.
MQTT dùng để làm gì?
Là giao thức nhắn tin nhẹ theo mô hình đăng ký và phát, hay dùng cho thiết bị IoT. Trong hệ điều khiển phòng, nó là đường để thiết bị biên gửi thay đổi trạng thái lên máy chủ.
MCP là gì?
Model Context Protocol là giao thức mở để trợ lý AI nối với nguồn dữ liệu và công cụ. Với khách sạn, nó cho phép quản lý hỏi số liệu bằng câu thường mà không cần mở báo cáo.
Trợ lý AI có sửa được dữ liệu khách sạn không?
Với MCP chỉ đọc của TingHotel thì không. Trợ lý chỉ xem được những gì khóa truy cập cho phép và không ghi.
TingHotel hỗ trợ thế nào

Trong phần mềm

Xuất dữ liệu sạch qua Excel, CSV

Từ gói Operations

Mọi bảng nghiệp vụ xuất được, không cần API. Phù hợp khi kế toán hoặc nhân sự tự tổng hợp.

API mở bằng khóa API

Từ gói Enterprise

Truy xuất dữ liệu từ hệ thống ngoài theo quyền được cấp cho khóa.

MCP chỉ đọc cho trợ lý AI

Từ gói Enterprise

Cho trợ lý hỏi số liệu vận hành bằng ngôn ngữ thường, chỉ đọc, không ghi.

Nhận chấm công và phí từ hệ thống ngoài

Từ gói Enterprise

Chấm công, nhân sự từ hệ ngoài qua API hoặc webhook. Phí từ POS ghi vào phòng. Làm theo dự án.

Xem TingHotel chạy trên một khách sạn mẫu

Đội kỹ thuật HDL Việt Nam trình diễn sơ đồ phòng, check-in, cảnh báo SOS và app khách trên bộ điều khiển phòng thật hoặc RCU ảo.