Delen via


Calendly (preview)

Met de connector van Calendly kunt u geplande gebeurtenissen automatiseren, de productiviteit verhogen en de efficiëntie optimaliseren via geautomatiseerde werkstromen.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Ondersteuning voor Calendly
URL https://help.calendly.com/hc/en-us
E-mailen support@calendly.com
Connectormetagegevens
Uitgever Calendly
Webpagina https://calendly.com
Privacybeleid https://calendly.com/privacy
Categorieën Productiviteit

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam Typologie Description Verplicht
Persoonlijk toegangstoken beveiligde string Het persoonlijke toegangstoken voor deze API Klopt

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Gebeurtenistype ophalen

Retourneert informatie over een opgegeven gebeurtenistype.

Gebeurtenistypen ophalen

Retourneert alle gebeurtenistypen die zijn gekoppeld aan uw organisatie.

Genodigde geen voorstelling maken

Markeert een genodigde als geen voorstelling.

Genodigde niet weergeven verwijderen

De markering van een genodigde ongedaan maken als geen voorstelling

Gebeurtenistype ophalen

Retourneert informatie over een opgegeven gebeurtenistype.

Parameters

Name Sleutel Vereist Type Description
Gebeurtenistype UUID
uuid True string

UUID van het gebeurtenistype dat wordt aangevraagd

Retouren

Name Pad Type Description
resource
resource EventType

Gebeurtenistypen ophalen

Retourneert alle gebeurtenistypen die zijn gekoppeld aan uw organisatie.

Parameters

Name Sleutel Vereist Type Description
Active
active boolean

Retourneer alleen actieve gebeurtenistypen indien waar, alleen inactief als onwaar of alle gebeurtenistypen als deze parameter wordt weggelaten.

Aantal
count integer

Het aantal rijen dat moet worden geretourneerd.

Paginatoken
page_token string

Het token dat moet worden doorgegeven om het volgende of vorige gedeelte van de verzameling op te halen.

Beheerd door beheerder
admin_managed boolean

Retourneer alleen door de beheerder beheerde gebeurtenistypen indien waar, sluit beheerde gebeurtenistypen van de beheerder uit als deze parameter onwaar is of alle gebeurtenistypen opneemt als deze parameter wordt weggelaten.

Retouren

Name Pad Type Description
collectie
collection array of EventType

collectie

Aantal pagineringen
pagination.count integer

Het aantal rijen dat moet worden geretourneerd.

URI van volgende pagina
pagination.next_page string

URI om de volgende pagina van een geordende lijst te retourneren ('null' geeft aan dat er geen extra resultaten beschikbaar zijn).

Vorige pagina-URI
pagination.previous_page string

URI om de vorige pagina van een geordende lijst te retourneren ('null' geeft aan dat er geen extra resultaten beschikbaar zijn).

Token volgende pagina
pagination.next_page_token string

Token om de volgende pagina van een geordende lijst te retourneren ('null' geeft aan dat er geen extra resultaten beschikbaar zijn).

Vorige paginatoken
pagination.previous_page_token string

Token om de vorige pagina van een geordende lijst te retourneren ('null' geeft aan dat er geen extra resultaten beschikbaar zijn).

Genodigde geen voorstelling maken

Markeert een genodigde als geen voorstelling.

Parameters

Name Sleutel Vereist Type Description
Genodigde URI
invitee True string

URI van de genodigde die wordt gemarkeerd als Geen voorstelling voor een geplande gebeurtenis

Retouren

Name Pad Type Description
Geen URI weergeven
resource.uri string

Canonieke verwijzing (unieke id) voor de no show

Genodigde URI
resource.invitee string

Canonieke verwijzing (unieke id) voor de bijbehorende genodigde

Gemaakt op
resource.created_at string

Het moment waarop de no show is gemaakt

Genodigde niet weergeven verwijderen

De markering van een genodigde ongedaan maken als geen voorstelling

Parameters

Name Sleutel Vereist Type Description
Genodigde geen UUID weergeven
uuid True string

UUID van de genodigde waarvan de record Geen voorstelling wordt verwijderd

Retouren

Er is geen show verwijderd

204
string

Triggers

Een webhookabonnement maken (genodigde)

Maak een webhookabonnement voor een organisatie die wordt geactiveerd wanneer een gebeurtenis wordt gepland of geannuleerd.

Een webhookabonnement maken (verzending van routeringsformulier)

Maak een webhookabonnement voor een organisatie die wordt geactiveerd wanneer een routeringsformulier wordt verzonden.

