Udostępnij przez


Calendly (wersja zapoznawcza)

Łącznik calendly umożliwia automatyzowanie zaplanowanych zdarzeń, zwiększanie produktywności i optymalizowanie wydajności za pośrednictwem zautomatyzowanych przepływów pracy.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Obsługa calendly
adres URL https://help.calendly.com/hc/en-us
Email support@calendly.com
Metadane łącznika
Publisher Calendly
Witryna internetowa https://calendly.com
Zasady ochrony prywatności https://calendly.com/privacy
Kategorie Produktywność

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Osobisty token dostępu securestring Osobisty token dostępu dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie typu zdarzenia

Zwraca informacje o określonym typie zdarzenia.

Pobieranie typów zdarzeń

Zwraca wszystkie typy zdarzeń skojarzone z organizacją.

Usuń zaproszenie bez pokazu

Cofa oznaczanie zaproszenia jako bez pokazu

Utwórz zaproszenie bez pokazu

Oznacza zaproszenie jako bez pokazu.

Pobieranie typu zdarzenia

Zwraca informacje o określonym typie zdarzenia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator UUID typu zdarzenia
uuid True string

Identyfikator UUID żądanego typu zdarzenia

Zwraca

Nazwa Ścieżka Typ Opis
zasób
resource EventType

Pobieranie typów zdarzeń

Zwraca wszystkie typy zdarzeń skojarzone z organizacją.

Parametry

Nazwa Klucz Wymagane Typ Opis
Aktywna
active boolean

Zwracaj tylko aktywne typy zdarzeń, jeśli prawda, tylko nieaktywne, jeśli fałsz lub wszystkie typy zdarzeń, jeśli ten parametr zostanie pominięty.

Liczba
count integer

Liczba wierszy do zwrócenia.

Token strony
page_token string

Token do przekazania w celu pobrania następnej lub poprzedniej części kolekcji.

Administrator zarządzany
admin_managed boolean

Zwracaj tylko typy zdarzeń zarządzanych przez administratora, jeśli wartość true, wyklucz typy zdarzeń zarządzanych przez administratora, jeśli są fałszywe, lub dołącz wszystkie typy zdarzeń, jeśli ten parametr zostanie pominięty.

Zwraca

Nazwa Ścieżka Typ Opis
kolekcja
collection array of EventType

kolekcja

Liczba stronicowania
pagination.count integer

Liczba wierszy do zwrócenia.

Identyfikator URI następnej strony
pagination.next_page string

Identyfikator URI zwraca kolejną stronę uporządkowanej listy ("null" wskazuje, że nie są dostępne żadne dodatkowe wyniki).

Identyfikator URI poprzedniej strony
pagination.previous_page string

Identyfikator URI zwraca poprzednią stronę uporządkowanej listy ("null" wskazuje, że nie są dostępne żadne dodatkowe wyniki).

Token następnej strony
pagination.next_page_token string

Token umożliwiający zwrócenie następnej strony uporządkowanej listy ("null" wskazuje, że nie są dostępne żadne dodatkowe wyniki).

Token poprzedniej strony
pagination.previous_page_token string

Token umożliwiający zwrócenie poprzedniej strony uporządkowanej listy ("null" wskazuje, że nie są dostępne żadne dodatkowe wyniki).

Usuń zaproszenie bez pokazu

Cofa oznaczanie zaproszenia jako bez pokazu

Parametry

Nazwa Klucz Wymagane Typ Opis
Zapraszanie bez pokaż identyfikatorA UUID
uuid True string

UUID zaproszenia, którego rekord Nie pokaż jest usuwany

Zwraca

Nie pokazuj pomyślnie usunięte

204
string

Utwórz zaproszenie bez pokazu

Oznacza zaproszenie jako bez pokazu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator URI zaproszenia
invitee True string

Identyfikator URI osoby zapraszanej, która jest oznaczona jako Brak pokaż dla zaplanowanego zdarzenia

