Calendly (anteprima)
Il connettore di Calendly consente di automatizzare gli eventi pianificati, aumentare la produttività e ottimizzare l'efficienza tramite flussi di lavoro automatizzati.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Supporto calendly |
| URL | https://help.calendly.com/hc/en-us |
| support@calendly.com |
| Metadati del connettore | |
|---|---|
| Editore | Calendly |
| Sito web | https://calendly.com |
| Informativa sulla privacy | https://calendly.com/privacy |
| Categorie | Produttività |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Token di accesso personale | securestring | Token di accesso personale per questa API | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Create Invitee No Show |
Contrassegna un invito come no show. |
| Elimina invito nessuna visualizzazione |
Annulla il contrassegno di un invito come no show |
| Get Event Types |
Restituisce tutti i tipi di evento associati all'organizzazione. |
| Tipo di evento Get |
Restituisce informazioni su un tipo di evento specificato. |
Create Invitee No Show
Contrassegna un invito come no show.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
URI dell'invito
|
invitee | True | string |
URI dell'invitato contrassegnato come No Show per un evento pianificato |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nessun URI di visualizzazione
|
resource.uri | string |
Riferimento canonico (identificatore univoco) per il valore no show |
|
URI dell'invito
|
resource.invitee | string |
Riferimento canonico (identificatore univoco) per l'invito associato |
|
Creato all'indirizzo
|
resource.created_at | string |
Il momento in cui è stato creato il no show |
Elimina invito nessuna visualizzazione
Annulla il contrassegno di un invito come no show
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Invita nessun UUID show
|
uuid | True | string |
UUID dell'invitato il cui record No Show viene rimosso |
Restituisce
Nessuna visualizzazione eliminata
- 204
- string
Get Event Types
Restituisce tutti i tipi di evento associati all'organizzazione.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Active
|
active | boolean |
Restituisce solo i tipi di evento attivi se true, solo inattivi se false o tutti i tipi di evento se questo parametro viene omesso. |
|
|
Conteggio
|
count | integer |
Numero di righe da restituire. |
|
|
Token di pagina
|
page_token | string |
Token da passare per ottenere la parte successiva o precedente della raccolta. |
|
|
Amministratore gestito
|
admin_managed | boolean |
Restituisce solo i tipi di evento gestiti dall'amministratore se true, escludere i tipi di evento gestiti dall'amministratore se false o includere tutti i tipi di evento se questo parametro viene omesso. |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
collezione
|
collection | array of EventType |
collezione |
|
Conteggio paginazione
|
pagination.count | integer |
Numero di righe da restituire. |
|
URI pagina successiva
|
pagination.next_page | string |
URI per restituire la pagina successiva di un elenco ordinato ("null" indica che non sono disponibili risultati aggiuntivi). |
|
URI pagina precedente
|
pagination.previous_page | string |
URI per restituire la pagina precedente di un elenco ordinato ("null" indica che non sono disponibili risultati aggiuntivi). |
|
Token pagina successiva
|
pagination.next_page_token | string |
Token per restituire la pagina successiva di un elenco ordinato ("null" indica che non sono disponibili risultati aggiuntivi). |
|
Token pagina precedente
|
pagination.previous_page_token | string |
Token per restituire la pagina precedente di un elenco ordinato ("null" indica che non sono disponibili risultati aggiuntivi). |
Tipo di evento Get
Restituisce informazioni su un tipo di evento specificato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
UUID del tipo di evento
|
uuid | True | string |
UUID del tipo di evento richiesto |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
resource
|
resource | EventType |
Trigger
| Creare una sottoscrizione webhook (invio di moduli di routing) |
Creare una sottoscrizione webhook per un'organizzazione attivata quando viene inviato un modulo di routing. |
| Creare una sottoscrizione webhook (invito) |
Creare una sottoscrizione webhook per un'organizzazione che viene attivata quando un evento viene pianificato o annullato. |
Creare una sottoscrizione webhook (invio di moduli di routing)
Creare una sottoscrizione webhook per un'organizzazione attivata quando viene inviato un modulo di routing.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Webhook creato all'indirizzo
|
created_at | string |
Momento in cui è stato creato il webhook ,ad esempio "2020-01-02T03:04:05.678123Z". |
|
Webhook Creator URI
|
created_by | string |
Riferimento all'utente che ha creato la sottoscrizione webhook. |
|
Webhook, evento
|
event | string |
Evento che ha causato l'incendio del webhook. |
|
URI invio modulo di routing
|
payload.uri | string |
Riferimento canonico (identificatore univoco) per l'invio del modulo di routing. |
|
URI modulo di routing
|
payload.routing_form | string |
URI del modulo di routing associato all'invio. |
|
questions_and_answers
|
payload.questions_and_answers | array of object |
questions_and_answers |
|
UUID domanda
|
payload.questions_and_answers.question_uuid | string |
Identificatore univoco per la domanda del modulo di routing. |
|
Domanda
|
payload.questions_and_answers.question | string |
Nome domanda (in formato leggibile). |
|
Risposta
|
payload.questions_and_answers.answer | string |
Risposta fornita dal partecipante al momento dell'invio del modulo. |
|
Campagna UTM
|
payload.tracking.utm_campaign | string |
Parametro UTM usato per tenere traccia di una campagna. |
|
Origine UTM
|
payload.tracking.utm_source | string |
Parametro UTM che identifica l'origine (piattaforma in cui ha origine il traffico). |
|
UTM Medium
|
payload.tracking.utm_medium | string |
Parametro UTM che identifica il tipo di input ,ad esempio Costo per clic (CPC), social media, affiliate o codice a matrice. |
|
Contenuto UTM
|
payload.tracking.utm_content | string |
Parametro di rilevamento del contenuto UTM. |
|
Termine UTM
|
payload.tracking.utm_term | string |
Parametro UTM usato per tenere traccia della parola chiave. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificatore univoco del record Salesforce. |
|
Tipo di risultato
|
payload.result.type | string |
Indica se l'invio del modulo di routing ha generato un messaggio personalizzato, un tipo di evento o un URL esterno. |
|
URI del mittente
|
payload.submitter | string |
Il riferimento alla risorsa Invita quando si instrada l'invio del modulo viene generata una riunione pianificata. |
|
Tipo di mittente
|
payload.submitter_type | string |
Tipo della risorsa intervistata che ha inviato il modulo e pianificato una riunione. |
|
Invio modulo di routing creato all'indirizzo
|
payload.created_at | string |
Momento in cui è stato inviato il modulo di routing. |
|
Invio modulo di routing aggiornato all'indirizzo
|
payload.updated_at | string |
Momento dell'ultimo aggiornamento dell'invio del modulo di routing. |
Creare una sottoscrizione webhook (invito)
Creare una sottoscrizione webhook per un'organizzazione che viene attivata quando un evento viene pianificato o annullato.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Restituisce
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Webhook creato all'indirizzo
|
created_at | string |
Momento in cui è stato creato il webhook ,ad esempio "2020-01-02T03:04:05.678123Z". |
|
Webhook Creator URI
|
created_by | string |
Riferimento all'utente che ha creato la sottoscrizione webhook. |
|
Webhook, evento
|
event | string |
Evento che ha causato l'incendio del webhook. |
|
Cancel Event URL
|
payload.cancel_url | string |
Collegamento per annullare l'evento per l'invito. |
|
Invita creato all'indirizzo
|
payload.created_at | string |
Momento in cui è stato creato l'evento ,ad esempio "2020-01-02T03:04:05.678123Z". |
|
Invia un messaggio di posta elettronica di invito
|
payload.email | string |
Indirizzo di posta elettronica dell'invito. |
|
URI evento
|
payload.event | string |
Riferimento all'evento. |
|
Nome dell'invito
|
payload.name | string |
Nome dell'invito. |
|
Invitare il nome
|
payload.first_name | string |
Nome dell'invitato che ha prenotato l'evento quando il tipo di evento è configurato per utilizzare campi separati per nome e cognome. Null quando il tipo di evento è configurato per l'utilizzo di un singolo campo per il nome. |
|
Nome dell'invito
|
payload.last_name | string |
Cognome dell'invitato che ha prenotato l'evento quando il tipo di evento è configurato per utilizzare campi separati per nome e cognome. Null quando il tipo di evento è configurato per l'utilizzo di un singolo campo per il nome. |
|
Nuovo URI dell'invito
|
payload.new_invitee | string |
Collegamento al nuovo mittente dell'invito, dopo la riprogrammazione. |
|
URI dell'invito precedente
|
payload.old_invitee | string |
Riferimento all'istanza di Invitee precedente che è stata riprogrammata. |
|
Raccolta delle risposte dell'invitato alle domande sul modulo di conferma della prenotazione dell'evento
|
payload.questions_and_answers | array of object |
Raccolta delle risposte dell'invitato alle domande sul modulo di conferma della prenotazione dell'evento. |
|
Domanda
|
payload.questions_and_answers.question | string |
Una domanda sul modulo di prenotazione dell'invitato. |
|
Risposta
|
payload.questions_and_answers.answer | string |
Risposta dell'invitato alla domanda. |
|
Posizione della domanda
|
payload.questions_and_answers.position | number |
Posizione della domanda in relazione ad altri nel modulo di prenotazione. |
|
URL evento reschedule
|
payload.reschedule_url | string |
Collegamento alla riprogrammazione dell'evento per l'invito. |
|
Invita reschedulato?
|
payload.rescheduled | boolean |
Riprogrammato |
|
Stato invito
|
payload.status | string |
status |
|
Numero di promemoria di testo dell'invito
|
payload.text_reminder_number | string |
text_reminder_number |
|
Invitare fuso orario
|
payload.timezone | string |
timezone |
|
Campagna UTM
|
payload.tracking.utm_campaign | string |
Parametro UTM usato per tenere traccia di una campagna. |
|
Origine UTM
|
payload.tracking.utm_source | string |
Parametro UTM che identifica l'origine (piattaforma in cui ha origine il traffico). |
|
UTM Medium
|
payload.tracking.utm_medium | string |
Parametro UTM che identifica il tipo di input ,ad esempio Costo per clic (CPC), social media, affiliate o codice a matrice. |
|
Contenuto UTM
|
payload.tracking.utm_content | string |
Parametro di rilevamento del contenuto UTM. |
|
Termine UTM
|
payload.tracking.utm_term | string |
Parametro UTM usato per tenere traccia della parola chiave. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificatore univoco del record Salesforce. |
|
URI dell'invito
|
payload.uri | string |
Riferimento canonico (identificatore univoco) per l'invitato. |
|
URI invio modulo di routing
|
payload.routing_form_submission | string |
Riferimento a un invio di modulo di routing che ha reindirizzato l'invitato a una pagina di prenotazione. |
|
scheduled_event
|
payload.scheduled_event | ScheduledEvent | |
|
cancellazione
|
payload.cancellation | Cancellation |
Fornisce i dati relativi all'annullamento dell'evento |
|
pagamento
|
payload.payment | Payment |
Invitare il pagamento |
|
no_show
|
payload.no_show | NoShow |
Fornisce i dati relativi all'oggetto no show associato per l'invito. |
|
riconferma
|
payload.reconfirmation | Reconfirmation |
Supponendo che la riconferma sia abilitata per il tipo di evento, quando viene richiesta la riconferma, questo oggetto è presente con un |
Definizioni
ScheduledEvent
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
URI evento
|
uri | uri |
Riferimento canonico (identificatore univoco) per la risorsa. |
|
Nome evento
|
name | string |
Nome dell'evento. |
|
Stato evento
|
status | string |
Indica se l'evento è "attivo" o "annullato". |
|
Ora di inizio evento
|
start_time | date-time |
Il momento in cui l'evento è stato pianificato per l'avvio in ora UTC (ad esempio, "2020-01-02T03:04:05.678123Z"). |
|
Ora di fine evento
|
end_time | date-time |
Il momento in cui l'evento è stato pianificato per terminare l'ora UTC ,ad esempio "2020-01-02T03:04:05.678123Z") |
|
URI del tipo di evento
|
event_type | uri |
Tipo di evento associato a questo evento |
|
ubicazione
|
location | Location |
Tipo di base polimorfico per una posizione evento supportata da Calendly |
|
Totale inviti
|
invitees_counter.total | number |
Totale inviti per un evento, inclusi gli invitati che hanno annullato |
|
Totale inviti attivi
|
invitees_counter.active | number |
Totale inviti per un evento che non è stato annullato. |
|
Numero massimo di inviti di eventi
|
invitees_counter.limit | number |
Numero massimo di invitati attivi che possono prenotare l'evento. |
|
Evento creato all'indirizzo
|
created_at | date-time |
Momento in cui è stato creato l'evento ,ad esempio "2020-01-02T03:04:05.678123Z") |
|
Evento aggiornato all'indirizzo
|
updated_at | date-time |
Il momento in cui l'evento è stato aggiornato per l'ultimo aggiornamento ,ad esempio "2020-01-02T03:04:05.678123Z") |
|
event_memberships
|
event_memberships | array of object |
Elenco di appartenenze a eventi |
|
URI membro dell'evento
|
event_memberships.user | uri |
Riferimento canonico (identificatore univoco) per l'utente. |
|
Messaggio di posta elettronica membro dell'evento
|
event_memberships.user_email |
Indirizzo e-mail dell'utente |
|
|
event_guests
|
event_guests | array of Guest |
Persone aggiuntive aggiunte a un evento da un invitato |
|
cancellazione
|
cancellation | Cancellation |
Fornisce i dati relativi all'annullamento dell'evento |
|
Calendar, evento
|
calendar_event | LegacyCalendarEvent |
Informazioni sull'evento del calendario dal provider di calendari. |
Annullamento
Fornisce i dati relativi all'annullamento dell'evento
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Annullata da
|
canceled_by | string |
Nome della persona che ha annullato. |
|
Motivo annullamento
|
reason | string |
Motivo per cui si è verificato l'annullamento. |
|
Tipo di annullatore
|
canceler_type | string |
Indica se l'evento è stato annullato da "Host" o "Invitee". |
Guest
Persona che un invitato ha invitato a essere un partecipante guest a un evento
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Messaggio di posta elettronica guest dell'evento
|
Messaggio di posta elettronica dell'utente guest dell'evento. |
||
|
Guest evento creato all'indirizzo
|
created_at | date-time |
Ora di creazione dell'evento guest. |
|
Evento guest aggiornato all'indirizzo
|
updated_at | date-time |
Ora dell'ultimo aggiornamento dell'utente guest dell'evento. |
Posizione
Tipo di base polimorfico per una posizione evento supportata da Calendly
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Tipo di posizione
|
type | string |
Indica il tipo di posizione dell'evento. |
|
Stato conferenza Web
|
status | string |
Questo campo si applica solo ai tipi di posizione zoom_conference, webex_conference, google_conference, gotomeeting e microsoft_teams_conference. |
|
URL riunione Web conference
|
join_url | uri |
Questo campo si applica solo ai tipi di posizione zoom_conference, webex_conference, google_conference, gotomeeting e microsoft_teams_conference. |
|
Posizione evento
|
location | string |
Questo campo si applica solo ai tipi di posizione outbound_call, inbound_call, fisici, ask_invitee e personalizzati. |
LegacyCalendarEvent
Informazioni sull'evento del calendario dal provider di calendari.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Tipo di evento Calendly
|
kind | string |
Indica al provider di calendario a cui appartiene l'evento. |
|
ID evento calendario esterno
|
external_id | string |
ID fornito dal provider di calendario per questo evento del calendario. |
Pagamento
Invitare il pagamento
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID esterno pagamento
|
external_id | string |
Identificatore univoco per il pagamento. |
|
Provider di pagamento
|
provider | string |
Provider di pagamenti. |
|
Importo pagamento
|
amount | float |
Importo del pagamento. |
|
Valuta del pagamento
|
currency | string |
Formato di valuta in cui si trova il pagamento. |
|
Condizioni di pagamento
|
terms | string |
Condizioni per il pagamento. |
|
Pagamento riuscito?
|
successful | boolean |
Indica se il pagamento è stato elaborato correttamente. |
NoShow
Fornisce i dati relativi all'oggetto no show associato per l'invito.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nessun URI di visualizzazione
|
uri | string |
Riferimento canonico (identificatore univoco) per il valore no show |
|
Nessuna mostra creata all'indirizzo
|
created_at | date-time |
Momento in cui è stata creata l'assenza di show. |
TipoDiEvento
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
URI del tipo di evento
|
uri | string |
Riferimento canonico (identificatore univoco) per il tipo di evento. |
|
Nome tipo di evento
|
name | string |
Nome del tipo di evento (in formato leggibile). |
|
Active
|
active | boolean |
Indica se l'evento è attivo o meno. |
|
Metodo di prenotazione
|
booking_method | string |
Indica se il tipo di evento è relativo a un polling o a una prenotazione immediata. |
|
Slug
|
slug | string |
Parte dell'URL del tipo di evento che identifica una pagina Web specifica (in un formato leggibile). |
|
URL di pianificazione
|
scheduling_url | string |
URL del sito di pianificazione dell'utente in cui gli invitati prenotano questo tipo di evento. |
|
Durata
|
duration | integer |
Lunghezza delle sessioni prenotato con questo tipo di evento. |
|
Kind
|
kind | string |
Indica se il tipo di evento è "solo" (appartiene a un singolo utente) o "gruppo". |
|
Tipo di pooling
|
pooling_type | string |
Indica se il tipo di evento è "round robin" (alternative tra host) o "collettivo" (invita a scegliere un'ora in cui tutti i partecipanti sono disponibili) o "null" (il tipo di evento non considera la disponibilità di un gruppo). |
|
TIPO
|
type | string |
Indica se il tipo di evento è "AdhocEventType" (evento ad hoc) o "StandardEventType" (tipo di evento standard). |
|
Colore
|
color | string |
Valore del colore esadecimale della pagina di pianificazione del tipo di evento. |
|
Creato all'indirizzo
|
created_at | string |
Momento in cui è stato creato il tipo di evento , ad esempio "2020-01-02T03:04:05.678123Z". |
|
Aggiornato all'indirizzo
|
updated_at | string |
Momento dell'ultimo aggiornamento del tipo di evento ,ad esempio "2020-01-02T03:04:05.678123Z"). |
|
Nota interna
|
internal_note | string |
Contenuto di una nota che può essere associato al tipo di evento. |
|
Descrizione (normale)
|
description_plain | string |
Descrizione del tipo di evento (in testo non formattato). |
|
Descrizione (HTML)
|
description_html | string |
Descrizione del tipo di evento (formattata con HTML). |
|
Tipo di profilo
|
profile.type | string |
Indica se il profilo appartiene a un "utente" (singolo) o "team". |
|
Nome profilo
|
profile.name | string |
Nome leggibile per il profilo dell'utente associato al tipo di evento. |
|
URI proprietario del profilo
|
profile.owner | string |
Riferimento univoco all'utente associato al profilo. |
|
Secret
|
secret | boolean |
Indica se il tipo di evento è nascosto nella pagina di pianificazione principale del proprietario. |
|
Eliminato all'indirizzo
|
deleted_at | string |
Il momento in cui il tipo di evento è stato eliminato ,ad esempio "2020-01-02T03:04:05.678123Z". |
|
Amministratore gestito
|
admin_managed | boolean |
Indica se questo tipo di evento è gestito da un amministratore dell'organizzazione. |
|
custom_questions
|
custom_questions | array of object |
custom_questions |
|
Nome domanda personalizzato
|
custom_questions.name | string |
nome |
|
Tipo di domanda personalizzato
|
custom_questions.type | string |
type |
|
Posizione della domanda personalizzata
|
custom_questions.position | integer |
posizione |
|
Domanda personalizzata abilitata
|
custom_questions.enabled | boolean |
enabled |
|
Domanda personalizzata obbligatoria
|
custom_questions.required | boolean |
required |
|
Opzioni di risposta alle domande personalizzate
|
custom_questions.answer_choices | array of string |
answer_choices |
|
Includi altro
|
custom_questions.include_other | boolean |
include_other |
Riconferma
Supponendo che la riconferma sia abilitata per il tipo di evento, quando viene richiesta la riconferma, questo oggetto è presente con un created_at oggetto che riflette quando è stata inviata la notifica di riconferma. Dopo che l'invito ha riconfermato l'attributo confirmed_at passerà da null a un timestamp che riflette quando ha eseguito l'azione.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Riconferma creata all'indirizzo
|
created_at | date-time |
Quando è stata creata la riconferma. |
|
Invitato confermato all'indirizzo
|
confirmed_at | date-time |
Quando l'invitato ha confermato la loro partecipazione. |