Einen Termin auf der Buchungsseite direkt verlinken

Mit der Kenntnis bestimmter Parameter ist es möglich, von der eigenen Website direkt zu einem bestimmten Termin auf der SeminarDesk-Buchungsseite zu verlinken. Dies ist besonders nützlich bei Veranstaltungen mit mehreren Terminen oder parallelen Sessions.

Standard-Verlinkung mit Terminvorauswahl

URL-Format

Die URL der Veranstaltungs-Detailseiten auf einer SeminarDesk-Buchungsseite sind nach dem folgenden Schema aufgebaut, und mit dem zusätzlichen Abfrageparameter eventDateId lässt sich beim Verlinken auch ein bestimmter Termin vorauswählen.

https://booking.seminardesk.de/[sprache]/[mandant]/[veranstaltungs-id]/[veranstaltungs-slug]?eventDateId=[termin-id]

Beispiel

https://booking.seminardesk.de/de/yogastudio/3685dd550f8a4693b740e187e47f740e/yoga-fuer-anfaenger?eventDateId=42

Effekt: Der Termin mit ID 42 wird im Dropdown vorausgewählt, alle verfügbaren Termine bleiben sichtbar.

Ermittlung der Parameterwerte

Weg 1: Über die Buchungsseite

Bis auf die Termin-ID können wir alle Parameterwerte aus der URL einer Veranstaltungs-Detailseite kopieren.

Weg 2: Über die Benutzeroberfläche

Die Veranstaltungs-ID können wir in der Liste aller Veranstaltungen als Spalte „Öffentliche ID“ einblenden.

Die Termin-ID hingegen können wir wie folgt in der SeminarDesk-Benutzeroberfläche ablesen:

1. Veranstaltungs-Details oder Liste aller Termine in SeminarDesk öffnen
2. Zum gewünschten Veranstaltungstermin navigieren
3. Aus der URL der Termin-Details den Wert von Parameter TerminID kopieren

Weg 3: Über die Öffentliche API

SeminarDesk bietet eine öffentliche API, über welche wir Veranstaltungs-ID, Veranstaltungs-Slug und Termin-ID ermitteln können:

• Endpoint /eventDates liefert eine Liste der zukünftigen veröffentlichten Veranstaltungstermine.
• Endpoint /events/{eventId} liefert Informationen eines bestimmten Termins.

Aus den Antworten können wir folgende Werte für die URL eines Termins auf der Buchungsseite ablesen:

• eventInfo/id → veranstaltungs-id
• eventInfo/titleSlug/value → veranstaltungs-slug
• id → termin-id

Erweiterte Parameter

Nur ausgewählten Termin anzeigen

Parameter: hideNonSelectedEventDates=true

?eventDateId=42&hideNonSelectedEventDates=true

Effekt: Es wird ausschließlich der vorgewählte Termin angezeigt, alle anderen Termine werden ausgeblendet.

Hinweis: Dieser Parameter funktioniert zusätzlich zu o. a. Parameter eventDateId. Mehrere Parameter werden mit & verknüpft.

Mehrere Termine gleichzeitig vorauswählen

Format: Den Parameter mehrfach angeben

?eventDateId=42&eventDateId=43&eventDateId=44

Hinweis: Die genaue Implementierung kann je nach System variieren. Bitte testen, ob die eigene Integration eine Mehrfachauswahl unterstützt.

Embed-Modus (für iframe-Integration)

URL-Format

https://booking.seminardesk.de/[...]/embed-form?eventDateId=[termin-id]

Beispiel

https://booking.seminardesk.de/de/yogastudio/3685dd550f8a4693b740e187e47f740e/yoga-fuer-anfaenger/embed-form?eventDateId=42&hideNonSelectedEventDates=true

Eigenschaften des Embed-Modus:

• Zeigt nur das Buchungsformular ohne Header/Footer
• Ideal für eine Integration in Overlays oder Modals
• Empfohlene Implementierung via iframe

iframe-Beispiel

<iframe 
  src="https://booking.seminardesk.de/de/yogastudio/3685dd550f8a4693b740e187e47f740e/yoga-fuer-anfaenger/embed-form?eventDateId=42&hideNonSelectedEventDates=true"
  width="100%" 
  height="600px"
  frameborder="0">
</iframe>

Erweiterte Parameter im Embed-Modus

Teilnahmeart vorauswählen

Parameter: attendanceType=[typ]

Mögliche Werte für die Teilnahmeart:

• ONLINE – Online-Teilnahme
• ONSITE – Präsenz-Teilnahme
• HYBRID – Hybrid-Teilnahme

/embed-form?eventDateId=42&attendanceType=ONLINE

Hinweis: Dieser Parameter funktioniert zusätzlich zu o. a. Parameter eventDateId. Mehrere Parameter werden mit & verknüpft.

Teilnahmeart-Auswahl ausblenden

Parameter: hideAttendanceTypeSelection=true

/embed-form?eventDateId=42&attendanceType=ONLINE&hideAttendanceTypeSelection=true

Hinweis: Dieser Parameter funktioniert zusätzlich zum Parameter attendanceType.

Möglich ist auch eine Kombination mit Angabe einer Weiterleitungs-URL.

Anwendungsfälle

Use Case 1: Veranstaltung mit vielen Terminen

Bei Seminaren mit vielen Terminen (bspw. wöchentliche Yoga-Kurse) können wir dadurch direkt zum relevanten Termin verlinken:

?eventDateId=45&hideNonSelectedEventDates=true

Use Case 2: Parallele Sessions mit verschiedenen Trainern

Wenn mehrere Trainer gleichzeitig verschiedene Kurse geben:

// Hatha Yoga mit Trainer A
?eventDateId=101&eventDateId=103

// Vinyasa Yoga mit Trainer B  
?eventDateId=102&eventDateId=104

Use Case 3: Online-Kurs direkt buchbar machen (Embed-Modus)

/embed-form?eventDateId=55&attendanceType=ONLINE&hideAttendanceTypeSelection=true

Wichtige Hinweise

• Die Parameter funktionieren nur, wenn die Veranstaltung und der Termin öffentlich sichtbar sind.
• Bei ausgebuchten Terminen wird automatisch die Warteliste angezeigt (sofern aktiviert).
• Die Parameter sind case sensitive (Groß-/Kleinschreibung beachten).
• Mehrere Parameter werden mit & verknüpft.

Technische Details für Entwickler

Die Buchungsseite unterstützt folgende URL-Parameter:

• eventDateId – Termin-ID (numerisch)
• hideNonSelectedEventDates – blendet nicht ausgewählte Termine aus (true/false)
• attendanceType – im Embed-Modus; Teilnahmeart (ONLINE/ONSITE/HYBRID)
• hideAttendanceTypeSelection – im Embed-Modus; blendet Teilnahmeart-Auswahl aus (true/false)