Zwraca

Nazwa Ścieżka Typ Opis
Brak pokazywania identyfikatora URI
resource.uri string

Odwołanie kanoniczne (unikatowy identyfikator) dla nie pokazu

Identyfikator URI zaproszenia
resource.invitee string

Odwołanie kanoniczne (unikatowy identyfikator) skojarzonego zaproszenia

Utworzono pod adresem
resource.created_at string

Moment, w którym nie utworzono pokazu

Wyzwalacze

Tworzenie subskrypcji elementu webhook (przesyłanie formularza routingu)

Utwórz subskrypcję elementu webhook dla organizacji, która jest wyzwalana po przesłaniu formularza routingu.

Tworzenie subskrypcji elementu webhook (zaproszenie)

Utwórz subskrypcję elementu webhook dla organizacji, która jest wyzwalana po zaplanowaniu lub anulowaniu zdarzenia.

Tworzenie subskrypcji elementu webhook (przesyłanie formularza routingu)

Utwórz subskrypcję elementu webhook dla organizacji, która jest wyzwalana po przesłaniu formularza routingu.

Parametry

Nazwa Klucz Wymagane Typ Opis
events
events True array of string

events

Zwraca

Nazwa Ścieżka Typ Opis
Element webhook utworzony pod adresem
created_at string

Moment utworzenia elementu webhook (np. "2020-01-02T03:04:05.678123Z").

Identyfikator URI twórcy elementu webhook
created_by string

Odwołanie do użytkownika, który utworzył subskrypcję elementu webhook.

Zdarzenie elementu webhook
event string

Zdarzenie, które spowodowało wyzwolenie elementu webhook.

Identyfikator URI przesyłania formularza routingu
payload.uri string

Odwołanie kanoniczne (unikatowy identyfikator) do przesyłania formularza routingu.

Identyfikator URI formularza routingu
payload.routing_form string

Identyfikator URI formularza routingu skojarzonego z przesyłaniem.

questions_and_answers
payload.questions_and_answers array of object

questions_and_answers

Identyfikator UUID pytania
payload.questions_and_answers.question_uuid string

Unikatowy identyfikator pytania formularza routingu.

Question
payload.questions_and_answers.question string

Nazwa pytania (w formacie czytelnym dla człowieka).

Odpowiedź
payload.questions_and_answers.answer string

Odpowiedź udzielona przez respondenta w momencie złożenia formularza.

Kampania UTM
payload.tracking.utm_campaign string

Parametr UTM używany do śledzenia kampanii.

Źródło UTM
payload.tracking.utm_source string

Parametr UTM, który identyfikuje źródło (platformę, z której pochodzi ruch).

UtM — średni rozmiar
payload.tracking.utm_medium string

