Virtuelle Kurse

Bieten Sie Live-Online-Kurse über Zoom, Google Meet oder Microsoft Teams an. Wenn Sie einen Kurs als virtuell markieren, erstellt BailaYa automatisch ein Meeting auf der verbundenen Plattform und teilt den Link mit den eingeschriebenen Schülern.

Voraussetzungen

Bevor Sie virtuelle Kurse erstellen, verbinden Sie mindestens eine Videoplattform unter Einstellungen → Integrationen:

• Zoom — Erfordert einen Zoom-API-Zugriffstoken
• Google Meet — Erfordert einen Google Calendar-API-Zugriffstoken (Meetings werden als Kalendertermine mit Meet-Links erstellt)
• Microsoft Teams — Erfordert einen Microsoft Graph-API-Zugriffstoken

tipp

Sie müssen nur die Plattformen konfigurieren, die Sie verwenden möchten. Die Option für virtuelle Kurse erscheint nur im Kurserstellungsformular, wenn mindestens eine Plattform verbunden ist.

Eine Plattform verbinden

1. Gehen Sie zu Einstellungen → Integrationen.
2. Scrollen Sie zum Abschnitt Plattformen für Virtuelle Kurse.
3. Für die gewählte Plattform:
   • Schalten Sie den Schalter auf Aktiviert.
   • Fügen Sie Ihren Zugriffstoken ein (siehe plattformspezifische Dokumentation unten).
   • Für Google Meet können Sie optional eine Kalender-ID festlegen (standardmäßig wird Ihr Hauptkalender verwendet).
   • Klicken Sie auf Speichern.

Zugriffstoken erhalten

Plattform	Wo Sie einen Token erhalten
Zoom	Zoom Marketplace — Erstellen Sie eine Server-zu-Server-OAuth-App oder verwenden Sie einen persönlichen Zugriffstoken
Google Meet	Google Cloud Console — Aktivieren Sie die Calendar API und generieren Sie OAuth2-Anmeldedaten
Microsoft Teams	Azure Portal — Registrieren Sie eine App und erteilen Sie die Berechtigung OnlineMeetings.ReadWrite

Einen virtuellen Kurs erstellen

1. Öffnen Sie Stundenplan und klicken Sie auf Kurs Erstellen (oder bearbeiten Sie einen bestehenden Kurs).
2. Füllen Sie die Kursdetails wie gewohnt aus (Name, Uhrzeit, Kursleiter, etc.).
3. Am Ende des Formulars sehen Sie einen Schalter Virtueller Kurs (nur sichtbar, wenn eine Plattform verbunden ist).
4. Aktivieren Sie Virtueller Kurs.
5. Wählen Sie Ihre Plattform aus dem Dropdown-Menü (nur konfigurierte Plattformen werden angezeigt).
6. Klicken Sie auf Speichern.

BailaYa wird Folgendes tun:

• Ein Meeting auf der ausgewählten Plattform mit dem Kursnamen und der geplanten Zeit erstellen.
• Die Meeting-URL im Kursdatensatz speichern.
• Den Meeting-Link für eingeschriebene Schüler verfügbar machen.

Wenn die Plattform vorübergehend nicht verfügbar ist, wird der Kurs trotzdem erstellt — der Meeting-Link kann nachträglich durch Bearbeitung des Kurses hinzugefügt werden.

Was Schüler sehen

• Auf der Kursdetailseite sehen eingeschriebene Schüler eine Schaltfläche Virtuellem Kurs Beitreten mit dem Meeting-Link.
• Der Meeting-Link ist auch in den Buchungsbestätigungs-E-Mails enthalten.
• Der Link ist nur für Schüler sichtbar, die in den Kurs eingeschrieben sind — er wird nicht öffentlich angezeigt.

Wiederkehrende virtuelle Kurse

Wenn Sie eine wiederkehrende Kursserie mit aktivierter virtueller Option erstellen, erhält jeder einzelne Kurs in der Serie seinen eigenen einzigartigen Meeting-Link. Dies stellt sicher, dass Schüler immer der richtigen Sitzung beitreten.

Einen virtuellen Kurs bearbeiten

Sie können die virtuelle Einstellung beim Bearbeiten eines Kurses umschalten:

• Virtuell aktivieren bei einem bestehenden Präsenzkurs erstellt ein neues Meeting.
• Virtuell deaktivieren bei einem virtuellen Kurs entfernt den Meeting-Link (das externe Meeting wird von der Plattform gelöscht).
• Die Plattform wechseln erstellt ein neues Meeting auf der neuen Plattform und löscht das alte.

Hybridkurse

Ein Kurs kann gleichzeitig als Präsenz- und virtueller Kurs stattfinden:

• Weisen Sie einen Raum für Teilnehmer vor Ort zu.
• Aktivieren Sie Virtueller Kurs für Remote-Teilnehmer.
• Beide Gruppen sehen denselben Kurs im Stundenplan, aber Remote-Schüler erhalten den Meeting-Link.

Plattformspezifische Hinweise

Zoom

• Meetings werden als geplante Meetings (Type 2) erstellt.
• join_before_host ist aktiviert, damit Schüler vor dem Kursleiter beitreten können.
• mute_upon_entry ist standardmäßig aktiviert.
• Die Aufnahme ist standardmäßig deaktiviert.

Google Meet

• Meetings werden als Google Calendar-Termine mit einer angehängten Google Meet-Konferenz erstellt.
• Wenn Sie eine Kalender-ID angeben, wird der Termin in diesem Kalender erstellt; andernfalls wird der Hauptkalender verwendet.
• Der Meet-Link wird aus den Konferenzdaten des Kalendertermins extrahiert.

Microsoft Teams

• Meetings werden über die Microsoft Graph Online Meetings API erstellt.
• Die Lobby-Umgehung ist auf „alle" eingestellt, damit Schüler direkt beitreten können.
• Ein-/Austrittsankündigungen sind standardmäßig deaktiviert.

API-Referenz

Die Felder für virtuelle Kurse sind in der Standard-Stundenplan-API enthalten:

Feld	Typ	Beschreibung
isVirtual	boolean	Ob es sich um einen virtuellen Kurs handelt
virtualPlatform	string	ZOOM, GOOGLE_MEET oder TEAMS
virtualMeetingUrl	string	Die Beitritts-URL des Meetings (schreibgeschützt, automatisch generiert)
virtualMeetingId	string	Die externe Meeting-ID auf der Plattform (schreibgeschützt)

Diese Felder sind in POST /api/schedule (Erstellen) und PATCH /api/schedule/:id (Aktualisieren) enthalten.