Zum Hauptinhalt springen

Calendly mit Sparks verbinden

Stand: August 2026

Mit der Calendly-Integration erscheinen Buchungen aus Calendly in Ihrem Sparks-Kalender. Optional erzeugen Sie automatisch ein Sparks-Online-Meeting, und mit Busy-Sync blockieren Sie freie Slots in Calendly anhand Ihrer Sparks-Termine (über Microsoft Outlook).

Language / Sprache: English

Überblick​

ThemaDetails
Wo in SparksEinstellungen → Konten (Accounts & Organisationen) → Abschnitt Calendly
VerbindungBevorzugt Mit Calendly verbinden (OAuth); alternativ Personal Access Token
ErgebnisBuchung → Termin im Sparks-Kalender (Badge/Quelle Calendly)
Online-MeetingMapping Sparks Online-Meeting (Standard) setzt einen Join-Link
Busy-SyncSparks-Busy → Microsoft Outlook, damit Calendly den Slot nicht anbietet

📸 Einstellungen → Konten: Provider-Konten in den Einstellungen

📸 Calendly-Abschnitt: Calendly-Integration in den Konten-Einstellungen

Voraussetzungen​

  • Sparks-Konto mit Freigabe für die Calendly-Integration (oft Pro/Paid; sonst freigeschaltet durch Ihre Organisation bzw. den Betreiber).
  • Ohne Freigabe erscheint der Abschnitt Calendly unter Konten nicht.
  • Für Busy-Sync: Microsoft unter denselben Konten-Einstellungen verbunden (Kalenderzugriff).
  • In Calendly denselben Outlook-/Microsoft-Kalender als Availability-Quelle nutzen, in den Sparks Busy schreibt.

Calendly verbinden​

  1. Öffnen Sie Einstellungen (Ctrl+. / Cmd+.) → Tab Konten.
  2. Scrollen Sie zum Abschnitt Calendly.
  3. Klicken Sie Mit Calendly verbinden und bestätigen Sie den Zugriff bei Calendly.
  4. Nach dem Redirect sehen Sie Status Verbunden (Auth-Modus oauth).

Trennen: Button Calendly trennen entfernt die Verbindung und stoppt neue Webhook-Buchungen (bestehende Termine bleiben im Kalender, bis Sie sie löschen).

Personal Access Token (Pilot)​

Wenn OAuth in Ihrer Umgebung noch nicht verfügbar ist:

  1. Unter Calendly den Bereich Personal Access Token aufklappen.
  2. Personal Access Token und Webhook-Signing-Key aus Calendly einfügen.
  3. Optional die Calendly User-URI setzen (wird oft automatisch befüllt).
  4. Calendly-Zugangsdaten speichern.

Secrets werden verschlüsselt gespeichert und nicht erneut angezeigt.

Was passiert bei einer Buchung?​

Wenn jemand über Ihren Calendly-Link einen Slot bucht:

  1. Calendly benachrichtigt Sparks (Webhook).
  2. Sparks legt (oder aktualisiert) einen Termin im Sparks-Kalender an.
  3. Der Gast erscheint als Teilnehmer (angenommen).
  4. Bei Sparks Online-Meeting enthält der Termin einen Meeting-Join-Link.
  5. Storniert der Gast in Calendly, wird der Sparks-Termin entfernt.

Doppelte Webhooks erzeugen keinen zweiten Termin.

Event Types zuordnen​

Nach dem Verbinden listet Sparks Ihre aktiven Calendly Event Types. Pro Typ können Sie speichern:

EinstellungBedeutung
Sparks-Events für diesen Typ anlegenAus = Buchungen dieses Typs werden ignoriert
Location-ModusSiehe unten
Betreff-TemplatePlatzhalter {name}, {invitee_name}, {event_type}

Location-Modus​

ModusWirkung
Sparks Online-MeetingTermin + Sparks-Meeting-Link (Standard)
Nur Kalender (ohne Meeting-Link)Termin ohne Appointment
Calendly-Location verwendenOrt/Text aus Calendly, kein Sparks-Meeting

📸 Event-Type-Mapping: Event Types und Mapping in Calendly-Einstellungen

Ohne gespeichertes Mapping gilt: Standard-Sparks-Kalender und Location-Modus Sparks Online-Meeting.

Busy-Sync (Verfügbarkeit)​

Busy-Sync schreibt belegte Zeiten aus dem Sparks-Kalender als Blocker nach Microsoft Outlook. Calendly liest diesen Outlook-Kalender und bietet die Slots nicht mehr an.

  1. Unter Busy-Sync das Ziel Microsoft-Kalender aktivieren.
  2. Schalter Busy-Sync aktivieren einschalten (ohne verknüpftes Microsoft → Fehlermeldung).
  3. Optional Busy jetzt syncen für einen sofortigen Lauf.
  4. Im Hintergrund aktualisiert Sparks die Blocker regelmäßig (typisch alle paar Minuten).

Hinweise:

  • Google-Kalender als Busy-Ziel ist serverseitig noch nicht verfügbar — bitte Microsoft nutzen.
  • In Calendly muss derselbe Microsoft-Kalender für Availability verbunden sein.
  • Nach dem ersten Freischalten des Graph-Kalenderzugriffs ggf. Microsoft unter Konten erneut verbinden.

📸 Busy-Sync: Busy-Sync-Einstellungen Calendly

Tipps & Fehlerbehebung​

SymptomMögliche Ursache
Kein Calendly-AbschnittFeature nicht freigeschaltet (Tarif / Organisation)
OAuth startet nichtBetreiber: Calendly-OAuth-App und Redirect-URL prüfen
Buchung fehlt im KalenderVerbindung getrennt, Mapping deaktiviert, oder Webhook nicht erreichbar
Kein Meeting-LinkLocation-Modus ist nicht Sparks Online-Meeting
Busy-Sync-FehlerMicrosoft nicht verbunden oder Target nicht gewählt
Calendly zeigt weiter freie SlotsBusy-Sync aus, falscher Availability-Kalender in Calendly, Sync noch nicht gelaufen

Verwandte Themen​