Parametr UTM, który identyfikuje typ danych wejściowych (np. Cost Per Click ( CPC), social media, affiliate lub QR code (Kod QR).

Zawartość utM
payload.tracking.utm_content string

Parametr śledzenia zawartości UTM.

Termin UTM
payload.tracking.utm_term string

Parametr UTM używany do śledzenia słowa kluczowego.

Salesforce UUID
payload.tracking.salesforce_uuid string

Unikatowy identyfikator rekordu usługi Salesforce.

Typ wyniku
payload.result.type string

Wskazuje, czy przesyłanie formularza routingu spowodowało niestandardowy komunikat, typ zdarzenia lub zewnętrzny adres URL.

Identyfikator URI przesyłania
payload.submitter string

Odwołanie do zasobu Zaproś podczas przesyłania formularza routingu powoduje zaplanowaną spotkanie.

Typ przesyłania
payload.submitter_type string

Typ zasobu respondenta, który złożył formularz i zaplanowano spotkanie.

Przesyłanie formularza routingu utworzone na stronie
payload.created_at string

Moment przesłania formularza routingu.

Przesyłanie formularza rozsyłania zaktualizowane o
payload.updated_at string

Moment ostatniej aktualizacji formularza routingu.

Tworzenie subskrypcji elementu webhook (zaproszenie)

Utwórz subskrypcję elementu webhook dla organizacji, która jest wyzwalana po zaplanowaniu lub anulowaniu zdarzenia.

Parametry

Nazwa Klucz Wymagane Typ Opis
events
events True array of string

events

Zwraca

Nazwa Ścieżka Typ Opis
Element webhook utworzony pod adresem
created_at string

Moment utworzenia elementu webhook (np. "2020-01-02T03:04:05.678123Z").

Identyfikator URI twórcy elementu webhook
created_by string

Odwołanie do użytkownika, który utworzył subskrypcję elementu webhook.

Zdarzenie elementu webhook
event string

Zdarzenie, które spowodowało wyzwolenie elementu webhook.

Anuluj adres URL zdarzenia
payload.cancel_url string

Link do anulowania wydarzenia dla zaproszenia.

Zaproszenie utworzone na stronie
payload.created_at string

Moment utworzenia zdarzenia (np. "2020-01-02T03:04:05.678123Z").

Wiadomość e-mail z zaproszeniem
payload.email string

Adres e-mail osoby zapraszania.

Identyfikator URI zdarzenia
payload.event string

Odwołanie do zdarzenia.

Nazwa zaproszenia
payload.name string

Imię i nazwisko osoby zapraszania.

Imię zaproszenia
payload.first_name string

Imię osoby zapraszającego, która zarezerwowała zdarzenie, gdy typ zdarzenia jest skonfigurowany do używania oddzielnych pól dla imienia i nazwiska. Wartość null, gdy typ zdarzenia jest skonfigurowany do używania pojedynczego pola dla nazwy.

Nazwisko zaproszenia
payload.last_name string

Nazwisko osoby zapraszającego, która zarezerwowała zdarzenie, gdy typ zdarzenia jest skonfigurowany do używania oddzielnych pól dla imienia i nazwiska. Wartość null, gdy typ zdarzenia jest skonfigurowany do używania pojedynczego pola dla nazwy.

Nowy identyfikator URI zaproszenia
payload.new_invitee string

Połącz z nowym zaproszeniem po ponownym harmonogramie.

Stary identyfikator URI zaproszenia
payload.old_invitee string

Odwołanie do starego wystąpienia zaproszenia, które ma być ponownie ułożone.

Kolekcja odpowiedzi osoby zapraszanej na pytania dotyczące formularza potwierdzenia rezerwacji zdarzeń
payload.questions_and_answers array of object

Kolekcja odpowiedzi osoby zapraszanej na pytania dotyczące formularza potwierdzenia rezerwacji zdarzeń.

Question
payload.questions_and_answers.question string

Pytanie dotyczące formularza rezerwacji osoby zapraszanej.

Odpowiedź
payload.questions_and_answers.answer string

Odpowiedź osoby zapraszania na pytanie.

Stanowisko pytania
payload.questions_and_answers.position number

Stanowisko pytania w odniesieniu do innych osób w formularzu rezerwacji.

Adres URL zdarzenia ponownego mieszania
payload.reschedule_url string

Link do ponownego przygotowania wydarzenia dla zaproszenia.

Zaprosić ponownie?
payload.rescheduled boolean

Przełożony

Stan zaproszenia
payload.status string

stan

Numer przypomnienia tekstowego zaproszenia
payload.text_reminder_number string

text_reminder_number

Strefa czasowa zaproszenia
payload.timezone string

timezone

Kampania UTM
payload.tracking.utm_campaign string

Parametr UTM używany do śledzenia kampanii.

Źródło UTM
payload.tracking.utm_source string

Parametr UTM, który identyfikuje źródło (platformę, z której pochodzi ruch).

UtM — średni rozmiar
payload.tracking.utm_medium string

Parametr UTM, który identyfikuje typ danych wejściowych (np. Cost Per Click ( CPC), social media, affiliate lub QR code (Kod QR).

Zawartość utM
payload.tracking.utm_content string

Parametr śledzenia zawartości UTM.

Termin UTM
payload.tracking.utm_term string

Parametr UTM używany do śledzenia słowa kluczowego.

Salesforce UUID
payload.tracking.salesforce_uuid string

Unikatowy identyfikator rekordu usługi Salesforce.

Identyfikator URI zaproszenia
payload.uri string

Odwołanie kanoniczne (unikatowy identyfikator) dla zaproszenia.

Identyfikator URI przesyłania formularza routingu
payload.routing_form_submission string

Odwołanie do przesłania formularza routingu, które przekierowało zaproszenie do strony rezerwacji.

scheduled_event
payload.scheduled_event ScheduledEvent
unieważnienie
payload.cancellation Cancellation

Dostarcza dane dotyczące anulowania zdarzenia

płatność
payload.payment Payment

Płatność za zaproszenie

no_show
payload.no_show NoShow

Dostarcza dane dotyczące skojarzonego braku pokazu dla zaproszenia.

ponowne potwierdzenie
payload.reconfirmation Reconfirmation

Przy założeniu, że ponowne potwierdzenie jest włączone dla typu zdarzenia, gdy zażądano ponownego potwierdzenia, ten obiekt jest obecny z elementem created_at odzwierciedlanym podczas wysyłania powiadomienia o ponownym potwierdzeniu. Po ponownym potwierdzeniu confirmed_at zaproszenia atrybut zmieni się z null na znacznik czasu, który odzwierciedla, kiedy podjęli akcję.

Definicje

ScheduledEvent

Nazwa Ścieżka Typ Opis
Identyfikator URI zdarzenia
uri uri

Odwołanie kanoniczne (unikatowy identyfikator) dla zasobu.

Nazwa zdarzenia
name string

Nazwa zdarzenia.

Stan zdarzenia
status string

Wskazuje, czy zdarzenie jest "aktywne" lub "anulowane".

Godzina rozpoczęcia zdarzenia
start_time date-time

Moment rozpoczęcia wydarzenia w czasie UTC (np. "2020-01-02T03:04:05.678123Z").

Godzina zakończenia zdarzenia
end_time date-time

Moment zakończenia wydarzenia w czasie UTC (np. "2020-01-02T03:04:05.678123Z")

Identyfikator URI typu zdarzenia
event_type uri

Typ zdarzenia skojarzony z tym zdarzeniem

lokalizacja
location Location

Typ bazy polimorficznej dla lokalizacji zdarzenia obsługiwanej przez calendly

Łączna liczba zaproszeń
invitees_counter.total number

Łączna liczba zaproszeń na wydarzenie, w tym zaproszenia, które anulowały

Łączna liczba aktywnych zaproszeń
invitees_counter.active number

Łączna liczba zaproszeń na wydarzenie, które nie zostało anulowane.

Maksymalna liczba zaproszeń zdarzeń
invitees_counter.limit number

Maksymalna liczba aktywnych zaproszeń, które mogą zarezerwować wydarzenie.

Zdarzenie utworzone pod adresem
created_at date-time

Moment utworzenia zdarzenia (np. "2020-01-02T03:04:05.678123Z")

Zdarzenie zaktualizowane o
updated_at date-time

Moment ostatniej aktualizacji zdarzenia (np. "2020-01-02T03:04:05.678123Z")

event_memberships
event_memberships array of object

Lista członkostwa w zdarzeniach

Identyfikator URI elementu członkowskiego zdarzenia
event_memberships.user uri

Odwołanie kanoniczne (unikatowy identyfikator) dla użytkownika.

Adres e-mail członka zdarzenia
event_memberships.user_email email

Adres e-mail użytkownika.

event_guests
event_guests array of Guest

Dodatkowe osoby dodane do wydarzenia przez zaproszenie

unieważnienie
cancellation Cancellation

Dostarcza dane dotyczące anulowania zdarzenia

Zdarzenie kalendarza
calendar_event LegacyCalendarEvent

Informacje o zdarzeniu kalendarza od dostawcy kalendarza.

Anulowanie

Dostarcza dane dotyczące anulowania zdarzenia

Nazwa Ścieżka Typ Opis
Anulowane przez
canceled_by string

Imię i nazwisko osoby, której anulowano.

Przyczyna anulowania
reason string

Przyczyna, że nastąpiło anulowanie.

Typ elementu anulującego
canceler_type string

Wskazuje, czy zdarzenie zostało anulowane przez "Hosta" lub "Zaproś".

Guest

Osoba zaproszona do udziału w wydarzeniu

Nazwa Ścieżka Typ Opis
Wiadomość e-mail gościa zdarzeń
email email

Wiadomość e-mail gościa zdarzenia.

Gość zdarzenia utworzony na stronie
created_at date-time

Czas utworzenia gościa zdarzenia.

Gość zdarzenia zaktualizowany o
updated_at date-time

Czas ostatniej aktualizacji gościa zdarzenia.

Lokalizacja

Typ bazy polimorficznej dla lokalizacji zdarzenia obsługiwanej przez calendly

Nazwa Ścieżka Typ Opis
Typ lokalizacji
type string

Wskazuje typ lokalizacji zdarzenia.

Stan konferencji internetowej
status string

To pole dotyczy tylko typów lokalizacji zoom_conference, webex_conference, google_conference, gotomeeting i microsoft_teams_conference.

Adres URL spotkania konferencji internetowej
join_url uri

To pole dotyczy tylko typów lokalizacji zoom_conference, webex_conference, google_conference, gotomeeting i microsoft_teams_conference.

Lokalizacja zdarzenia
location string

To pole dotyczy tylko typów lokalizacji outbound_call, inbound_call, fizycznych, ask_invitee i niestandardowych.

LegacyCalendarEvent

Informacje o zdarzeniu kalendarza od dostawcy kalendarza.

Nazwa Ścieżka Typ Opis
Rodzaj zdarzenia calendly
kind string

Wskazuje dostawcę kalendarza, do którego należy zdarzenie.

Identyfikator zdarzenia kalendarza zewnętrznego
external_id string

Identyfikator podany przez dostawcę kalendarza dla tego zdarzenia kalendarza.

Płatność

Płatność za zaproszenie

Nazwa Ścieżka Typ Opis
Identyfikator zewnętrzny płatności
external_id string

Unikatowy identyfikator płatności.

Dostawca płatności
provider string

Dostawca płatności.

Kwota płatności
amount float

Kwota płatności.

Waluta płatności
currency string

Format waluty, w ramach którego znajduje się płatność.

Warunki płatności
terms string

Warunki płatności.

Płatność powiodła się?
successful boolean

Wskazuje, czy płatność została pomyślnie przetworzona.

NoShow

Dostarcza dane dotyczące skojarzonego braku pokazu dla zaproszenia.

Nazwa Ścieżka Typ Opis
Brak pokazywania identyfikatora URI
uri string

Odwołanie kanoniczne (unikatowy identyfikator) dla nie pokazu

Brak utworzonego pokazu na
created_at date-time

Moment, w którym nie utworzono pokazu.

Typ Wydarzenia

Nazwa Ścieżka Typ Opis
Identyfikator URI typu zdarzenia
uri string

Odwołanie kanoniczne (unikatowy identyfikator) dla typu zdarzenia.

Nazwa typu zdarzenia
name string

Nazwa typu zdarzenia (w formacie czytelnym dla człowieka).

Aktywna
active boolean

Wskazuje, czy zdarzenie jest aktywne, czy nie.

Booking, metoda
booking_method string

Wskazuje, czy typ zdarzenia dotyczy ankiety, czy natychmiastowej rezerwacji.

Slug
slug string

Część adresu URL typu zdarzenia, która identyfikuje określoną stronę internetową (w formacie czytelnym dla człowieka).

Adres URL planowania
scheduling_url string

Adres URL witryny planowania użytkownika, w której zaprasza do rezerwacji tego typu zdarzenia.

Czas trwania
duration integer

Długość sesji zarezerwowanych z tym typem zdarzenia.

Rodzaj
kind string

Wskazuje, czy typ zdarzenia to "solo" (należy do pojedynczego użytkownika) lub "grupa".

Typ buforowania
pooling_type string

Wskazuje, czy typ zdarzenia to "działanie okrężne" (alternatywne między hostami) lub "zbiorcze" (zaproszenia wybierają czas, gdy wszyscy uczestnicy są dostępni) lub "null" (typ zdarzenia nie uwzględnia dostępności uczestników grupy).

Typ
type string

Wskazuje, czy typ zdarzenia to "AdhocEventType" (zdarzenie ad hoc) lub "StandardEventType" (standardowy typ zdarzenia).

Kolor
color string

Wartość koloru szesnastkowego strony planowania typu zdarzenia.

Utworzono pod adresem
created_at string

Moment utworzenia typu zdarzenia (np. "2020-01-02T03:04:05.678123Z").

Zaktualizowano o
updated_at string

Czas ostatniej aktualizacji typu zdarzenia (np. "2020-01-02T03:04:05.678123Z").

Notatka wewnętrzna
internal_note string

Zawartość notatki, która może być skojarzona z typem zdarzenia.

Opis (zwykły)
description_plain string

Opis typu zdarzenia (w nieformatowanym tekście).

Opis (HTML)
description_html string

Opis typu zdarzenia (sformatowany przy użyciu kodu HTML).

Typ profilu
profile.type string

Wskazuje, czy profil należy do "użytkownika" (indywidualnego) lub "zespołu".

Nazwa profilu
profile.name string

Czytelna dla człowieka nazwa profilu użytkownika skojarzonego z typem zdarzenia.

Identyfikator URI właściciela profilu
profile.owner string

Unikatowe odwołanie do użytkownika skojarzonego z profilem.

Secret
secret boolean

Wskazuje, czy typ zdarzenia jest ukryty na głównej stronie planowania właściciela.

Usunięto o
deleted_at string

Moment usunięcia typu zdarzenia (np. "2020-01-02T03:04:05.678123Z").

Administrator zarządzany
admin_managed boolean

Wskazuje, czy ten typ zdarzenia jest zarządzany przez administratora organizacji.

custom_questions
custom_questions array of object

custom_questions

Niestandardowa nazwa pytania
custom_questions.name string

nazwa

Niestandardowy typ pytania
custom_questions.type string

typ

Niestandardowe położenie pytania
custom_questions.position integer

pozycja

Pytanie niestandardowe włączone
custom_questions.enabled boolean

enabled

Wymagane pytanie niestandardowe
custom_questions.required boolean

required

Niestandardowe opcje odpowiedzi na pytania
custom_questions.answer_choices array of string

answer_choices

Uwzględnij inne
custom_questions.include_other boolean

include_other

Ponowne potwierdzenie

Przy założeniu, że ponowne potwierdzenie jest włączone dla typu zdarzenia, gdy zażądano ponownego potwierdzenia, ten obiekt jest obecny z elementem created_at odzwierciedlanym podczas wysyłania powiadomienia o ponownym potwierdzeniu. Po ponownym potwierdzeniu confirmed_at zaproszenia atrybut zmieni się z null na znacznik czasu, który odzwierciedla, kiedy podjęli akcję.

Nazwa Ścieżka Typ Opis
Ponowne potwierdzenie utworzone na stronie
created_at date-time

Po utworzeniu ponownego potwierdzenia.

Zaproszenie potwierdzone o
confirmed_at date-time

Kiedy zaproszenie potwierdziło swoją obecność.