Calendly (préversion)
Le connecteur de Calendly vous permet d’automatiser les événements planifiés, de stimuler la productivité et d’optimiser l’efficacité par le biais de flux de travail automatisés.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Prise en charge calendly |
| URL | https://help.calendly.com/hc/en-us |
| Messagerie électronique | support@calendly.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Calendly |
| Site internet | https://calendly.com |
| Politique de confidentialité | https://calendly.com/privacy |
| Catégories | Productivité |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Jeton d’accès personnel | securestring | Jeton d’accès personnel pour cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Créer un invité sans affichage |
Marque un invité en tant que no show. |
| Obtenir des types d’événements |
Retourne tous les types d’événements associés à votre organisation. |
| Obtenir le type d’événement |
Retourne des informations sur un type d’événement spécifié. |
| Supprimer l’invite sans affichage |
Annule le marquage d’un invité en tant que no show |
Créer un invité sans affichage
Marque un invité en tant que no show.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
URI d’invite
|
invitee | True | string |
URI de l’invité qui est marqué comme No Show pour un événement planifié |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Aucun URI d’affichage
|
resource.uri | string |
Référence canonique (identificateur unique) pour l’absence d’affichage |
|
URI d’invite
|
resource.invitee | string |
Référence canonique (identificateur unique) pour l’invité associé |
|
Créé à
|
resource.created_at | string |
Moment où l’émission n’a pas été créée |
Obtenir des types d’événements
Retourne tous les types d’événements associés à votre organisation.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Active
|
active | boolean |
Retourne uniquement les types d’événements actifs si la valeur est true, inactive uniquement si false ou tous les types d’événements si ce paramètre est omis. |
|
|
Nombre
|
count | integer |
Nombre de lignes à retourner. |
|
|
Jeton de page
|
page_token | string |
Jeton à passer pour obtenir la partie suivante ou précédente de la collection. |
|
|
Géré par l’administrateur
|
admin_managed | boolean |
Retourne uniquement les types d’événements gérés par l’administrateur si true, excluez les types d’événements gérés par l’administrateur si false ou incluez tous les types d’événements si ce paramètre est omis. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
collection
|
collection | array of EventType |
collection |
|
Nombre de paginations
|
pagination.count | integer |
Nombre de lignes à retourner. |
|
URI de page suivante
|
pagination.next_page | string |
URI permettant de retourner la page suivante d’une liste triée (« null » indique qu’aucun résultat supplémentaire n’est disponible). |
|
URI de page précédente
|
pagination.previous_page | string |
URI permettant de retourner la page précédente d’une liste ordonnée (« null » indique qu’aucun résultat supplémentaire n’est disponible). |
|
Jeton de page suivant
|
pagination.next_page_token | string |
Jeton permettant de retourner la page suivante d’une liste ordonnée (« null » indique qu’aucun résultat supplémentaire n’est disponible). |
|
Jeton de page précédent
|
pagination.previous_page_token | string |
Jeton permettant de retourner la page précédente d’une liste ordonnée (« null » indique qu’aucun résultat supplémentaire n’est disponible). |
Obtenir le type d’événement
Retourne des informations sur un type d’événement spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Type d’événement UUID
|
uuid | True | string |
UUID du type d’événement demandé |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
resource
|
resource | EventType |
Supprimer l’invite sans affichage
Annule le marquage d’un invité en tant que no show
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Invitee No Show UUID
|
uuid | True | string |
UUID de l’invité dont l’enregistrement No Show est supprimé |
Retours
Aucun affichage supprimé avec succès
- 204
- string
Déclencheurs
| Créer un abonnement Webhook (envoi de formulaire de routage) |
Créez un abonnement Webhook pour une organisation déclenchée lorsqu’un formulaire de routage est envoyé. |
| Créer un abonnement Webhook (Invité) |
Créez un abonnement Webhook pour une organisation déclenchée lorsqu’un événement est planifié ou annulé. |
Créer un abonnement Webhook (envoi de formulaire de routage)
Créez un abonnement Webhook pour une organisation déclenchée lorsqu’un formulaire de routage est envoyé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Webhook créé à l’adresse
|
created_at | string |
Moment où le webhook a été créé (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
URI du créateur de webhook
|
created_by | string |
Référence à l’utilisateur qui a créé l’abonnement webhook. |
|
Webhook, événement
|
event | string |
Événement qui a provoqué le déclenchement du webhook. |
|
URI de soumission de formulaire de routage
|
payload.uri | string |
Référence canonique (identificateur unique) pour la soumission du formulaire de routage. |
|
URI du formulaire de routage
|
payload.routing_form | string |
URI du formulaire de routage associé à la soumission. |
|
questions_and_answers
|
payload.questions_and_answers | array of object |
questions_and_answers |
|
Question UUID
|
payload.questions_and_answers.question_uuid | string |
Identificateur unique pour la question du formulaire de routage. |
|
Question
|
payload.questions_and_answers.question | string |
Nom de la question (au format lisible par l’homme). |
|
Réponse
|
payload.questions_and_answers.answer | string |
Réponse fournie par l’intimé lorsque le formulaire a été soumis. |
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
payload.tracking.utm_campaign | string |
Paramètre RUNTIME utilisé pour effectuer le suivi d’une campagne. |
|
SOURCE OLE
|
payload.tracking.utm_source | string |
Paramètre SSH qui identifie la source (plateforme d’origine du trafic). |
|
MEDIUM DE L’APPLIANCE
|
payload.tracking.utm_medium | string |
Paramètre ASSEMBLY qui identifie le type d’entrée (par exemple, Coût par clic (CPP), médias sociaux, affiliés ou code QR). |
|
CONTENU DE L’OBJET
|
payload.tracking.utm_content | string |
PARAMÈTRE de suivi du contenu DE l’ASSEMBLY. |
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
payload.tracking.utm_term | string |
Paramètre RUNTIME utilisé pour suivre le mot clé. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificateur unique d’enregistrement Salesforce. |
|
Type de résultat
|
payload.result.type | string |
Indique si l’envoi du formulaire de routage a entraîné un message personnalisé, un type d’événement ou une URL externe. |
|
URI de l’analyseur de soumission
|
payload.submitter | string |
La référence à la ressource Invité lors du routage de l’envoi du formulaire entraîne une réunion planifiée. |
|
Submitter Type
|
payload.submitter_type | string |
Type de la ressource répondante qui a soumis le formulaire et planifié une réunion. |
|
Envoi de formulaire de routage créé à l’adresse
|
payload.created_at | string |
Moment où le formulaire de routage a été envoyé. |
|
Envoi de formulaire de routage mis à jour à l’adresse
|
payload.updated_at | string |
Moment où la soumission du formulaire de routage a été mise à jour pour la dernière fois. |
Créer un abonnement Webhook (Invité)
Créez un abonnement Webhook pour une organisation déclenchée lorsqu’un événement est planifié ou annulé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Webhook créé à l’adresse
|
created_at | string |
Moment où le webhook a été créé (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
URI du créateur de webhook
|
created_by | string |
Référence à l’utilisateur qui a créé l’abonnement webhook. |
|
Webhook, événement
|
event | string |
Événement qui a provoqué le déclenchement du webhook. |
|
Annuler l’URL de l’événement
|
payload.cancel_url | string |
Lien vers l’annulation de l’événement pour l’invité. |
|
Invité créé à l’adresse
|
payload.created_at | string |
Moment où l’événement a été créé (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
E-mail d’invitation
|
payload.email | string |
Adresse e-mail de l’invité. |
|
URI d’événement
|
payload.event | string |
Référence à l’événement. |
|
Nom de l’invité
|
payload.name | string |
Nom de l’invité. |
|
Prénom de l’invité
|
payload.first_name | string |
Prénom de l’invité qui a réservé l’événement lorsque le type d’événement est configuré pour utiliser des champs distincts pour le prénom et le nom. Null lorsque le type d’événement est configuré pour utiliser un champ unique pour le nom. |
|
Nom de l’invité
|
payload.last_name | string |
Nom de l’invité qui a réservé l’événement lorsque le type d’événement est configuré pour utiliser des champs distincts pour le prénom et le nom. Null lorsque le type d’événement est configuré pour utiliser un champ unique pour le nom. |
|
Nouvel URI d’invite
|
payload.new_invitee | string |
Lien vers un nouvel invité, après replanifier. |
|
URI de l’ancien invité
|
payload.old_invitee | string |
Référence à l’ancienne instance d’invite qui a été replanifiée. |
|
Collection des réponses de l’invité aux questions sur le formulaire de confirmation de réservation d’événements
|
payload.questions_and_answers | array of object |
Collection des réponses de l’invité aux questions sur le formulaire de confirmation de réservation d’événements. |
|
Question
|
payload.questions_and_answers.question | string |
Question sur le formulaire de réservation de l’invité. |
|
Réponse
|
payload.questions_and_answers.answer | string |
Réponse de l’invité à la question. |
|
Question Position
|
payload.questions_and_answers.position | number |
Position de la question par rapport aux autres sur le formulaire de réservation. |
|
URL de l’événement Reschedule
|
payload.reschedule_url | string |
Lien pour réécrire l’événement pour l’invité. |
|
Invitee Rescheduled ?
|
payload.rescheduled | boolean |
Reportée |
|
État de l’invite
|
payload.status | string |
status |
|
Numéro de rappel de texte invité
|
payload.text_reminder_number | string |
text_reminder_number |
|
Fuseau horaire de l’invite
|
payload.timezone | string |
timezone |
|
CAMPAGNE DE L’ANALYSE DES DONNÉES
|
payload.tracking.utm_campaign | string |
Paramètre RUNTIME utilisé pour effectuer le suivi d’une campagne. |
|
SOURCE OLE
|
payload.tracking.utm_source | string |
Paramètre SSH qui identifie la source (plateforme d’origine du trafic). |
|
MEDIUM DE L’APPLIANCE
|
payload.tracking.utm_medium | string |
Paramètre ASSEMBLY qui identifie le type d’entrée (par exemple, Coût par clic (CPP), médias sociaux, affiliés ou code QR). |
|
CONTENU DE L’OBJET
|
payload.tracking.utm_content | string |
PARAMÈTRE de suivi du contenu DE l’ASSEMBLY. |
|
TERMES DE LA DURÉE DE L’EXPRESSION
|
payload.tracking.utm_term | string |
Paramètre RUNTIME utilisé pour suivre le mot clé. |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Identificateur unique d’enregistrement Salesforce. |
|
URI d’invite
|
payload.uri | string |
Référence canonique (identificateur unique) pour l’invité. |
|
URI de soumission de formulaire de routage
|
payload.routing_form_submission | string |
Référence à une soumission de formulaire de routage qui a redirigé l’invité vers une page de réservation. |
|
scheduled_event
|
payload.scheduled_event | ScheduledEvent | |
|
annulation
|
payload.cancellation | Cancellation |
Fournit des données relatives à l’annulation de l’événement |
|
paiement
|
payload.payment | Payment |
Paiement d’invitation |
|
no_show
|
payload.no_show | NoShow |
Fournit des données relatives à l’absence d’affichage associée pour l’invité. |
|
Reconfirmation
|
payload.reconfirmation | Reconfirmation |
En supposant que la reconfirmation est activée pour le type d’événement, lorsque la reconfirmation est demandée, cet objet est présent avec un |
Définitions
ScheduledEvent
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
URI d’événement
|
uri | uri |
Référence canonique (identificateur unique) pour la ressource. |
|
Nom de l'événement
|
name | string |
Nom de l’événement. |
|
État de l’événement
|
status | string |
Indique si l’événement est « actif » ou « annulé ». |
|
Heure de début de l’événement
|
start_time | date-time |
Le moment où l’événement a été planifié pour commencer à l’heure UTC (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
Heure de fin de l’événement
|
end_time | date-time |
Moment où l’événement a été planifié pour se terminer en heure UTC (par exemple, « 2020-01-02T03:04:05.678123Z ») |
|
URI de type d’événement
|
event_type | uri |
Type d’événement associé à cet événement |
|
location
|
location | Location |
Type de base polymorphe pour un emplacement d’événement pris en charge par Calendly |
|
Nombre total d’invités
|
invitees_counter.total | number |
Nombre total d’invitations pour un événement, y compris les invitations qui ont été annulées |
|
Nombre total d’invités actifs
|
invitees_counter.active | number |
Nombre total d’invitations pour un événement qui n’a pas été annulé. |
|
Invitees maximales d’événements
|
invitees_counter.limit | number |
Nombre maximal d’invités actifs pouvant réserver l’événement. |
|
Événement créé à l’adresse
|
created_at | date-time |
Moment où l’événement a été créé (par exemple, « 2020-01-02T03:04:05.678123Z ») |
|
Événement mis à jour à l’adresse
|
updated_at | date-time |
Moment où l’événement a été mis à jour pour la dernière fois (par exemple, « 2020-01-02T03:04:05.678123Z ») |
|
event_memberships
|
event_memberships | array of object |
Liste des appartenances aux événements |
|
URI du membre d’événement
|
event_memberships.user | uri |
Référence canonique (identificateur unique) pour l’utilisateur. |
|
E-mail de membre d’événement
|
event_memberships.user_email |
Adresse de messagerie de l’utilisateur. |
|
|
event_guests
|
event_guests | array of Guest |
Autres personnes ajoutées à un événement par un invité |
|
annulation
|
cancellation | Cancellation |
Fournit des données relatives à l’annulation de l’événement |
|
Événement de calendrier
|
calendar_event | LegacyCalendarEvent |
Informations sur l’événement de calendrier du fournisseur de calendrier. |
Annulation
Fournit des données relatives à l’annulation de l’événement
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Annulé par
|
canceled_by | string |
Nom de la personne qui a annulé. |
|
Raison de l’annulation
|
reason | string |
Raison pour laquelle l’annulation s’est produite. |
|
Type d’annulateur
|
canceler_type | string |
Indique si l’événement a été annulé par l'« hôte » ou « Invitee ». |
Invité
Personne invitée à participer à un événement
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
E-mail invité de l’événement
|
E-mail de l’invité de l’événement. |
||
|
Invité de l’événement créé à l’adresse
|
created_at | date-time |
Heure de création de l’invité de l’événement. |
|
Invité de l’événement mis à jour à l’adresse
|
updated_at | date-time |
Heure de la dernière mise à jour de l’invité de l’événement. |
Emplacement
Type de base polymorphe pour un emplacement d’événement pris en charge par Calendly
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Type d’emplacement
|
type | string |
Indique le type d’emplacement de l’événement. |
|
État de la conférence web
|
status | string |
Ce champ s’applique uniquement aux types d’emplacements zoom_conference, webex_conference, google_conference, gotomeeting et microsoft_teams_conference. |
|
URL de réunion de conférence web
|
join_url | uri |
Ce champ s’applique uniquement aux types d’emplacements zoom_conference, webex_conference, google_conference, gotomeeting et microsoft_teams_conference. |
|
Emplacement de l’événement
|
location | string |
Ce champ s’applique uniquement aux types d’emplacements personnalisés outbound_call, inbound_call, physiques, ask_invitee et personnalisés. |
LegacyCalendarEvent
Informations sur l’événement de calendrier du fournisseur de calendrier.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Type d’événement Calendly
|
kind | string |
Indique le fournisseur de calendrier auquel appartient l’événement. |
|
ID d’événement calendrier externe
|
external_id | string |
ID fourni par le fournisseur de calendrier pour cet événement de calendrier. |
Paiement
Paiement d’invitation
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID externe de paiement
|
external_id | string |
Identificateur unique pour le paiement. |
|
Fournisseur de paiement
|
provider | string |
Fournisseur de paiement. |
|
Montant du paiement
|
amount | float |
Montant du paiement. |
|
Devise de paiement
|
currency | string |
Format monétaire dans lequel se trouve le paiement. |
|
Conditions de paiement
|
terms | string |
Conditions du paiement. |
|
Paiement réussi ?
|
successful | boolean |
Indique si le paiement a été traité avec succès. |
NoShow
Fournit des données relatives à l’absence d’affichage associée pour l’invité.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Aucun URI d’affichage
|
uri | string |
Référence canonique (identificateur unique) pour l’absence d’affichage |
|
Aucun affichage créé à l’adresse
|
created_at | date-time |
Moment où l’émission n’a pas été créée. |
EventType
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
URI de type d’événement
|
uri | string |
Référence canonique (identificateur unique) pour le type d’événement. |
|
Nom du type d’événement
|
name | string |
Nom du type d’événement (au format lisible par l’homme). |
|
Active
|
active | boolean |
Indique si l’événement est actif ou non. |
|
Booking, méthode
|
booking_method | string |
Indique si le type d’événement concerne un sondage ou une réservation instantanée. |
|
Slug
|
slug | string |
Partie de l’URL du type d’événement qui identifie une page web spécifique (dans un format lisible par l’homme). |
|
URL de planification
|
scheduling_url | string |
URL du site de planification de l’utilisateur où les invités réservent ce type d’événement. |
|
Durée
|
duration | integer |
Durée des sessions réservées avec ce type d’événement. |
|
Kind
|
kind | string |
Indique si le type d’événement est « solo » (appartient à un utilisateur individuel) ou « group ». |
|
Type de regroupement
|
pooling_type | string |
Indique si le type d’événement est « tourniquet » (alternative entre les hôtes) ou « collectif » (les invitations sélectionnent une heure lorsque tous les participants sont disponibles) ou « null » (le type d’événement ne prend pas en compte la disponibilité d’un participant de groupe). |
|
Type
|
type | string |
Indique si le type d’événement est « AdhocEventType » (événement ad hoc) ou « StandardEventType » (type d’événement standard). |
|
Color
|
color | string |
Valeur de couleur hexadécimale de la page de planification du type d’événement. |
|
Créé à
|
created_at | string |
Moment où le type d’événement a été créé (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
Mise à jour à
|
updated_at | string |
Moment où le type d’événement a été mis à jour (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
Note interne
|
internal_note | string |
Contenu d’une note qui peut être associée au type d’événement. |
|
Description (simple)
|
description_plain | string |
Description du type d’événement (en texte non mis en forme). |
|
Description (HTML)
|
description_html | string |
Description du type d’événement (mise en forme avec HTML). |
|
Type de profil
|
profile.type | string |
Indique si le profil appartient à un « utilisateur » (individuel) ou à une « équipe ». |
|
Nom du profil
|
profile.name | string |
Nom lisible par l’homme pour le profil de l’utilisateur associé au type d’événement. |
|
URI du propriétaire du profil
|
profile.owner | string |
Référence unique à l’utilisateur associé au profil. |
|
Secret
|
secret | boolean |
Indique si le type d’événement est masqué sur la page de planification principale du propriétaire. |
|
Supprimé à
|
deleted_at | string |
Moment où le type d’événement a été supprimé (par exemple, « 2020-01-02T03:04:05.678123Z »). |
|
Géré par l’administrateur
|
admin_managed | boolean |
Indique si ce type d’événement est géré par un administrateur d’organisation. |
|
custom_questions
|
custom_questions | array of object |
custom_questions |
|
Nom de la question personnalisée
|
custom_questions.name | string |
nom |
|
Type de question personnalisé
|
custom_questions.type | string |
type |
|
Position des questions personnalisées
|
custom_questions.position | integer |
position |
|
Question personnalisée activée
|
custom_questions.enabled | boolean |
enabled |
|
Question personnalisée requise
|
custom_questions.required | boolean |
obligatoire |
|
Choix de réponses aux questions personnalisées
|
custom_questions.answer_choices | array of string |
answer_choices |
|
Inclure d’autres
|
custom_questions.include_other | boolean |
include_other |
Reconfirmation
En supposant que la reconfirmation est activée pour le type d’événement, lorsque la reconfirmation est demandée, cet objet est présent avec un created_at reflet lorsque la notification de reconfirmation a été envoyée. Une fois que l’invité a reconfirmé l’attribut confirmed_at passe d’un null horodatage qui reflète lorsqu’il a pris des mesures.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Reconfirmation créée à l’adresse
|
created_at | date-time |
Lorsque la reconfirmation a été créée. |
|
Invité confirmé à
|
confirmed_at | date-time |
Lorsque l’invité a confirmé sa présence. |