VISORA AI · SỔ TAY SỬ DỤNG1 / 18

Bắt đầu trong 5 phút

Dành cho người mới: làm đúng 4 bước này trước khi khám phá các báo cáo nâng cao.

Các bước thực hiện

Đăng nhập VISORA và chọn đúng Hồ sơ doanh nghiệp/khách sạn.
Nếu là Super Admin, mở Kết nối API và tạo kênh “VISORA Public Test API”.
Bấm kiểm tra API thật, sau đó đồng bộ dữ liệu test vào Trung tâm đánh giá.
Mở Trung tâm đánh giá để xem dữ liệu đã được chuẩn hóa, cảm xúc và chủ đề.

💡 Lưu ý

Dữ liệu Public Test là dữ liệu giả lập từ dịch vụ bên ngoài, không phải đánh giá OTA thật. Mục tiêu là kiểm tra DNS/TLS/HTTPS/JSON và luồng VISORA từ đầu đến cuối.

🔗 Mở nhanh

Mở Kết nối API →Mở Trung tâm đánh giá →Trung tâm trợ giúp →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG2 / 18

Đăng ký, đăng nhập và chọn ngôn ngữ

Tài khoản VISORA dùng chung cho dashboard, tích hợp, báo cáo và hỗ trợ.

Các bước thực hiện

Người mới chọn Đăng ký/Dùng thử, khai báo email thật và mật khẩu mạnh.
Nếu đã có tài khoản, chọn Đăng nhập. Có thể đổi VI/EN ở góc trên.
Nếu quên mật khẩu, chọn Quên mật khẩu; VISORA gửi liên kết token một lần qua email.
Sau khi đăng nhập, hoàn tất Bảo mật tài khoản nếu có cảnh báo.

💡 Lưu ý

Email hệ thống/SMTP phải được Super Admin cấu hình thì luồng quên mật khẩu mới gửi mail thật.

🔗 Mở nhanh

Đăng ký →Đăng nhập →Quên mật khẩu →Bảo mật →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG3 / 18

Tạo Hồ sơ khách sạn/doanh nghiệp

Một khách sạn/cơ sở nên có một Hồ sơ doanh nghiệp riêng để mọi nguồn dữ liệu cùng trỏ về đúng nơi.

Các bước thực hiện

Tạo trang web/thương hiệu hoặc chọn hồ sơ hiện có.
Điền tên khách sạn, website và thông tin nhận diện rõ ràng.
Khi có API thật, gán Place ID/Property ID/Hotel ID/Location ID của từng nguồn vào cùng hồ sơ.
Với chuỗi khách sạn, tạo từng property riêng để benchmark và phân quyền chính xác.

💡 Lưu ý

Không cần tạo một database riêng cho Google, Booking, Agoda hoặc Tripadvisor. VISORA chuẩn hóa về cùng mô hình dữ liệu.

🔗 Mở nhanh

Thêm trang web/thương hiệu →Kết nối API →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG4 / 18

TEST NGAY: API công khai thật, không cần key

Đây là kênh kiểm thử nên dùng trước. VISORA thực sự gọi HTTPS ra Internet tới DummyJSON, nhận JSON và nhập review mẫu vào Review Hub.

Các bước thực hiện

Đăng nhập bằng Super Admin.
Mở Kết nối API → chọn đúng Hồ sơ doanh nghiệp.
Tìm card “VISORA Public Test API” → để Dataset khoảng 12 → bấm “Tạo kênh test thật”.
Bấm “Gọi API thật để kiểm tra”. Nếu thành công sẽ thấy HTTP status và số review mẫu.
Mở Trung tâm đánh giá → chọn nguồn API thử nghiệm → Đồng bộ để nhập dữ liệu remote vào pipeline.
Kiểm tra sentiment/chủ đề/bộ phận để xác nhận toàn bộ luồng hoạt động.

💡 Lưu ý

Kênh này KHÔNG phải Google/Booking/Tripadvisor và tuyệt đối không dùng làm dữ liệu kinh doanh thật. Nó chỉ chứng minh server có thể gọi API HTTPS và VISORA xử lý được phản hồi thật từ một dịch vụ bên ngoài.

