Zum Hauptinhalt springen

Calendly-Integration - Einrichtungsanleitung

Verbinde dein Calendly-Konto mit Goodweek, um Terminplanungslinks, Termine und Verfügbarkeiten direkt aus deinem KI-Arbeitsbereich zu verwalten.

A
Verfasst von Antoine Stempien

Verbinde dein Calendly-Konto mit Goodweek, um Terminplanungslinks, Termine und Verfügbarkeiten direkt aus deinem KI-Arbeitsbereich zu verwalten.

ℹ️ Hinweis zur Governance

Goodweek überschreitet niemals die dem Nutzer innerhalb von Calendly gewährten Zugriffsrechte und gewährleistet so die Übereinstimmung mit den Governance-Richtlinien deiner Organisation. Ergebnisse und verfügbare Funktionen können je nach den spezifischen Berechtigungen und dem authentifizierten Zugriff der einzelnen Nutzer variieren.

📋 Voraussetzungen

Bevor ein Nutzer die Calendly-Integration sehen und verbinden kann, muss dein Organisationsadministrator sie zunächst im Goodweek Admin-Panel unter dem Tab Integrationen aktivieren.

Administrator-Einrichtung

Die Calendly-Integration nutzt OAuth 2.0 und erfordert keine Genehmigung auf Administratorebene innerhalb von Calendly, bevor sich Nutzer verbinden können.

⚠️ Wenn dein Calendly-Konto mit Microsoft 365 / Outlook verbunden ist

Wenn Nutzer in deiner Organisation Calendly mit Microsoft 365 Single Sign-On verwenden oder ihren Outlook-Kalender mit Calendly verbunden haben, sehen sie während des Verbindungsvorgangs möglicherweise die Meldung „Genehmigung erforderlich" oder „Administratorzustimmung erforderlich". Dies liegt daran, dass Microsoft Entra ID die Zustimmung des Administrators für die von Calendly angeforderten Microsoft-Graph-Berechtigungen erfordert (insbesondere Calendars.ReadWrite.shared), und steht nicht im Zusammenhang mit Goodweek oder Composio.

Um dies zu beheben, muss ein globaler Microsoft 365-Administrator die mandantenweite Administratorzustimmung für die Calendly-App in Microsoft Entra erteilen:

  1. Gehe zum Microsoft Entra Admin Center unter entra.microsoft.com.

  2. Navigiere zu Unternehmensanwendungen → suche nach „Calendly".

  3. Öffne die Calendly-Anwendung → Berechtigungen → Administratorzustimmung für [deine Organisation] erteilen.

  4. Stelle sicher, dass „Zustimmung im Namen deiner Organisation" ausgewählt ist, bevor du bestätigst.

Nutzerverbindung

  1. Gehe in Goodweek zu Integrationen.

  2. Suche Calendly und klicke auf Verbinden.

  3. Du wirst zu Calendly weitergeleitet, wo du dich anmelden und den Zugriff autorisieren musst.

  4. Klicke auf Zulassen, um den Zugriff zu gewähren und zu Goodweek zurückzukehren.

Wichtige Hinweise

  • Jeder Nutzer muss sein eigenes Konto individuell verbinden.

  • Goodweek kann nur auf die Calendly-Ereignistypen, geplanten Termine und Verfügbarkeiten zugreifen, die dein individuelles Nutzerkonto einsehen darf.

  • Wenn deine Organisation Calendly Teams verwendet, sind Daten auf Teamebene nur zugänglich, wenn deine Calendly-Rolle über die entsprechenden Berechtigungen verfügt.

  • Du kannst den Zugriff von Goodweek jederzeit über Calendly → Integrationen → Verbundene Apps → Composio → Entfernen aufheben.


Verfügbare Tools

Tool

Beschreibung

Typ

List Event Types

Listet alle Ereignistypen auf, die mit einem bestimmten Nutzer oder einer Organisation in Calendly verknüpft sind.

Lesen

Get Event Type

Ruft Details zu einem bestimmten Calendly-Ereignistyp anhand seiner UUID ab.

Lesen

Get Event Type Availability

Ruft die für einen bestimmten Ereignistyp konfigurierten Verfügbarkeitspläne ab.

Lesen

List Event Type Available Times

Ruft verfügbare Zeitfenster für einen Ereignistyp innerhalb eines angegebenen Zeitraums ab.

Lesen

Create Event Type

Erstellt einen neuen Einzeltermin-Ereignistyp in Calendly.

Schreiben

Update Event Type

Aktualisiert die Einstellungen eines bestehenden Einzeltermin-Ereignistyps.

Schreiben

List Scheduled Events

Ruft eine Liste geplanter Calendly-Termine für einen Nutzer oder eine Organisation mit optionalen Filtern ab.