Een webhookabonnement maken (genodigde)

Maak een webhookabonnement voor een organisatie die wordt geactiveerd wanneer een gebeurtenis wordt gepland of geannuleerd.

Parameters

Name Sleutel Vereist Type Description
events
events True array of string

events

Retouren

Name Pad Type Description
Webhook gemaakt op
created_at string

Het moment waarop de webhook is gemaakt (bijvoorbeeld "2020-01-02T03:04:05.678123Z").

Webhook Creator URI
created_by string

Een verwijzing naar de gebruiker die het webhookabonnement heeft gemaakt.

Webhook-gebeurtenis
event string

De gebeurtenis waardoor de webhook is geactiveerd.

Gebeurtenis-URL annuleren
payload.cancel_url string

Koppeling om de gebeurtenis voor de genodigde te annuleren.

Genodigde gemaakt op
payload.created_at string

Het moment waarop de gebeurtenis is gemaakt (bijvoorbeeld '2020-01-02T03:04:05.678123Z').

Genodigde e-mail
payload.email string

Het e-mailadres van de genodigde.

Gebeurtenis-URI
payload.event string

Een verwijzing naar de gebeurtenis.

Naam van genodigde
payload.name string

De naam van de genodigde.

Voornaam genodigde
payload.first_name string

De voornaam van de genodigde die de gebeurtenis heeft geboekt wanneer het gebeurtenistype is geconfigureerd voor het gebruik van afzonderlijke velden voor voornaam en achternaam. Null wanneer het gebeurtenistype is geconfigureerd voor het gebruik van één veld voor de naam.

Achternaam van genodigde
payload.last_name string

De achternaam van de genodigde die de gebeurtenis heeft geboekt wanneer het gebeurtenistype is geconfigureerd voor het gebruik van afzonderlijke velden voor voornaam en achternaam. Null wanneer het gebeurtenistype is geconfigureerd voor het gebruik van één veld voor de naam.

Nieuwe URI voor genodigden
payload.new_invitee string

Maak een koppeling naar de nieuwe genodigde, na het opnieuw plannen.

Oude URI genodigden
payload.old_invitee string

Verwijzing naar het oude genodigde exemplaar dat opnieuw is gepland.

Een verzameling van de antwoorden van de genodigde op vragen over het bevestigingsformulier van de gebeurtenisboeking
payload.questions_and_answers array of object

Een verzameling antwoorden van de genodigde op vragen over het bevestigingsformulier voor het reserveren van het evenement.

Question
payload.questions_and_answers.question string

Een vraag over het reserveringsformulier van de genodigde.

Antwoord
payload.questions_and_answers.answer string

Het antwoord van de genodigde op de vraag.

Positie van vraag
payload.questions_and_answers.position number

De positie van de vraag ten opzichte van anderen op het boekingsformulier.

Gebeurtenis-URL opnieuw plannen
payload.reschedule_url string

Koppeling om de gebeurtenis opnieuw te plannen voor de genodigde.

Genodigde opnieuw gepland?
payload.rescheduled boolean

Gepland

Status van genodigde
payload.status string

status

Herinneringsnummer voor genodigde tekst
payload.text_reminder_number string

text_reminder_number

Genodigde tijdzone
payload.timezone string

timezone

UTM-campagne
payload.tracking.utm_campaign string

De UTM-parameter die wordt gebruikt om een campagne bij te houden.

UTM-bron
payload.tracking.utm_source string

De UTM-parameter die de bron identificeert (platform waar het verkeer vandaan komt).

UTM Medium
payload.tracking.utm_medium string

