Dán link lớp học trực tuyến của riêng bạn
Giảng viên có thể dán link Zoom, Microsoft Teams hoặc nền tảng khác vào lớp học trực tiếp. Học viên vào lớp bằng một nút, không cần biết lớp chạy trên nền tảng nào.
Trạng thái tính đến 1 Oct 2026
- Giai đoạn
- Đang review. Một PR đang mở. Chưa merge vào main, chưa lên beta, chưa có trong tag production.
- PR
- #510 chứa toàn bộ thay đổi: cột "meeting_provider" và migration, quy tắc backend, form giảng viên, nút của học viên, bản dịch en và vi. Đã rebase lên main (sau SP-390) và thêm một commit nhỏ đổi nhãn ô nhập thành "URL link lớp học" ngày 1 Oct 2026; ảnh 2 và 3 chụp lại sau thay đổi này, video vẫn hiện nhãn cũ "Link lớp học".
- Ticket
- SP-769, thuộc ticket cha SP-768 (kế hoạch tích hợp Google Meet, Zoom, Teams theo tài khoản của từng tenant).
- Ảnh và video
- Tất cả ảnh và video được quay trên stack local với dữ liệu giả. Tên lớp, tên tenant và link đều không phải dữ liệu thật.
Vì sao có tính năng này
Trước đây mọi lớp học trực tiếp đều lấy link Google Meet từ một tài khoản Google Workspace duy nhất của SkillPixel. Tenant nào cũng dùng chung tài khoản đó, nên giảng viên bên ngoài không thể dạy trên Zoom hay Teams mà họ đã quen. Các tenant khác cũng không nên chạy lớp trên tài khoản Google của SkillPixel.
Bước này thêm cách rẻ nhất để gỡ nút thắt đó. Giảng viên tự tạo phòng học trên nền tảng mình chọn, rồi dán link vào bài học. Việc kết nối tài khoản Google, Zoom, Teams của từng tenant sẽ làm ở các ticket sau.
Thay đổi trong một hình
Tạo lớp học trực tiếp
Giảng viên nhập tiêu đề, thời gian bắt đầu và kết thúc như trước.
Chọn nguồn link
Tenant mặc định chọn Google Meet tự động hoặc dán link. Tenant khác chỉ có ô dán link.
Lưu
Link phải bắt đầu bằng https://. Hệ thống lưu link kèm nguồn của nó.
Học viên vào lớp
Nút "Tham gia lớp học trực tuyến" mở link trong tab mới, 15 phút trước giờ bắt đầu.
Video demo
Hai video ngắn, không có tiếng. Chấm xanh là con trỏ chuột.
Tenant mặc định (Skill Pixel QA), khoảng 49 giây
Bạn sẽ thấy gì
- Form tạo lớp mở ra, "Tự động tạo link Google Meet" được chọn sẵn, giống cách làm cũ.
- Giảng viên nhập tiêu đề, chuyển sang "Dán link của tôi" và dán một link Zoom.
- Bấm Lưu. Lớp được tạo và giữ nguyên link đã dán, không gọi Google.
- Trang học viên của lớp Zoom: nút "Tham gia lớp học trực tuyến" sáng vì lớp đang diễn ra.
- Trang học viên của lớp Google Meet: nút vẫn là "Tham gia lớp Google Meet" như cũ.
Tenant khác (Học viện Demo A), khoảng 50 giây
Bạn sẽ thấy gì
- Form tạo lớp chỉ có một ô "Link lớp học". Không có lựa chọn Google Meet.
- Bấm Lưu khi chưa có link: form báo "Vui lòng nhập link lớp học".
- Dán link Zoom rồi Lưu. Lớp được tạo.
- Trang học viên của lớp Teams với nút "Tham gia lớp học trực tuyến".
- Lớp cũ tạo trước cập nhật vẫn giữ link Google Meet của nó trong ô link.
Cách dùng
-
Mở form tạo lớp học trực tiếp
Trong khoá học, bấm "Thêm bài học" rồi chọn "Lớp học trực tiếp". Ở tenant mặc định, mục "Link lớp học" có hai lựa chọn. Google Meet được chọn sẵn, nên ai không đổi gì thì vẫn làm việc như cũ.
Tenant mặc định. Hai lựa chọn dưới "Link lớp học". Ô "URL đến lớp học trực tuyến" chỉ đọc, ghi "Chưa tạo" vì link Meet chỉ sinh ra sau khi lưu. -
Chọn "Dán link của tôi" và dán link
Ô "Link lớp học" xuất hiện. Dán link từ Zoom, Microsoft Teams, Google Meet hoặc nền tảng khác. Bất kỳ tên miền nào cũng được, nhưng link phải bắt đầu bằng https://.
Sau khi chọn "Dán link của tôi", ô "URL link lớp học" nhận một link Zoom và có dòng hướng dẫn bên dưới. -
Lưu. Link sai bị chặn ngay trên form
Link http:// hoặc thiếu tên miền không lưu được. Backend kiểm tra lại cùng quy tắc, nên gọi API trực tiếp cũng không lách được.
Link "http://zoom.us/..." bị từ chối với thông báo "Vui lòng nhập link hợp lệ bắt đầu bằng https://". -
Mở lại lớp đã lưu
Khi sửa lớp, form nhớ lựa chọn đã dùng. Lớp dán link hiện link trong ô có thể sửa. Lớp Google Meet hiện link Meet thật trong ô chỉ đọc. Đổi từ Google Meet sang dán link sẽ huỷ sự kiện Google cũ. Đổi ngược lại sẽ tạo link Meet mới khi lưu.
Lớp "Buổi 4: Ôn tập qua Zoom". "Dán link của tôi" được chọn, link Zoom nằm trong ô sửa được. 
Lớp "Buổi 3: Hàm và module (Google Meet)". Google Meet được chọn, link meet.google.com do hệ thống tạo trên stack local. -
Học viên vào lớp
Học viên không thấy nguồn link. Nút vào lớp ghi "Tham gia lớp học trực tuyến" với link dán, và vẫn ghi "Tham gia lớp Google Meet" với lớp Meet. Nút chỉ bật từ 15 phút trước giờ bắt đầu đến khi lớp kết thúc, và mở link trong tab mới.
Lớp Zoom, trạng thái "Đang diễn ra", nút "Tham gia lớp học trực tuyến". 
Lớp Google Meet giữ nút "Tham gia lớp Google Meet" như trước. -
Ở tenant khác, chỉ có ô dán link
Tenant không phải mặc định không được tạo link Google Meet tự động nữa. Form chỉ có một ô "Link lớp học" bắt buộc. Backend từ chối yêu cầu tạo Google Meet từ tenant này bằng lỗi 400.
Tenant "Học viện Demo A". Một ô "Link lớp học" có dấu bắt buộc, không có lựa chọn Google Meet. 
Bấm Lưu khi ô link còn trống: "Vui lòng nhập link lớp học". -
Lớp cũ ở tenant khác vẫn chạy
Lớp được tạo trước cập nhật giữ link Google Meet của nó. Khi mở lại, link nằm sẵn trong ô. Nếu giảng viên không đổi link, lớp giữ nguyên nguồn Google. Nếu đổi sang link khác, lớp chuyển sang link dán.
Lớp mới "Buổi 1: Speaking Part 1 trên Microsoft Teams" với link Teams đã dán. 
Lớp cũ "Buổi 2". Link meet.google.com được giữ trong ô link và vẫn hoạt động cho học viên. 
Học viên của tenant khác thấy nút "Tham gia lớp học trực tuyến" cho lớp Teams.
Đọc màn hình
| Mục | Ý nghĩa | Ví dụ |
|---|---|---|
| Tự động tạo link Google Meet | Hệ thống tạo sự kiện Google Calendar kèm link Meet sau khi lưu. Chỉ có ở tenant mặc định. | https://meet.google.com/yzh-vdxj-gfq |
| Dán link của tôi | Giảng viên tự tạo phòng học và dán link. Hệ thống không gọi Google. | https://zoom.us/j/98765432100?pwd=demoSP769 |
| Link lớp học (ô nhập) | Bắt buộc khi dán link. Phải bắt đầu bằng https://, tối đa 2048 ký tự, tên miền nào cũng được. | Link Teams dài hơn 60 ký tự vẫn nhận |
| URL đến lớp học trực tuyến (ô chỉ đọc) | Link Meet do hệ thống tạo. "Chưa tạo" khi lớp chưa lưu hoặc tạo Meet thất bại. | Chưa tạo |
| Nút vào lớp của học viên | "Tham gia lớp học trực tuyến" với link dán, "Tham gia lớp Google Meet" với lớp Meet. Bật từ 15 phút trước giờ bắt đầu. | Đang diễn ra |
Vì sao tin được
- Nguồn link được lưu cùng lớp. Mỗi lớp học trực tiếp có thêm cột "meeting_provider" với hai giá trị GOOGLE_MEET và MANUAL. Lớp cũ nhận GOOGLE_MEET khi chạy migration, nên không có lớp nào mất link.
- Tenant khác không thể dùng tài khoản Google của SkillPixel. Backend trả lỗi 400 khi một tenant không phải mặc định yêu cầu Google Meet, dù gọi thẳng API.
- Trình duyệt cũ không xoá được link đã dán. Khi form cũ (đã cache) không gửi trường nguồn link, backend giữ nguyên link và nguồn hiện có.
- Kiểm thử tự động. Backend: 1941 unit test và 36 test lớp học trực tiếp chạy trên database đều pass. Frontend: 569 test và build pass. Migration đã chạy lên, xuống, lên lại trên database tạm.
Kiểm tra tay. Link Meet trong ảnh 5 và 7 được tạo thật qua Google Calendar từ stack local, không phải chuỗi gõ tay. Sau demo, lớp đó sẽ bị huỷ để xoá sự kiện trên lịch.
Giới hạn đã biết
- Chỉ dán link, chưa tự tạo phòng Zoom hay Teams. Giảng viên phải tạo phòng học trên nền tảng của họ trước. Việc tự tạo phòng bằng tài khoản của tenant nằm ở SP-773 (Google), SP-774 (Zoom), SP-775 (Teams).
- Tenant khác mất tính năng Google Meet tự động. Đây là quyết định, không phải lỗi. Lớp cũ của họ vẫn giữ link, nhưng lớp mới phải dán link.
- Link dán không tự cập nhật hay huỷ trên nền tảng gốc. Đổi giờ hoặc huỷ lớp trong LMS không đổi gì trên Zoom hay Teams. Giảng viên tự chỉnh bên đó.
- Học viên có thể đọc link sớm hơn 15 phút nếu gọi thẳng API bài học thay vì bấm nút. Lỗi này có từ trước, theo dõi ở SP-776.
- Endpoint đồng bộ Meet hàng loạt cho cả khoá bị lỗi 500 từ trước và frontend không dùng nó. Theo dõi ở SP-777.
- Lớp nhân bản giữ nguồn "dán link" nhưng không có link. Giảng viên phải dán link mới trước khi học viên vào được.
Quyết định đã chốt
| Câu hỏi | Lựa chọn |
|---|---|
| Tenant mặc định có đổi gì không? | Giữ nguyên Google Meet tự động làm mặc định, thêm "Dán link của tôi" làm lựa chọn thứ hai. |
| Tenant khác dùng gì? | Chỉ dán link. Không tạo Google Meet mới từ tài khoản SkillPixel. Lớp cũ giữ link. |
| Link nào được nhận? | Bất kỳ tên miền, bắt buộc https://, tối đa 2048 ký tự, bắt buộc khi chọn dán link. |
| Đổi tên cột link cũ? | Không. "meet_join_url" vẫn là cột link chung cho mọi nguồn, thêm cột "meeting_provider". |
| Thứ tự làm tiếp | Google Meet theo tài khoản tenant trước, rồi Zoom, rồi Teams. Nút "Kết nối với ..." để sau vì cần vendor duyệt app. |
Checklist triển khai
- Merge PR #510. Một PR, không xếp chồng.
- Migration "f7d2c3f3ced2" thêm một cột có giá trị mặc định, chạy nhanh và tương thích với bản backend cũ. Không có config hay job mới.
- Kiểm tra trên beta: tạo một lớp dán link ở tenant mặc định và ở một tenant khác, mở trang học viên trong khung 15 phút, bấm nút vào lớp. Mở lại một lớp Google Meet cũ ở tenant khác và lưu mà không đổi link, kiểm tra link còn nguyên.
- Chuyển SP-769 sang Testing sau khi lên beta, và sang Done khi có trong tag production.