🔗 Mở nhanh

Kết nối API thật để test →Trung tâm đánh giá →Tài liệu DummyJSON →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG5 / 18

Phân biệt 3 chế độ: Demo / Public Test / Live

VISORA tách ba chế độ để tránh nhầm “demo chạy được” với “API OTA đang hoạt động”.

Các bước thực hiện

Demo nội bộ: dữ liệu do VISORA tạo trong source; không gọi Internet.
Public Test API: gọi HTTPS thật tới dịch vụ test công khai; không cần key; dữ liệu tổng hợp/giả lập.
Live API: gọi Google/Booking/Tripadvisor/Agoda bằng credential chính thức và tuân thủ quyền của nguồn.
Khi chưa mua API, hãy dùng Public Test để kiểm tra hạ tầng; Demo chỉ dùng để kiểm tra giao diện/logic nhanh.

💡 Lưu ý

Khi chuyển sang Live, hãy tắt Test/Demo ở nguồn đó và kiểm tra quyền property trước khi đồng bộ dữ liệu thật.

🔗 Mở nhanh

API đánh giá trung tâm →Kết nối API →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG6 / 18

Kiến trúc API trung tâm của VISORA

Khách sạn không phải tự giữ secret của từng OTA. Super Admin cấu hình connector ở cấp nền tảng, còn tenant chỉ gán property và dùng quyền theo gói.

Các bước thực hiện

Credential thật chỉ nằm ở khu vực Super Admin.
Gói dịch vụ quyết định nguồn và giới hạn mà khách hàng được sử dụng.
Nguồn yêu cầu quyền sở hữu/property vẫn cần bước ủy quyền theo chính sách nền tảng.
VISORA Connector → Normalization Engine → Review Database → AI/Reports/Alerts.

💡 Lưu ý

Không chia sẻ credential trung tâm cho khách hàng và không hard-code secret vào source.

🔗 Mở nhanh

Quản trị API trung tâm →Gói & thanh toán →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG7 / 18

Google Places: tìm khách sạn và đối thủ

Khi có Google Places API Key chính thức, VISORA có thể tìm địa điểm theo tên, lấy Place ID và khám phá đối thủ gần đó.

Các bước thực hiện

Super Admin nhập Google Places API Key ở API đánh giá trung tâm và chuyển Google sang Live.
Tenant vào Kết nối API, nhập tên như “Diamond Sea Hotel Da Nang”, chọn đúng kết quả Google.
VISORA lưu mapping Place ID; dữ liệu Places công khai dùng để benchmark trực tiếp.
Trong Đối thủ & thứ hạng, dùng Nearby để tìm 10–20 khách sạn gần đó và chọn đối thủ cần theo dõi.

💡 Lưu ý

Google Places không phải nguồn toàn bộ lịch sử review. Muốn review đầy đủ/reply của chính khách sạn cần Google Business Profile và quyền phù hợp.

🔗 Mở nhanh

Google Places mapping →Đối thủ & thứ hạng →Google Places API docs →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG8 / 18

Booking.com: môi trường test chính thức khi có quyền Partner

Booking.com có test environment cho Guest Review API, nhưng không có credential dùng chung công khai cho mọi website.

Các bước thực hiện

Bạn cần tài khoản Connectivity Partner/Machine Account và một test property có Review API connection.
Tạo reservation trên test property, gửi review test rồi dùng Guest Review API để lấy/reply.
Khi VISORA có credential test của Booking, chuyển Booking sang Live/Test endpoint theo tài khoản được cấp.
Trước thời điểm đó, dùng VISORA Public Test API để kiểm tra hạ tầng và pipeline.

💡 Lưu ý

Không nhúng tài khoản test của một đối tác khác vào VISORA. Booking sandbox vẫn kiểm tra quyền property.

🔗 Mở nhanh

Booking connector →Hướng dẫn test Booking chính thức →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG9 / 18

Trung tâm đánh giá

