ვირტუალური გაკვეთილები

შესთავაზეთ პირდაპირი ონლაინ გაკვეთილები Zoom-ის, Google Meet-ის ან Microsoft Teams-ის მეშვეობით. როდესაც გაკვეთილს ვირტუალურად მონიშნავთ, BailaYa ავტომატურად ქმნის შეხვედრას დაკავშირებულ პლატფორმაზე და აზიარებს ბმულს ჩარიცხულ მოსწავლეებთან.

წინაპირობები

ვირტუალური გაკვეთილების შექმნამდე დაუკავშირეთ მინიმუმ ერთი ვიდეო პლატფორმა პარამეტრები → ინტეგრაციები-ში:

• Zoom — საჭიროა Zoom API-ის წვდომის ტოკენი
• Google Meet — საჭიროა Google Calendar API-ის წვდომის ტოკენი (შეხვედრები იქმნება როგორც Calendar-ის მოვლენები Meet-ის ბმულებით)
• Microsoft Teams — საჭიროა Microsoft Graph API-ის წვდომის ტოკენი

tip

თქვენ მხოლოდ იმ პლატფორმების კონფიგურაცია გჭირდებათ, რომელთა გამოყენებასაც გეგმავთ. ვირტუალური გაკვეთილის ვარიანტი გაკვეთილის შექმნის ფორმაში მხოლოდ მაშინ ჩანს, როდესაც მინიმუმ ერთი პლატფორმაა დაკავშირებული.

პლატფორმის დაკავშირება

1. გადადით პარამეტრები → ინტეგრაციები-ზე.
2. გადაახვიეთ ვირტუალური გაკვეთილების პლატფორმები-ის განყოფილებამდე.
3. არჩეული პლატფორმისთვის:
   • გადართეთ გადამრთველი ჩართულ მდგომარეობაში.
   • ჩასვით თქვენი წვდომის ტოკენი (იხილეთ პლატფორმის სპეციფიკური დოკუმენტაცია ქვემოთ).
   • Google Meet-ისთვის სურვილისამებრ მიუთითეთ კალენდრის ID (ნაგულისხმევად იყენებს თქვენს მთავარ კალენდარს).
   • დააჭირეთ შენახვა-ს.

წვდომის ტოკენების მიღება

პლატფორმა	სად მიიღოთ ტოკენი
Zoom	Zoom Marketplace — შექმენით სერვერ-სერვერის OAuth აპლიკაცია ან გამოიყენეთ პირადი წვდომის ტოკენი
Google Meet	Google Cloud Console — ჩართეთ Calendar API და შექმენით OAuth2 სერთიფიკატები
Microsoft Teams	Azure Portal — დაარეგისტრირეთ აპლიკაცია და მიანიჭეთ OnlineMeetings.ReadWrite ნებართვა

ვირტუალური გაკვეთილის შექმნა

1. გახსენით განრიგი და დააჭირეთ გაკვეთილის შექმნა-ს (ან შეცვალეთ არსებული გაკვეთილი).
2. შეავსეთ გაკვეთილის დეტალები ჩვეულებისამებრ (სახელი, დრო, ინსტრუქტორი და ა.შ.).
3. ფორმის ბოლოში ნახავთ ვირტუალური გაკვეთილის გადამრთველს (ჩანს მხოლოდ თუ პლატფორმა დაკავშირებულია).
4. ჩართეთ ვირტუალური გაკვეთილი.
5. აირჩიეთ თქვენი პლატფორმა ჩამოსაშლელი მენიუდან (ჩანს მხოლოდ კონფიგურირებული პლატფორმები).
6. დააჭირეთ შენახვა-ს.

BailaYa შეასრულებს შემდეგს:

• შექმნის შეხვედრას არჩეულ პლატფორმაზე გაკვეთილის სახელითა და დაგეგმილი დროით.
• შეინახავს შეხვედრის URL-ს გაკვეთილის ჩანაწერში.
• შეხვედრის ბმულს ხელმისაწვდომს გახდის ჩარიცხული მოსწავლეებისთვის.

თუ პლატფორმა დროებით მიუწვდომელია, გაკვეთილი მაინც შეიქმნება — შეხვედრის ბმული შეიძლება მოგვიანებით დაემატოს გაკვეთილის რედაქტირებით.

