ResolveHQ: Hệ thống helpdesk tự vận hành trên hạ tầng Cloudflare

ResolveHQ là một hệ thống helpdesk mã nguồn mở, được thiết kế để chạy hoàn toàn trên nền tảng Cloudflare và có thể tự triển khai trong tài khoản của chính bạn. Dự án hướng đến các nhóm hỗ trợ khách hàng nhỏ, giúp họ quản lý hộp thư chung, phân công ticket và xử lý email chuyên nghiệp mà không cần vận hành máy chủ riêng. Điểm đáng chú ý là ResolveHQ kết hợp Cloudflare Workers, D1, R2 và Queues để tạo ra một giải pháp gọn nhẹ nhưng vẫn đầy đủ tính năng.

Những gì ResolveHQ có thể làm

ResolveHQ cung cấp một hộp thư chung với khả năng cách ly dữ liệu khách hàng theo từng tổ chức, quản lý ticket, phân công, trạng thái, mức độ ưu tiên, thẻ tag và tìm kiếm toàn văn.

Người dùng có thể đăng ký với vai trò chủ sở hữu, mời đồng nghiệp tham gia và quản lý các vai trò Owner/Admin/Agent thông qua bộ chuyển đổi không gian làm việc giữa nhiều tổ chức khác nhau.

Hệ thống xử lý luồng email theo đúng chuẩn RFC 5322, có khả năng chống giả mạo tiêu đề giữa các ticket. Thư đến được nhận qua Cloudflare Email Routing, thư đi gửi qua Resend, kèm theo trạng thái gửi, cơ chế thử lại và webhook có tính idempotent.

Giao diện điều khiển ResolveHQ

Tính năng nổi bật dành cho đội hỗ trợ

• Trả lời nhanh hơn với các mẫu trả lời sẵn, ghi chú nội bộ, phản hồi do AI soạn thảo (tùy chọn bật) và giao diện hộp thư ba khung mượt mà, có xử lý xung đột phiên bản.
• Đặt lại mật khẩu và chấp nhận lời mời qua email hệ thống, dùng chung nhà cung cấp với email ticket.
• Xuất bản trung tâm trợ giúp công khai từ các bài viết trong cơ sở tri thức, trong khi bản nháp được giữ riêng tư cho nhóm.
• Theo dõi khối lượng và tốc độ phản hồi trong phần Báo cáo, xuất dữ liệu theo khoảng thời gian ra CSV và tự động hóa phân loại bằng các quy tắc.
• Thông báo trong ứng dụng khi có ticket được phân công hoặc khách hàng phản hồi, hỗ trợ cả chế độ sáng và tối.
• Xuất toàn bộ dữ liệu khách hàng dưới dạng JSON hoặc xóa vĩnh viễn theo quy trình có thể tiếp tục, đồng thời hủy các email đang chờ trong hàng đợi.
• Tự phục hồi: tác vụ cron năm phút một lần sẽ thử lại các job email bị kẹt và dọn dẹp dữ liệu tạm hoặc mồ côi.

Đặc biệt, tính năng hỗ trợ AI được kiểm soát theo từng không gian làm việc. Mặc định nó ở trạng thái tắt cho đến khi quản trị viên bật trong phần Cài đặt, và chỉ khi đó nội dung hội thoại ticket mới được gửi đến OpenAI.

Kiến trúc và cách vận hành

ResolveHQ chạy dưới dạng một Cloudflare Worker duy nhất trong tài khoản của bạn. Framework Hono đảm nhận cả REST API lẫn ứng dụng React đã build sẵn.

• Cloudflare D1 lưu trữ ticket và khách hàng.
• Cloudflare R2 lưu trữ tệp đính kèm.
• Cloudflare Queues vận chuyển các job email vào và ra.
• Cloudflare Email Routing đưa thư đến Worker, còn Resend gửi thư đi.

Toàn bộ ticket và tệp đính kèm được lưu trong tài khoản Cloudflare của bạn, chỉ có nội dung email gửi đi là đi qua Resend.

Chi phí vận hành

ResolveHQ có thể chạy trên gói miễn phí của Cloudflare cho các triển khai nhỏ, miễn là mức sử dụng nằm trong giới hạn hiện tại của Workers, D1, R2, Queues, Cron Triggers và Email Routing.

Tuy nhiên, các tác vụ xác thực hoặc phân tích email tiêu tốn nhiều CPU có thể yêu cầu gói Workers trả phí. R2 cần kích hoạt và thiết lập thanh toán riêng, còn Resend xử lý email gửi đi theo giới hạn của họ.

Đối với độc giả Việt Nam đang cân nhắc giải pháp helpdesk, ResolveHQ là lựa chọn đáng thử vì chi phí thấp và không phụ thuộc vào nhà cung cấp SaaS nước ngoài. Tuy nhiên, bạn cần một tên miền trỏ về Cloudflare và có thể phải đăng ký thanh toán quốc tế để dùng R2.

Triển khai và phát triển cục bộ

Cách nhanh nhất để bắt đầu là dùng nút Deploy to Cloudflare. Bạn cần có tài khoản Cloudflare, một tên miền trên Cloudflare để thiết lập Email Routing, và tùy chọn một tài khoản Resend với tên miền gửi đã xác minh.

Sau khi triển khai, bạn mở URL ResolveHQ, đăng ký làm chủ sở hữu và thêm quy tắc Email Routing trong bảng điều khiển Cloudflare để chuyển thư đến Worker.

Để phát triển cục bộ, quy trình gồm các bước cài đặt gói, sao chép tệp biến môi trường, chạy migration và seed cơ sở dữ liệu, sau đó khởi động máy chủ phát triển. Ứng dụng Vite chạy trên cổng 5173 và chuyển tiếp các yêu cầu API đến Wrangler trên cổng 8787.

Cấu hình tùy chọn

• Hỗ trợ AI: đặt biến OPENAI_API_KEY (và tùy chọn OPENAI_MODEL, mặc định là gpt-4o-mini) làm secret của Worker.
• Lưu trữ ticket: đặt TICKET_RETENTION_DAYS để tự động xóa ticket đã giải quyết hoặc đóng sau số ngày nhất định, bao gồm cả tệp đính kèm.

Hiện tại dự án chưa hỗ trợ giao diện đa ngôn ngữ và thông báo ngoài ứng dụng như email tổng hợp. Với giấy phép mở, ResolveHQ hứa hẹn là một lựa chọn thú vị cho các nhóm hỗ trợ muốn kiểm soát hoàn toàn dữ liệu của mình trên nền tảng cloud hiện đại.