Appearance
Trợ lý lộ trình AI (trang /roadmap)
Trợ lý lộ trình là một trang công khai nơi khách chưa có tài khoản trò chuyện với một trợ lý AI, kể mục tiêu và hoàn cảnh của mình, rồi nhận một bản đồ lộ trình học vẽ từ đúng những khoá học trong catalog của bạn. Bản đồ là lý do để khách tạo tài khoản, bắt đầu khoá miễn phí và mua khoá trả phí.
Ba công cụ thu hút khách khác nhau ở đâu
- Trợ lý tư vấn trả lời câu hỏi của khách về khoá học và mời để lại số.
- Phễu khảo sát đưa khách qua một bộ câu hỏi do bạn soạn và chấm ra nhóm kết quả cố định.
- Trợ lý lộ trình không có bộ câu hỏi soạn sẵn: AI hỏi theo hoàn cảnh của từng người và vẽ một bản đồ riêng cho người đó. Bạn không dựng gì cả, chỉ bật trang, viết lời chào và giữ catalog gọn.
Dùng trợ lý lộ trình khi catalog đủ rộng để có nhiều đường đi khác nhau và bạn muốn khách cảm thấy được lắng nghe trước khi được chào bán.
Màn hình quản trị:
- Cài đặt -> Cài đặt chung, tab Trang lộ trình cho khách: bật trang, tiêu đề, lời chào, mục tiêu mẫu, lộ trình mẫu.
- Cài đặt -> AI, tab Trợ lý lộ trình cho khách: model và các trần chi phí.
- Khách hàng tiềm năng -> Bản đồ lộ trình của khách: đọc lại từng cuộc trò chuyện và bản đồ.
Module RoadmapFunnel phải được bật cho tenant, và tenant phải có Gemini API key (xem Bật và cấu hình).
Khách thấy gì
Khách mở https://<tên-miền>/roadmap. Trang không có menu, không có footer, chỉ có logo của bạn.
Màn đầu
Một màn duy nhất, một hành động:
- Tiêu đề và dòng dẫn (bạn sửa được trong cài đặt).
- Ba mục tiêu mẫu dạng nút, ví dụ "Kế toán, muốn tự động hoá báo cáo Excel hằng tuần". Bấm một nút là vào thẳng cuộc trò chuyện với câu đó được gửi luôn.
- Nút Bắt đầu trò chuyện cho khách muốn kể bằng lời mình.
- Dải dưới: ghi chú "Khoảng 2 phút, hoặc kể bằng lời của bạn", số lộ trình đã vẽ (chỉ hiện khi đã có từ 10 bản trở lên) và link Xem một lộ trình mẫu (chỉ hiện khi bạn đã chọn một bản mẫu). Trang không nói về số khoá học trong catalog.
- Bản xem trước một bản đồ đã vẽ xong ở bên phải: ba chặng, mỗi chặng hai khoá, nhãn miễn phí hay trả phí. Nếu bạn chọn lộ trình mẫu thì bản xem trước lấy từ chính bản đó.
Trò chuyện
Trợ lý mở lời trước bằng lời chào bạn viết và hỏi khách muốn học để làm gì. Mỗi lượt trợ lý nhắc lại điều vừa hiểu rồi hỏi đúng một câu tiếp theo. Bên trái là thẻ Thông tin của bạn với năm mục: Mục tiêu, Bạn đang ở đâu, Thời gian mỗi tuần, Mốc mong muốn và Ưu tiên riêng (tuỳ chọn). Mỗi điều khách kể được tick vào một mục; đủ để vẽ thì thẻ báo "đủ để vẽ".
Khi đủ thông tin, trợ lý tóm tắt lại và hỏi "Vẽ nhé?". Khách bấm Đúng rồi, vẽ đi hoặc Sửa một ý để nói lại. Quá số lượt hỏi tối đa (mặc định 6) thì trợ lý bắt buộc tóm tắt và vẽ với những gì đã có.
Câu chữ nào là của AI, câu chữ nào là của bạn
Lời chào đầu, các nút xác nhận và mọi nút bấm là chuỗi cố định, không tốn lời gọi AI. Mọi câu trợ lý trả lời sau đó, tóm tắt bản đồ, lý do từng bước đều do AI viết và được gắn nhãn "AI viết cho bạn" trên trang.
Vẽ bản đồ
Bản đồ được vẽ nền trong vài chục giây. Khi xong, các chặng hiện lần lượt, mỗi chặng kèm một câu trợ lý giải thích vì sao chặng đó có mặt. Nếu quá 90 giây chưa xong, trợ lý báo là mất lâu hơn dự kiến và giữ đường dẫn để khách quay lại. Nếu vẽ hỏng (AI lỗi, thiếu khoá API), trợ lý nói thật và đưa nút Thử lại.
Bản đồ
- Tiêu đề kèm số tuần, đoạn tóm tắt AI viết từ lời khách, ba con số: số tuần với số giờ mỗi tuần, số kỹ năng và số chặng, số khoá học và số khoá miễn phí.
- Thanh "bạn đã biết": khách đánh dấu kỹ năng đã biết thì số tuần và số giờ tiết kiệm đổi ngay.
- Đồ thị: chặng ở cột giữa (màu vàng), kỹ năng toả hai bên; viền đậm là kỹ năng bắt buộc, viền mảnh là bổ trợ; mỗi kỹ năng ghi tên khoá, nhãn Miễn phí hay giá, số giờ và số bài.
- Bấm một kỹ năng mở ngăn chi tiết: Vì sao dành cho bạn (AI trích đúng chi tiết khách đã kể), khoá học, các chương sẽ học, thời lượng, giá. Ba nút Học, Tôi đã biết, Để sau; với khoá miễn phí có thêm Học miễn phí ngay mở thẳng cổng giữ lộ trình.
- Bảng Lộ trình này dựa trên gì: từng dòng nối một câu khách nói với một quyết định của AI. Lời khách là trích nguyên văn; AI không được bịa lời khách chưa nói.
Trang của khách không nói về những chủ đề catalog chưa có. Thông tin đó chỉ hiện trong màn hình quản trị để bạn biết catalog thiếu gì.
Sửa bằng chat
Khung chat vẫn mở sau khi vẽ. Hai loại yêu cầu được xử lý ngay, không tốn AI:
- Đổi thời gian: "Tôi chỉ có 3 giờ mỗi tuần" giãn lại số tuần, giữ nguyên các bước.
- Đã biết một kỹ năng: "Tôi đã biết SQL" đánh dấu kỹ năng đó và rút số tuần.
Yêu cầu khác ("tôi thích FastAPI hơn Django", "bỏ phần thiết kế") đi qua AI và vẽ lại bản đồ; kỹ năng vừa đổi mang nhãn mới đổi, bảng căn cứ ghi thêm một dòng. Khách được số lượt sửa bằng AI bạn đặt (mặc định 3). Hết lượt, trợ lý mời tạo tài khoản để sửa tiếp không giới hạn trong Learnspace.
Lời đề nghị giữ lộ trình
Có hai chỗ, cùng nội dung: trong khung chat ngay sau câu kết của trợ lý, và dưới bản đồ sau bảng căn cứ. Trên điện thoại có thêm một thanh dính ở đáy màn hình với nút Giữ lộ trình: thanh hiện khi khách đã cuộn qua chặng đầu và tự ẩn khi khách tới phần lời đề nghị dưới bản đồ. Mỗi chỗ có giá (tổng các khoá trả phí, hoặc Miễn phí), dòng "N khoá học, M miễn phí, X tuần", ba quyền lợi, nút Giữ lộ trình và bắt đầu học và Sao chép link. Khách đã giữ thì hai chỗ này biến mất, thay bằng thẻ Đã giữ vào tài khoản trên đầu bản đồ.
Giữ lộ trình vào tài khoản
Cổng chỉ hỏi tên và email; số điện thoại là tuỳ chọn (ẩn nếu tenant không bật module Khách tiềm năng). Có ô đồng ý để tư vấn viên liên hệ (câu chữ lấy từ cài đặt Khách tiềm năng) và ô nhận tin ưu đãi.
| Tình huống | Chuyện gì xảy ra |
|---|---|
| Khách đã đăng nhập sẵn | Bản đồ vào tài khoản đó ngay, không hỏi tên và email |
| Email chưa có tài khoản | Hệ thống tạo tài khoản, đăng nhập, ghi danh khoá miễn phí đầu tiên trong bản đồ (nếu có), gửi email đặt mật khẩu |
| Email đã có tài khoản | Hệ thống gửi link đăng nhập một lần vào email, hiệu lực 60 phút. Khách mở link là bản đồ về đúng tài khoản. Trang không nói với người đang gõ rằng email này đã tồn tại |
Sau khi giữ, khách được đưa tới lộ trình cá nhân trong Learnspace (nếu tenant bật module Lộ trình học tập; cuộc trò chuyện được nối tiếp ở đó), không thì tới bài đầu của khoá miễn phí, không nữa thì ở lại trang với thẻ Đã giữ vào tài khoản.
Khách tick đồng ý liên hệ thì hệ thống tạo thêm một hồ sơ khách tiềm năng; không tick thì không có hồ sơ và không ai gọi. Xem Lead từ trợ lý lộ trình.
Link chia sẻ và người xem
Mỗi bản đồ có một đường dẫn riêng /roadmap/<mã>. Người khác mở link chỉ xem: thấy bản đồ; không thấy cuộc trò chuyện, tên hay email của chủ. Họ không sửa được và được mời Kể cho trợ lý về tôi để có bản của riêng mình.
Trình duyệt của khách nhớ cuộc trò chuyện trong 30 ngày: đóng tab giữa chừng, hôm sau mở /roadmap là tiếp tục đúng chỗ. Muốn làm lại từ đầu, khách bấm Vẽ bản đồ mới.
Khi không có khoá phù hợp
Khách muốn học thứ catalog không dạy (ví dụ tiếng Nhật ở một trung tâm lập trình) thì trợ lý nói thật là chưa có khoá phù hợp và gợi ý các nhóm khoá gần nhất, thay vì ghép một bản đồ gượng ép.
Bật và cấu hình
Điều kiện:
- Quản trị hệ thống bật module RoadmapFunnel cho tenant.
- Tenant có Gemini API key (trang cấu hình AI). Không có key thì mọi lượt trò chuyện đều báo lỗi ngay câu đầu.
- Nên bật Turnstile trong cài đặt bảo vệ biểu mẫu: khách lạ phải qua Turnstile ở câu nói đầu tiên và ở cổng giữ lộ trình. Không bật cũng chạy được, nhưng bot sẽ tiêu lời gọi AI của bạn.
Trang lộ trình cho khách
Cài đặt -> Cài đặt chung, tab Trang lộ trình cho khách:
| Trường | Ghi chú |
|---|---|
| Mở trang cho khách | Mặc định tắt. Tắt thì /roadmap trả về 404 |
| Tiêu đề, Dòng dẫn | Hiện ở màn đầu. Mặc định: "Lộ trình học đúng mục tiêu của bạn, trong 2 phút." |
| Tên trợ lý | Hiện ở đầu khung chat và trong nhãn ở màn đầu |
| Lời chào đầu | Câu đầu tiên trợ lý nói. Không tốn lời gọi AI. Nên kết bằng một câu hỏi mở |
| Ví dụ mục tiêu | Ba đến bốn ví dụ, mỗi ví dụ một hoàn cảnh khác nhau. Hiện thành nút ở màn đầu và thành chip dưới lời chào |
| Lộ trình mẫu | Dán link (hoặc mã) của một bản đồ đã vẽ đẹp. Màn đầu dùng nó làm bản xem trước và link "Xem một lộ trình mẫu". Để trống thì dùng bản xem trước chung, không có link |
| Ảnh chia sẻ | Hiện khi link được dán vào nhóm chat. Tỉ lệ 1200x630 |
Chọn lộ trình mẫu thế nào
Vào Bản đồ lộ trình của khách, lọc trạng thái Đã vẽ, mở một bản có mục tiêu phổ biến và bản đồ đẹp (ba chặng trở lên, có khoá miễn phí). Sao chép link ở cột địa chỉ của trang khách (dạng /roadmap/<mã>) rồi dán vào ô Lộ trình mẫu. Bản mẫu bị xoá hay không còn ở trạng thái Đã vẽ thì màn đầu tự rơi về bản xem trước chung, không cần bạn sửa gì.
Trợ lý lộ trình cho khách (AI)
Cài đặt -> AI, tab Trợ lý lộ trình cho khách:
| Trường | Mặc định | Ghi chú |
|---|---|---|
| Model | gemini-2.5-flash | Mỗi lượt khách nói là một lời gọi model; chọn model nhanh và rẻ |
| Temperature | 0,4 | |
| Số token tối đa mỗi lời gọi | 8192 | Trần cho lượt vẽ. Lượt hỏi tự hạ xuống 1024 |
| Ngân sách thinking | 0 | 0 là tắt, rẻ và đủ nhanh |
| Số lượt hỏi tối đa | 6 | Sau ngần này lượt, trợ lý bắt buộc tóm tắt và vẽ |
| Lời gọi AI mỗi bản đồ | 12 | Tổng hỏi, vẽ, sửa, thử lại cho một khách |
| Lượt sửa bằng AI cho khách | 3 | Hết lượt thì mời tạo tài khoản. 0 là không cho khách sửa bằng AI |
| Lời gọi AI mỗi ngày (toàn tenant) | 800 | Chạm trần thì trợ lý xin lỗi khách và mời quay lại sau. 0 là không giới hạn, không khuyên |
| Lời gọi AI mỗi IP mỗi giờ | 40 | Chặn một người hay một bot độc chiếm trợ lý |
Khách chưa đăng nhập không có ví credit, nên các trần này là thứ duy nhất chặn hoá đơn. Người đã đăng nhập được miễn trần ngày.
Chi phí thực tế
Một khách đi hết luồng (5 lượt hỏi, một lượt vẽ, hai lượt sửa) với model flash tốn khoảng vài phần nghìn đô la. Con số thật của tenant bạn nằm ở chỉ số Chi phí AI mỗi bản đồ trong Trung tâm báo cáo, và ở mục Chi phí và model của từng bản đồ. Xem thêm Theo dõi chi phí AI.
Đọc lại bản đồ khách đã vẽ
Khách hàng tiềm năng -> Bản đồ lộ trình của khách liệt kê mọi cuộc trò chuyện, kể cả những cuộc bỏ dở. Cột: mục tiêu khách kể, trạng thái (Đang trò chuyện, Đang vẽ, Đã vẽ, Hỏng), độ phủ catalog, số tuần, số lời gọi AI, email, đã giữ hay chưa, lead. Tìm theo mục tiêu để gom những khách cùng nhu cầu.
Mở một bản để đọc:
- Điều trợ lý đã hiểu về khách: mục tiêu, hiện tại, giờ mỗi tuần, mốc, ưu tiên.
- Hội thoại nguyên văn. Đây là thứ đáng đọc nhất: khách mô tả nhu cầu bằng ngôn ngữ của họ, và những câu đó là chất liệu cho quảng cáo và trang khoá học.
- Bản đồ: từng kỹ năng, khoá học, chặng và khách đã đánh dấu gì.
- Căn cứ: lời khách và quyết định của AI.
- Kỹ thuật: độ phủ catalog, các chủ đề khách muốn mà catalog chưa có, lý do hỏng, chi phí và model, nguồn truy cập.
Catalog thiếu gì
Cột Độ phủ catalog và mục chủ đề ngoài catalog chỉ hiện ở đây, không hiện với khách. Báo cáo từ khoá trong mục tiêu gom các từ khách hay nhắc; từ nào xuất hiện nhiều mà bản đồ toàn Phủ một phần là gợi ý cho khoá học kế tiếp.
Nút Xoá trên một bản đồ xoá cả hội thoại và thông tin khách; đây là cách xử lý yêu cầu xoá dữ liệu cá nhân. Hệ thống không lưu địa chỉ IP hay thông tin trình duyệt của khách.
Lead từ trợ lý lộ trình
Khi khách giữ lộ trình và tick đồng ý liên hệ, hệ thống tạo hồ sơ khách tiềm năng với nguồn Trợ lý lộ trình AI. Hồ sơ mang:
- Tóm tắt: mục tiêu, hiện tại, số giờ mỗi tuần, mốc, số tuần của bản đồ, các khoá trên bản đồ và tổng giá.
- Câu đồng ý đúng như khách đã thấy, kèm thời điểm tick.
- Nguồn truy cập từ tham số UTM nếu khách đến từ link theo dõi.
Hồ sơ đi vào vòng chia tự động như mọi nguồn khác. Xem Khách tiềm năng.
Đo hiệu quả
Chỉ số nằm trong nhóm Thu hút của Bảng điều hành và Trung tâm báo cáo. Mọi tỉ lệ tính theo lứa: mẫu số là những khách bắt đầu trò chuyện trong kỳ.
| Chỉ số | Nghĩa |
|---|---|
| Lượt trò chuyện với trợ lý | Số khách nói câu đầu tiên. Người mở trang rồi thoát không tính |
| Tỉ lệ gật đầu cho vẽ | Trong số người bắt đầu, bao nhiêu đi hết pha hỏi và đồng ý vẽ |
| Bản đồ đã vẽ | Số bản đồ vẽ thành công |
| Tỉ lệ vẽ hỏng | Tăng là xấu. Gồm cả lỗi AI, thiếu khoá API, hàng đợi kẹt |
| Tỉ lệ giữ vào tài khoản | Chỉ số chính: trong số bản đồ đã vẽ, bao nhiêu được giữ vào tài khoản |
| Tỉ lệ đồng ý tư vấn | Trong số người giữ bản đồ, bao nhiêu tick đồng ý liên hệ |
| Tỉ lệ bấm mua | Trong số bản đồ đã vẽ, bao nhiêu có ít nhất một cú bấm sang thanh toán. Là cú bấm, không phải đơn hàng |
| Số lượt hỏi trung bình | Khách nói bao nhiêu câu trước khi vẽ, tính trên các cuộc đã tới lượt vẽ |
| Chi phí AI mỗi bản đồ | Chi phí Gemini trung bình cho một bản đồ đã vẽ |
Chưa có dữ liệu thì chỉ số hiện dấu gạch, không hiện 0%.
Báo cáo đi kèm: rơi rụng theo bước (bắt đầu, nói từ 2 câu, gật đầu, vẽ xong, chạm bản đồ, bấm giữ, giữ xong), theo độ phủ catalog, từ khoá trong mục tiêu, theo khoá học trên bản đồ (khoá nào hay xuất hiện, hay bị đánh "đã biết", bản đồ chứa nó có được giữ không), và bấm giữ từ chỗ nào (trong khung chat, dưới bản đồ, chip, gõ tay, ngăn chi tiết, thanh dính trên điện thoại).
Ai được cấp quyền gì
| Quyền | Cho phép làm gì |
|---|---|
configure_roadmap_funnel | Sửa tab Trang lộ trình cho khách |
configure_roadmap_funnel_ai | Sửa tab Trợ lý lộ trình cho khách (model, trần chi phí) |
view_any_guest_roadmap, view_guest_roadmap | Đọc bản đồ và hội thoại của khách, xem chỉ số và báo cáo |
delete_guest_roadmap, delete_any_guest_roadmap | Xoá bản đồ (xoá dữ liệu cá nhân) |
Vai trò mặc định: admin có đủ; marketer có cấu hình trang, đọc và xoá bản đồ, nhưng không sửa trần chi phí AI; sales chỉ đọc. Vai trò tự tạo trong Vai trò & phân quyền thì tích các quyền tương ứng.
Câu hỏi thường gặp
/roadmap trả về trang 404. Một trong hai: module RoadmapFunnel chưa bật cho tenant, hoặc ô Mở trang cho khách đang tắt.
Trợ lý trả lời "không kết nối được" ngay câu đầu. Tenant chưa có Gemini API key, key hết hạn mức, hoặc trần lời gọi AI mỗi ngày đã chạm. Kiểm tra trang cấu hình AI và chỉ số Tỉ lệ vẽ hỏng trước khi báo lỗi.
Số "lộ trình đã vẽ" không hiện ở màn đầu. Nó chỉ hiện khi đã có từ 10 bản đồ vẽ thành công. Con số nhỏ là phản chứng, không phải bằng chứng.
Khách bảo link đăng nhập không dùng được. Link có hiệu lực 60 phút và mỗi email chỉ nhận tối đa 3 link mỗi giờ. Nếu bản đồ đó đã được giữ vào một tài khoản khác trước khi link được mở, trang báo link không còn hiệu lực.
Khách muốn xoá dữ liệu. Mở Bản đồ lộ trình của khách, tìm theo email hoặc mục tiêu, bấm Xoá. Hồ sơ khách tiềm năng (nếu có) xoá riêng ở trang Khách tiềm năng.
Đổi lời chào có làm hỏng các cuộc trò chuyện đang dở không? Không. Lời chào mới chỉ áp cho khách mới; cuộc trò chuyện đang dở giữ nguyên nội dung đã có.