Đây là nơi kiểm tra review từ các nguồn đã được VISORA nhập và chuẩn hóa.

Các bước thực hiện

Chọn khoảng thời gian hoặc nguồn để thu hẹp dữ liệu.
Xem tổng review, tốt/trung lập/xấu và điểm chuẩn hóa.
Review có thể chứa cảm xúc hỗn hợp: một câu tích cực nhưng một chủ đề vẫn tiêu cực.
Ghi chú nội bộ hoặc tạo việc xử lý từ review xấu khi cần.

💡 Lưu ý

Tổng review của nguồn và số nội dung review API đã tải/phân loại là hai khái niệm khác nhau.

🔗 Mở nhanh

Trung tâm đánh giá →Hành động & KPI →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG10 / 18

Phân tích đánh giá tiêu cực

VISORA biến bad comments thành danh sách vấn đề vận hành thay vì chỉ đếm số sao thấp.

Các bước thực hiện

Chọn Hôm nay/7 ngày/30 ngày/Tháng/Quý/Năm hoặc Từ ngày → Đến ngày.
Xem vấn đề, bộ phận, số lần đề cập, tỷ lệ tiêu cực và VISORA Impact.
Click một chủ đề để đi sâu vào các review gây ảnh hưởng.
Biến vấn đề thành Action Plan có owner, deadline và KPI.

💡 Lưu ý

Một review 8/10 vẫn có thể tạo negative topic nếu nội dung phàn nàn breakfast, check-in hoặc noise.

🔗 Mở nhanh

Phân tích review →Action Center →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG11 / 18

Đối thủ, xu hướng và thứ hạng

Đối thủ không cần là khách hàng VISORA. Hệ thống so sánh dữ liệu công khai/được cấp quyền và theo dõi thay đổi theo thời gian.

Các bước thực hiện

Thêm đối thủ thủ công hoặc tìm Nearby qua Google Places khi có API thật.
Chọn khoảng thời gian và nhóm theo ngày/tuần/tháng/năm.
So sánh điểm, review count, tỷ lệ tiêu cực và VISORA competitive rank.
Dùng snapshot để xem trước/sau và nhận diện đối thủ cải thiện nhanh.

💡 Lưu ý

VISORA rank là chỉ số benchmark nội bộ trong tập đối thủ, không phải thứ hạng Google Search.

🔗 Mở nhanh

Đối thủ & thứ hạng →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG12 / 18

Hành động & KPI: vòng khép kín

Giá trị của VISORA nằm ở việc nối vấn đề với hành động và đo kết quả sau can thiệp.

Các bước thực hiện

Từ review xấu hoặc AI recommendation, tạo Action.
Giao bộ phận/người phụ trách, đặt baseline, target và deadline.
Đo lại KPI sau một khoảng thời gian.
VISORA tính Action Effectiveness và đề xuất Tiếp tục/Điều chỉnh/Xem xét dừng.
Giải pháp hiệu quả có thể lưu thành Playbook để tái sử dụng.

💡 Lưu ý

Không đóng action tự động chỉ vì AI đề xuất; người quản lý vẫn duyệt quyết định cuối cùng.

🔗 Mở nhanh

Hành động & KPI →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG13 / 18

AI Advisor – dành cho Enterprise

AI Advisor đọc dữ liệu đã được VISORA chuẩn hóa để giải thích nguyên nhân và gợi ý chiến lược vận hành.

Các bước thực hiện

Chọn đúng property và khoảng thời gian trước khi hỏi.
Hỏi cụ thể: “Vì sao breakfast xấu hơn tháng trước?” hoặc “Điểm yếu nào làm chúng ta thua Hotel A?”.
Kiểm tra evidence, root cause, owner, KPI và timeframe mà AI đưa ra.
Chuyển recommendation thành Action/Campaign để đo kết quả.

💡 Lưu ý

AI là trợ lý ra quyết định; dữ liệu thiếu hoặc API coverage thấp phải được ghi nhận rõ trong kết luận.

🔗 Mở nhanh

AI Advisor →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG14 / 18

Phân tích tiếp thị và các nguồn kết nối