რას ხედავენ მოსწავლეები

• გაკვეთილის დეტალების გვერდზე ჩარიცხული მოსწავლეები ხედავენ ღილაკს შეუერთდით ვირტუალურ გაკვეთილს შეხვედრის ბმულით.
• შეხვედრის ბმული ასევე შედის დაჯავშნის დადასტურების ელფოსტაში.
• ბმული ჩანს მხოლოდ გაკვეთილზე ჩარიცხული მოსწავლეებისთვის — ის საჯაროდ არ არის ნაჩვენები.

განმეორებადი ვირტუალური გაკვეთილები

როდესაც ქმნით განმეორებადი გაკვეთილების სერიას ვირტუალური ვარიანტის ჩართვით, სერიის ყოველი ცალკეული გაკვეთილი იღებს საკუთარ უნიკალურ შეხვედრის ბმულს. ეს უზრუნველყოფს, რომ მოსწავლეები ყოველთვის სწორ სესიას შეუერთდებიან.

ვირტუალური გაკვეთილის რედაქტირება

შეგიძლიათ ვირტუალური პარამეტრის გადართვა გაკვეთილის რედაქტირებისას:

• ვირტუალურის ჩართვა არსებულ საკლასო გაკვეთილზე ქმნის ახალ შეხვედრას.
• ვირტუალურის გამორთვა ვირტუალურ გაკვეთილზე წაშლის შეხვედრის ბმულს (გარე შეხვედრა წაიშლება პლატფორმიდან).
• პლატფორმის შეცვლა ქმნის ახალ შეხვედრას ახალ პლატფორმაზე და წაშლის ძველს.

ჰიბრიდული გაკვეთილები

გაკვეთილი შეიძლება იყოს ერთდროულად საკლასო და ვირტუალური:

• მიანიჭეთ ოთახი ადგილზე მყოფი მონაწილეებისთვის.
• ჩართეთ ვირტუალური გაკვეთილი დისტანციური მონაწილეებისთვის.
• ორივე ჯგუფი ხედავს ერთსა და იმავე გაკვეთილს განრიგში, მაგრამ დისტანციური მოსწავლეები იღებენ შეხვედრის ბმულს.

პლატფორმის სპეციფიკური შენიშვნები

Zoom

• შეხვედრები იქმნება როგორც დაგეგმილი შეხვედრები (Type 2).
• join_before_host ჩართულია, რათა მოსწავლეებმა შეძლონ ინსტრუქტორამდე შეერთება.
• mute_upon_entry ნაგულისხმევად ჩართულია.
• ჩაწერა ნაგულისხმევად გამორთულია.

Google Meet

• შეხვედრები იქმნება როგორც Google Calendar-ის მოვლენები თანდართული Google Meet კონფერენციით.
• თუ კალენდრის ID-ს მიუთითებთ, მოვლენა იქმნება ამ კალენდარში; წინააღმდეგ შემთხვევაში იყენებს მთავარ კალენდარს.
• Meet-ის ბმული ამოიღება კალენდრის მოვლენის კონფერენციის მონაცემებიდან.

Microsoft Teams

• შეხვედრები იქმნება Microsoft Graph Online Meetings API-ის მეშვეობით.
• ლობის გვერდის ავლა დაყენებულია „ყველაზე", რათა მოსწავლეებმა პირდაპირ შეძლონ შეერთება.
• შესვლის/გასვლის შეტყობინებები ნაგულისხმევად გამორთულია.

API-ის მითითება

ვირტუალური გაკვეთილის ველები შედის განრიგის სტანდარტულ API-ში:

ველი	ტიპი	აღწერა
isVirtual	boolean	არის თუ არა ეს ვირტუალური გაკვეთილი
virtualPlatform	string	ZOOM, GOOGLE_MEET ან TEAMS
virtualMeetingUrl	string	შეხვედრის მიერთების URL (მხოლოდ წაკითხვა, ავტომატურად გენერირებული)
virtualMeetingId	string	შეხვედრის გარე იდენტიფიკატორი პლატფორმაზე (მხოლოდ წაკითხვა)

ეს ველები შედის POST /api/schedule (შექმნა) და PATCH /api/schedule/:id (განახლება) მოთხოვნებში.