De UTM-parameter die het type invoer identificeert (bijvoorbeeld Cost Per Click (CPC), sociale media, affiliate of QR-code.

UTM-inhoud
payload.tracking.utm_content string

UTM-parameter voor het bijhouden van inhoud.

UTM-term
payload.tracking.utm_term string

De UTM-parameter die wordt gebruikt voor het bijhouden van trefwoorden.

Salesforce UUID
payload.tracking.salesforce_uuid string

De unieke id van de Salesforce-record.

Genodigde URI
payload.uri string

Canonieke verwijzing (unieke id) voor de genodigde.

URI voor verzending van routeringsformulier
payload.routing_form_submission string

Verwijzing naar een indiening van een routeringsformulier waarmee de genodigde wordt omgeleid naar een boekingspagina.

scheduled_event
payload.scheduled_event ScheduledEvent
afgelasting
payload.cancellation Cancellation

Biedt gegevens met betrekking tot de annulering van de gebeurtenis

betaling
payload.payment Payment

Genodigde betaling

no_show
payload.no_show NoShow

Biedt gegevens met betrekking tot de gekoppelde no show voor de genodigde.

Herbevestiging
payload.reconfirmation Reconfirmation

Ervan uitgaande dat opnieuw bevestigen is ingeschakeld voor het gebeurtenistype, is dit object aanwezig wanneer opnieuw bevestigen wordt aangevraagd met een created_at object dat aangeeft wanneer de bevestigingsmelding is verzonden. Zodra de genodigde opnieuw heeft bevestigd, wordt het confirmed_at kenmerk gewijzigd van null een tijdstempel die aangeeft wanneer ze actie hebben ondernomen.

Een webhookabonnement maken (verzending van routeringsformulier)

Maak een webhookabonnement voor een organisatie die wordt geactiveerd wanneer een routeringsformulier wordt verzonden.

Parameters

Name Sleutel Vereist Type Description
events
events True array of string

events

Retouren

Name Pad Type Description
Webhook gemaakt op
created_at string

Het moment waarop de webhook is gemaakt (bijvoorbeeld "2020-01-02T03:04:05.678123Z").

Webhook Creator URI
created_by string

Een verwijzing naar de gebruiker die het webhookabonnement heeft gemaakt.

Webhook-gebeurtenis
event string

De gebeurtenis waardoor de webhook is geactiveerd.

URI voor verzending van routeringsformulier
payload.uri string

Canonieke verwijzing (unieke id) voor het verzenden van het routeringsformulier.

URI voor routeringsformulier
payload.routing_form string

De URI van het routeringsformulier dat is gekoppeld aan de inzending.

questions_and_answers
payload.questions_and_answers array of object

questions_and_answers

Vraag UUID
payload.questions_and_answers.question_uuid string

Unieke id voor de vraag over het routeringsformulier.

Question
payload.questions_and_answers.question string

Vraagnaam (in door mensen leesbare indeling).

Antwoord
payload.questions_and_answers.answer string

Antwoord van de respondent op het moment dat het formulier is ingediend.

UTM-campagne
payload.tracking.utm_campaign string

De UTM-parameter die wordt gebruikt om een campagne bij te houden.

UTM-bron
payload.tracking.utm_source string

De UTM-parameter die de bron identificeert (platform waar het verkeer vandaan komt).

UTM Medium
payload.tracking.utm_medium string

De UTM-parameter die het type invoer identificeert (bijvoorbeeld Cost Per Click (CPC), sociale media, affiliate of QR-code.

UTM-inhoud
payload.tracking.utm_content string

UTM-parameter voor het bijhouden van inhoud.

UTM-term
payload.tracking.utm_term string

De UTM-parameter die wordt gebruikt voor het bijhouden van trefwoorden.

Salesforce UUID
payload.tracking.salesforce_uuid string

De unieke id van de Salesforce-record.

Resultaattype
payload.result.type string

Geeft aan of het verzenden van het routeringsformulier heeft geresulteerd in een aangepast bericht, gebeurtenistype of externe URL.

Verzender-URI
payload.submitter string

De verwijzing naar de genodigde resource wanneer het verzenden van formulieren wordt verzonden, resulteert in een geplande vergadering.

Type verzender
payload.submitter_type string

Type van de respondentresource die het formulier heeft ingediend en een vergadering heeft gepland.

Verzending van routeringsformulier gemaakt op
payload.created_at string

Het moment dat het routeringsformulier is verzonden.

Verzending van routeringsformulier bijgewerkt op
payload.updated_at string

Het moment waarop het verzenden van het routeringsformulier voor het laatst is bijgewerkt.

Definities

ScheduledEvent

Name Pad Type Description
Gebeurtenis-URI
uri uri

Canonieke verwijzing (unieke id) voor de resource.

Gebeurtenisnaam
name string

De naam van de gebeurtenis.

Gebeurtenisstatus
status string

Geeft aan of de gebeurtenis 'actief' of 'geannuleerd' is.

Begintijd van gebeurtenis
start_time date-time

Het moment waarop de gebeurtenis is gepland om te beginnen in UTC-tijd (bijvoorbeeld '2020-01-02T03:04:05.678123Z').

Eindtijd van gebeurtenis
end_time date-time

Het moment waarop de gebeurtenis is gepland om te eindigen in UTC-tijd (bijvoorbeeld '2020-01-02T03:04:05.678123Z')

Gebeurtenistype-URI
event_type uri

Het gebeurtenistype dat is gekoppeld aan deze gebeurtenis

location
location Location

Het polymorfe basistype voor een gebeurtenislocatie die Calendly ondersteunt

Totaal aantal genodigden
invitees_counter.total number

Totaal aantal genodigden voor een gebeurtenis, inclusief genodigden die zijn geannuleerd

Totaal aantal actieve genodigden
invitees_counter.active number

Totaal aantal genodigden voor een gebeurtenis die niet is geannuleerd.

Genodigden voor het maximum aantal gebeurtenissen
invitees_counter.limit number

Maximum aantal actieve genodigden dat de gebeurtenis kan boeken.

Gebeurtenis gemaakt op
created_at date-time

Het moment waarop de gebeurtenis is gemaakt (bijvoorbeeld "2020-01-02T03:04:05.678123Z")

Gebeurtenis bijgewerkt op
updated_at date-time

Het moment waarop de gebeurtenis voor het laatst is bijgewerkt (bijvoorbeeld "2020-01-02T03:04:05.678123Z")

event_memberships
event_memberships array of object

Lijst met gebeurtenislidmaatschappen

URI gebeurtenislid
event_memberships.user uri

Canonical reference (unieke id) voor de gebruiker.

E-mailadres gebeurtenislid
event_memberships.user_email email

Het e-mailadres van de gebruiker.

event_guests
event_guests array of Guest

Extra personen toegevoegd aan een gebeurtenis door een genodigde

afgelasting
cancellation Cancellation

Biedt gegevens met betrekking tot de annulering van de gebeurtenis

Agendagebeurtenis
calendar_event LegacyCalendarEvent

Informatie over de agendagebeurtenis van de agendaprovider.

Annulering

Biedt gegevens met betrekking tot de annulering van de gebeurtenis

Name Pad Type Description
Geannuleerd door
canceled_by string

Naam van de persoon die is geannuleerd.

Reden van annulering
reason string

Reden dat de annulering heeft plaatsgevonden.

Type annuleren
canceler_type string

Geeft aan of de gebeurtenis is geannuleerd door de 'Host' of 'Genodigde'.

Guest

Een persoon die een genodigde heeft uitgenodigd om gastgenodigde te zijn voor een gebeurtenis

Name Pad Type Description
E-mail gebeurtenisgast
email email

Het e-mailadres van de gebeurtenisgast.

Gebeurtenisgast gemaakt op
created_at date-time

Tijdstip waarop de gebeurtenisgast is gemaakt.

Gebeurtenisgast bijgewerkt op
updated_at date-time

Tijdstip waarop de gebeurtenisgast voor het laatst is bijgewerkt.

Locatie

Het polymorfe basistype voor een gebeurtenislocatie die Calendly ondersteunt

Name Pad Type Description
Locatietype
type string

Geeft het locatietype van de gebeurtenis aan.

Status van webvergadering
status string

Dit veld is alleen van toepassing op zoom_conference, webex_conference, google_conference, gotomeeting en microsoft_teams_conference locatietypen.

URL van webvergadering
join_url uri

Dit veld is alleen van toepassing op zoom_conference, webex_conference, google_conference, gotomeeting en microsoft_teams_conference locatietypen.

Locatie van gebeurtenis
location string

Dit veld is alleen van toepassing op outbound_call, inbound_call, fysieke, ask_invitee en aangepaste locatietypen.

LegacyCalendarEvent

Informatie over de agendagebeurtenis van de agendaprovider.

Name Pad Type Description
Soort calendly-gebeurtenis
kind string

Geeft de agendaprovider aan waartoe de gebeurtenis behoort.

Gebeurtenis-id van externe agenda
external_id string

De id die is opgegeven van de agendaprovider voor deze agendagebeurtenis.

Betaling

Genodigde betaling

Name Pad Type Description
Externe betalings-id
external_id string

Unieke id voor de betaling.

Betalingsprovider
provider string

Betalingsprovider.

Betalingsbedrag
amount float

Het bedrag van de betaling.

Betalingsvaluta
currency string

De valutanotatie waarin de betaling zich bevindt.

Betalingsvoorwaarden
terms string

Voorwaarden van de betaling.

Betaling geslaagd?
successful boolean

Geeft aan of de betaling is verwerkt.

NoShow

Biedt gegevens met betrekking tot de gekoppelde no show voor de genodigde.

Name Pad Type Description
Geen URI weergeven
uri string

Canonieke verwijzing (unieke id) voor de no show

Geen weergave gemaakt op
created_at date-time

Het moment waarop de show niet werd gemaakt.

Type van evenement

Name Pad Type Description
Gebeurtenistype-URI
uri string

Canonieke verwijzing (unieke id) voor het gebeurtenistype.

Naam van gebeurtenistype
name string

De naam van het gebeurtenistype (in door mensen leesbare indeling).

Active
active boolean

Geeft aan of de gebeurtenis actief is of niet.

Boekingsmethode
booking_method string

Geeft aan of het gebeurtenistype voor een peiling of een directe boeking is.

Slug
slug string

Het gedeelte van de URL van het gebeurtenistype dat een specifieke webpagina identificeert (in een door mensen leesbare indeling).

Plannings-URL
scheduling_url string

De URL van de planningssite van de gebruiker waar genodigden dit gebeurtenistype boeken.

Duur
duration integer

De duur van sessies die zijn geboekt met dit gebeurtenistype.

Kind
kind string

Geeft aan of het gebeurtenistype 'solo' is (behoort tot een afzonderlijke gebruiker) of 'groep'.

Poolingstype
pooling_type string

Geeft aan of het gebeurtenistype 'round robin' is (afwisselend tussen hosts) of 'collectief' (genodigden kiezen een tijdstip waarop alle deelnemers beschikbaar zijn) of 'null' (het gebeurtenistype houdt niet rekening met de beschikbaarheid van een groepsdeelnemer).

Typologie
type string

Geeft aan of het gebeurtenistype 'AdhocEventType' (ad hoc-gebeurtenis) of StandardEventType (standaard gebeurtenistype) is.

Kleur
color string

De hexadecimale kleurwaarde van de planningspagina van het gebeurtenistype.

Gemaakt op
created_at string

Het moment dat het gebeurtenistype is gemaakt (bijvoorbeeld '2020-01-02T03:04:05.678123Z').

Bijgewerkt op
updated_at string

Het moment waarop het gebeurtenistype voor het laatst is bijgewerkt (bijvoorbeeld '2020-01-02T03:04:05.678123Z').

Interne notitie
internal_note string

Inhoud van een notitie die kan worden gekoppeld aan het gebeurtenistype.

Beschrijving (zonder opmaak)
description_plain string

De beschrijving van het gebeurtenistype (in niet-opgemaakte tekst).

Beschrijving (HTML)
description_html string

De beschrijving van het gebeurtenistype (opgemaakt met HTML).

Profieltype
profile.type string

Geeft aan of het profiel deel uitmaakt van een 'gebruiker' (afzonderlijk) of 'team'.

Profielnaam
profile.name string

Leesbare naam voor het profiel van de gebruiker die is gekoppeld aan het gebeurtenistype.

URI van profieleigenaar
profile.owner string

De unieke verwijzing naar de gebruiker die is gekoppeld aan het profiel.

Geheim
secret boolean

Geeft aan of het gebeurtenistype verborgen is op de hoofdplanningspagina van de eigenaar.

Verwijderd op
deleted_at string

Het moment dat het gebeurtenistype is verwijderd (bijvoorbeeld '2020-01-02T03:04:05.678123Z').

Beheerd door beheerder
admin_managed boolean

Geeft aan of dit gebeurtenistype wordt beheerd door een organisatiebeheerder.

custom_questions
custom_questions array of object

custom_questions

Naam van aangepaste vraag
custom_questions.name string

naam

Aangepast vraagtype
custom_questions.type string

type

Positie van aangepaste vraag
custom_questions.position integer

positie

Aangepaste vraag ingeschakeld
custom_questions.enabled boolean

enabled

Aangepaste vraag vereist
custom_questions.required boolean

required

Aangepaste antwoordkeuzes voor vragen
custom_questions.answer_choices array of string

answer_choices

Andere opnemen
custom_questions.include_other boolean

include_other

Herbevestiging

Ervan uitgaande dat opnieuw bevestigen is ingeschakeld voor het gebeurtenistype, is dit object aanwezig wanneer opnieuw bevestigen wordt aangevraagd met een created_at object dat aangeeft wanneer de bevestigingsmelding is verzonden. Zodra de genodigde opnieuw heeft bevestigd, wordt het confirmed_at kenmerk gewijzigd van null een tijdstempel die aangeeft wanneer ze actie hebben ondernomen.

Name Pad Type Description
Opnieuw bevestigen gemaakt op
created_at date-time

Toen de bevestiging werd gemaakt.

Genodigde bevestigd op
confirmed_at date-time

Wanneer de genodigde hun aanwezigheid heeft bevestigd.