Lesen

Get Event

Ruft einen bestimmten geplanten Calendly-Termin anhand seiner UUID ab.

Lesen

List Event Invitees

Ruft eine Liste der Eingeladenen für einen bestimmten Termin mit optionalen Status- und E-Mail-Filtern ab.

Lesen

Get Event Invitee

Ruft detaillierte Informationen zu einem bestimmten Eingeladenen eines Termins ab.

Lesen

Create Scheduling Link

Erstellt einen Terminplanungslink, der zur Buchung eines Termins verwendet werden kann.

Schreiben

Create Single Use Scheduling Link

Erstellt einen einmalig verwendbaren Terminplanungslink für einen Ereignistyp, der nach einer Buchung abläuft.

Schreiben

Create Share

Erstellt einen anpassbaren, einmaligen Freigabelink für einen Calendly-Ereignistyp mit optionalen Einstellungsüberschreibungen.

Schreiben

Get User

Ruft umfassende Details zu einem bestehenden Calendly-Nutzer ab.

Lesen

Get User Availability Schedule

Ruft den Verfügbarkeitsplan eines Nutzers anhand seiner UUID ab.

Lesen

List User Availability Schedules

Ruft alle Verfügbarkeitspläne für einen bestimmten Calendly-Nutzer ab.

Lesen

List User Busy Times

Ruft die belegten Zeitintervalle eines Nutzers aus internen und externen Kalendern für bis zu 7 Tage ab.

Lesen

Get Organization

Ruft Informationen zu einer bestimmten Calendly-Organisation ab.

Lesen

List Organization Memberships

Ruft eine Liste der Organisationsmitgliedschaften ab.

Lesen

List Routing Forms

Ruft die Routing-Formulare einer bestimmten Organisation ab.

Lesen

List Routing Form Submissions

Listet alle Einsendungen zu einem bestimmten Routing-Formular auf.

Lesen

Mark Invitee as No-Show

Markiert einen Eingeladenen als nicht erschienen bei einem geplanten Termin.

Lesen

Cancel Scheduled Event

Storniert einen geplanten Calendly-Termin durch Erstellen eines Stornierungsdatensatzes.

⚠️ Destruktiv

Delete Invitee Data

Entfernt dauerhaft alle Daten von Eingeladenen, die mit den angegebenen E-Mail-Adressen aus vergangenen Terminen der Organisation verknüpft sind, aus Datenschutzgründen.

⚠️ Destruktiv

Anwendungsfälle

  • Prüfe deinen Terminkalender und anstehende Meetings. Rufe eine Liste deiner geplanten Calendly-Termine und deren Eingeladene direkt aus Goodweek ab, um deinen Kalender zu überprüfen, ohne die App zu wechseln.

  • Finde verfügbare Zeitfenster, bevor du ein Meeting vorschlägst. Frage verfügbare Zeiten für einen bestimmten Ereignistyp ab, um freie Zeitfenster zu identifizieren, bevor du einen Kunden oder Kollegen zur Terminvereinbarung kontaktierst.

  • Erstelle Terminplanungslinks bei Bedarf. Erstelle einmalige oder standardmäßige Terminplanungslinks für einen bestimmten Ereignistyp direkt aus einer Goodweek-Unterhaltung, bereit zum Teilen mit einem Kontakt.

  • Überprüfe Einsendungen zu Routing-Formularen. Greife auf Antworten zu Calendly-Routing-Formularen zu, um zu verstehen, wie eingehende Terminanfragen in deinem Team weitergeleitet werden.


Fehlerbehebung

„Genehmigung erforderlich" oder „Administratorzustimmung erforderlich" beim Verbinden

Dies liegt daran, dass Microsoft Entra die Zustimmung des Administrators für die von Calendly angeforderten Microsoft 365-Berechtigungen erfordert. Ein globaler Microsoft 365-Administrator muss die Zustimmung wie im obigen Abschnitt zur Administrator-Einrichtung beschrieben erteilen.

Die Verbindung funktionierte zuvor, zeigt aber jetzt „Genehmigung erforderlich" an

Calendly hat kürzlich den Microsoft-Graph-Bereich Calendars.ReadWrite.shared hinzugefügt. Der Administrator muss die Zustimmung möglicherweise erneut erteilen, um diesen neuen Bereich einzuschließen. Folge den Schritten im obigen Warnhinweis-Abschnitt.

Integration in Goodweek nicht sichtbar

Stelle sicher, dass dein Organisationsadministrator die Calendly-Integration im Goodweek Admin-Panel unter dem Tab Integrationen aktiviert hat.

Referenzen

Hat dies deine Frage beantwortet?