Collega il tuo account Calendly a Goodweek per gestire link di pianificazione, eventi e disponibilità direttamente dal tuo spazio di lavoro AI.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Calendly, garantendo l'allineamento con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che un utente possa vedere e collegare l'integrazione Calendly, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione Calendly utilizza OAuth 2.0 e non richiede alcuna approvazione a livello di amministratore all'interno di Calendly prima che gli utenti possano collegarsi.
⚠️ Se il tuo account Calendly è collegato a Microsoft 365 / Outlook
Se gli utenti della tua organizzazione utilizzano Calendly con Single Sign-On di Microsoft 365 o hanno il proprio calendario Outlook collegato a Calendly, potrebbero visualizzare un messaggio "Approvazione richiesta" o "Consenso dell'amministratore richiesto" durante il processo di connessione. Questo è causato dal fatto che Microsoft Entra ID richiede il consenso dell'amministratore per le autorizzazioni di Microsoft Graph richieste da Calendly (in particolare Calendars.ReadWrite.shared), e non è correlato a Goodweek o Composio.
Per risolvere questo problema, un amministratore globale di Microsoft 365 deve concedere il consenso dell'amministratore a livello di tenant per l'app Calendly in Microsoft Entra:
Vai al centro di amministrazione di Microsoft Entra all'indirizzo entra.microsoft.com.
Vai su Applicazioni aziendali → cerca "Calendly".
Apri l'applicazione Calendly → Autorizzazioni → Concedi il consenso dell'amministratore per [la tua organizzazione].
Assicurati che sia selezionato "Consenso per conto della tua organizzazione" prima di confermare.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova Calendly e fai clic su Connetti.
Verrai reindirizzato a Calendly, dove ti verrà chiesto di accedere e autorizzare l'accesso.
Fai clic su Consenti per concedere l'accesso e tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account individualmente.
Goodweek può accedere solo ai tipi di evento, agli eventi programmati e alla disponibilità di Calendly che il tuo account utente individuale ha il permesso di visualizzare.
Se la tua organizzazione utilizza Calendly Teams, i dati a livello di team sono accessibili solo se il tuo ruolo Calendly include le autorizzazioni appropriate.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da Calendly → Integrazioni → App collegate → Composio → Rimuovi.
Strumenti disponibili
Strumento | Descrizione | Tipo |
List Event Types | Elenca tutti i tipi di evento associati a un utente o a un'organizzazione specifici in Calendly. | Lettura |
Get Event Type | Recupera i dettagli di un tipo di evento specifico di Calendly tramite il suo UUID. | Lettura |
Get Event Type Availability | Recupera gli orari di disponibilità configurati per un tipo di evento specifico. | Lettura |
List Event Type Available Times | Recupera gli orari disponibili per un tipo di evento in un intervallo di tempo specificato. | Lettura |
Create Event Type | Crea un nuovo tipo di evento individuale in Calendly. | Scrittura |
Update Event Type | Aggiorna le impostazioni di un tipo di evento individuale esistente. | Scrittura |
List Scheduled Events | Recupera un elenco di eventi programmati di Calendly per un utente o un'organizzazione con filtri opzionali. | Lettura |
Get Event | Recupera un evento programmato specifico di Calendly tramite il suo UUID. | Lettura |
List Event Invitees | Recupera un elenco di invitati per un evento specifico con filtri opzionali per stato ed email. | Lettura |
Get Event Invitee | Recupera informazioni dettagliate su un invitato specifico di un evento. | Lettura |
Create Scheduling Link | Crea un link di pianificazione che può essere utilizzato per prenotare un evento. | Scrittura |
Create Single Use Scheduling Link | Crea un link di pianificazione monouso per un tipo di evento, che scade dopo una prenotazione. | Scrittura |
Create Share | Crea un link di condivisione personalizzabile e monouso per un tipo di evento Calendly, con eventuali override delle impostazioni. | Scrittura |
Get User | Recupera informazioni dettagliate su un utente Calendly esistente. | Lettura |
Get User Availability Schedule | Recupera il programma di disponibilità di un utente tramite il suo UUID. | Lettura |
List User Availability Schedules | Recupera tutti i programmi di disponibilità di un utente Calendly specifico. | Lettura |
List User Busy Times | Recupera gli intervalli di tempo occupati di un utente da calendari interni ed esterni per un massimo di 7 giorni. | Lettura |
Get Organization | Recupera informazioni su un'organizzazione Calendly specifica. | Lettura |
List Organization Memberships | Recupera un elenco di appartenenze all'organizzazione. | Lettura |
List Routing Forms | Recupera i moduli di instradamento di un'organizzazione specificata. | Lettura |
List Routing Form Submissions | Elenca tutti gli invii associati a un modulo di instradamento specifico. | Lettura |
Mark Invitee as No-Show | Contrassegna un invitato come assente a un evento programmato. | Lettura |
Cancel Scheduled Event | Annulla un evento programmato di Calendly creando un record di cancellazione. | ⚠️ Distruttivo |
Delete Invitee Data | Rimuove permanentemente tutti i dati degli invitati associati alle email specificate dagli eventi passati dell'organizzazione, per finalità di privacy dei dati. | ⚠️ Distruttivo |
Casi d'uso
Controlla la tua agenda e i prossimi appuntamenti. Recupera un elenco dei tuoi eventi programmati in Calendly e dei relativi invitati direttamente da Goodweek per rivedere il tuo calendario senza cambiare app.
Trova orari disponibili prima di proporre una riunione. Interroga gli orari disponibili per un tipo di evento specifico per identificare gli slot liberi prima di contattare un cliente o un collega per pianificare una riunione.
Genera link di pianificazione su richiesta. Crea link di pianificazione monouso o standard per un tipo di evento specifico direttamente da una conversazione Goodweek, pronti da condividere con un contatto.
Rivedi gli invii dei moduli di instradamento. Accedi alle risposte dei moduli di instradamento di Calendly per capire come vengono indirizzate le richieste di riunione in entrata nel tuo team.
Risoluzione dei problemi
"Approvazione richiesta" o "Consenso dell'amministratore richiesto" durante la connessione
Questo è causato dal fatto che Microsoft Entra richiede il consenso dell'amministratore per le autorizzazioni Microsoft 365 richieste da Calendly. Un amministratore globale di Microsoft 365 deve concedere il consenso come descritto nella sezione di configurazione amministratore sopra.
La connessione funzionava prima ma ora mostra "Approvazione richiesta"
Calendly ha recentemente aggiunto l'ambito Microsoft Graph Calendars.ReadWrite.shared. L'amministratore potrebbe dover concedere nuovamente il consenso per includere questo nuovo ambito. Segui i passaggi nella sezione di avviso sopra.
L'integrazione non è visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Calendly dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.