Mỗi card Marketing phải gắn với nguồn dữ liệu cụ thể để người dùng biết cần kết nối ở đâu.

Các bước thực hiện

Hiệu suất tìm kiếm → Google Search Console.
Quảng cáo trả phí → Google Ads/Meta khi connector được bật.
Uy tín địa phương → Google Business/Places.
Nhắc đến thương hiệu → review + nguồn mention được cấp phép.
Báo cáo điều hành → tổng hợp VISORA KPI và nguồn đã kết nối.

💡 Lưu ý

Nếu card báo “chờ dữ liệu”, bấm nút kết nối trên chính card để đi đến connector tương ứng.

🔗 Mở nhanh

Phân tích tiếp thị →Kết nối API →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG15 / 18

Chiến dịch xin đánh giá minh bạch

Campaign giúp đo sent/open/click/reviews generated và hỗ trợ QR/landing page.

Các bước thực hiện

Tạo campaign với ngày bắt đầu/kết thúc và target rõ ràng.
Chọn kênh review phù hợp với nguồn được hỗ trợ.
Theo dõi Sent → Opened → Clicked → Reviews generated.
Khuyến khích đánh giá trung thực; không review-gating khách không hài lòng.

💡 Lưu ý

Nội dung do AI tạo nên để Draft và được khách sạn duyệt trước khi gửi.

🔗 Mở nhanh

Chiến dịch →Tạo chiến dịch →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG16 / 18

Báo cáo, xuất dữ liệu và quản lý chuỗi

VISORA hỗ trợ báo cáo theo kỳ và cấu trúc nhiều property cho chuỗi khách sạn.

Các bước thực hiện

Chọn tuần/tháng/năm hoặc khoảng ngày tùy chỉnh.
Xuất Excel ở nơi được gói/quyền cho phép.
Corporate xem toàn chuỗi; GM/HOD chỉ xem phạm vi được cấp.
Dùng benchmark giữa property để phát hiện best practice nội bộ.

💡 Lưu ý

Không cấp quyền toàn chuỗi cho HOD nếu họ chỉ cần dữ liệu của một bộ phận/property.

🔗 Mở nhanh

Báo cáo KPI →Nhân viên & quyền →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG17 / 18

Bảo mật tài khoản & lấy lại mật khẩu

Trước khi public, hãy hoàn tất Security Center và luồng email reset password.

Các bước thực hiện

Bật Security Mode và TOTP/Passkey cho Super Admin/Owner.
Cấu hình SMTP ở Email hệ thống và gửi thử email.
Kiểm tra Quên mật khẩu: link token phải dùng một lần và hết hạn.
Không chia sẻ API key, APP_KEY, encryption key hoặc file .env qua ticket/chat công khai.

💡 Lưu ý

Nếu hệ thống cảnh báo “Tài khoản chưa được bảo vệ đầy đủ”, xử lý cảnh báo trước khi vận hành production.

🔗 Mở nhanh

Security Center →Email hệ thống →Quên mật khẩu →

VISORA AINền tảng phân tích uy tín khách sạn

VISORA AI · SỔ TAY SỬ DỤNG18 / 18

Trợ giúp, Support và checklist trước khi Live

Khi gặp lỗi, dùng Help Center trước rồi tạo Support ticket với thông tin vừa đủ để chẩn đoán.

Các bước thực hiện

Tìm từ khóa trong Trung tâm trợ giúp; Logbook cũng được index trong tìm kiếm.
Nếu chưa giải quyết được, tạo ticket Support và ghi URL/màn hình/thao tác gây lỗi.
Trước Live API: test Public API → test SMTP → test bảo mật → backup DB → nhập credential thật → test từng connector.
Sau khi Live, theo dõi logs, rate limits, sync failures và quyền property.

💡 Lưu ý

Không gửi password, client secret hoặc API key nguyên văn trong Support ticket.

🔗 Mở nhanh

Trung tâm trợ giúp →Liên hệ hỗ trợ →Nhật ký cập nhật →

VISORA AINền tảng phân tích uy tín khách sạn