Aracılığıyla paylaş


Calendly (Önizleme)

Calendly'nin bağlayıcısı, zamanlanmış olayları otomatikleştirmenize, üretkenliği artırmanıza ve otomatik iş akışları aracılığıyla verimliliği iyileştirmenize yardımcı olur.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Kamu bölgeleri
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Premium Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
Power Automate Premium Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - ABD Kamu (GCC)
     - US Government (GCC High)
     - 21Vianet tarafından işletilen Çin Bulutu
     - ABD Savunma Bakanlığı (DoD)
İletişim
İsim Calendly Desteği
URL https://help.calendly.com/hc/en-us
E-posta support@calendly.com
Bağlayıcı Meta Verileri
Publisher Son olarak
Web sitesi https://calendly.com
Gizlilik ilkesi https://calendly.com/privacy
Kategoriler Verimli -lik

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan Bağlantı oluşturmak için parametreler. Tüm bölgeler Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim Türü Description Gerekli
Kişisel Erişim Belirteci securestring Bu API için Kişisel Erişim Belirteci Doğru

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

DavetliYi Sil Gösteri Yok

Davetliyi Gösteri Yok olarak işaretlemeyi geri alır

Gösteri Yok Davetlisi Oluştur

Davetliyi Gösteri Yok olarak işaretler.

Olay Türlerini Alma

Kuruluşunuzla ilişkili tüm Olay Türlerini döndürür.

Olay Türünü Al

Belirtilen Olay Türü hakkındaki bilgileri döndürür.

DavetliYi Sil Gösteri Yok

Davetliyi Gösteri Yok olarak işaretlemeyi geri alır

Parametreler

Name Anahtar Gerekli Tür Description
Davetli Gösteri Yok UUID
uuid True string

Gösteri Yok kaydı kaldırılan davetlinin UUID değeri

Döndürülenler

Gösteri başarıyla silinmedi

204
string

Gösteri Yok Davetlisi Oluştur

Davetliyi Gösteri Yok olarak işaretler.

Parametreler

Name Anahtar Gerekli Tür Description
Davetli URI'sı
invitee True string

Zamanlanmış bir etkinlik için Gösteri Yok olarak işaretlenen davetlinin URI'sini

Döndürülenler

Name Yol Tür Description
Gösteri URI'sı Yok
resource.uri string

Gösteri yok için kurallı başvuru (benzersiz tanımlayıcı)

Davetli URI'sı
resource.invitee string

İlişkili Davetli için kurallı başvuru (benzersiz tanımlayıcı)

Oluşturma Tarihi
resource.created_at string

Gösterinin oluşturulmama anı

Olay Türlerini Alma

Kuruluşunuzla ilişkili tüm Olay Türlerini döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Aktif
active boolean

Yalnızca true olduğunda etkin olay türlerini, yalnızca false olduğunda etkin olmayanları veya bu parametre atlanırsa tüm olay türlerini döndürür.

Sayı
count integer

Döndürülecek satır sayısı.

Sayfa Belirteci
page_token string

Koleksiyonun sonraki veya önceki bölümünü almak için geçirilir belirteç.

Yönetici Tarafından Yönetilen
admin_managed boolean

Yalnızca doğruysa yönetici tarafından yönetilen olay türlerini döndür, yanlışsa yönetici tarafından yönetilen olay türlerini hariç tut veya bu parametre atlanırsa tüm olay türlerini dahil et.

Döndürülenler

Name Yol Tür Description
koleksiyonu
collection array of EventType

koleksiyonu

Sayfalandırma Sayısı
pagination.count integer

Döndürülecek satır sayısı.

Sonraki Sayfa URI'si
pagination.next_page string

Sıralı listenin sonraki sayfasını döndürmek için URI ("null" ek sonuç olmadığını gösterir).

Önceki Sayfa URI'si
pagination.previous_page string

Sıralı listenin önceki sayfasını döndürmek için URI ("null" ek sonuç olmadığını gösterir).

Sonraki Sayfa Belirteci
pagination.next_page_token string

Sıralı listenin sonraki sayfasını döndürmek için belirteç ("null" ek sonuç olmadığını gösterir).

Önceki Sayfa Belirteci
pagination.previous_page_token string

Sıralı listenin önceki sayfasını döndürmek için belirteç ("null" ek sonuç olmadığını gösterir).

Olay Türünü Al

Belirtilen Olay Türü hakkındaki bilgileri döndürür.

Parametreler

Name Anahtar Gerekli Tür Description
Olay Türü UUID
uuid True string

İstenen Olay Türünün UUID değeri

Döndürülenler

Name Yol Tür Description
resource
resource EventType

Tetikleyiciler

Web Kancası Aboneliği Oluşturma (Davetli)

Bir olay zamanlandığında veya iptal edildiğinde tetiklenen bir Kuruluş için Web Kancası Aboneliği oluşturun.

Web Kancası Aboneliği Oluşturma (Yönlendirme Formu Gönderimi)

Yönlendirme formu gönderildiğinde tetiklenen bir Kuruluş için Web Kancası Aboneliği oluşturun.

Web Kancası Aboneliği Oluşturma (Davetli)

Bir olay zamanlandığında veya iptal edildiğinde tetiklenen bir Kuruluş için Web Kancası Aboneliği oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
events
events True array of string

events

Döndürülenler

Name Yol Tür Description
Web Kancası Oluşturma Tarihi
created_at string

Web kancasının oluşturulduğu an (örneğin, "2020-01-02T03:04:05.678123Z").

Web Kancası Oluşturucu URI'si
created_by string

Web kancası aboneliğini oluşturan kullanıcıya başvuru.

Web Kancası Olayı
event string

Web kancasının yanmasına neden olan olay.

Olay URL'sini İptal Et
payload.cancel_url string

Davetli için etkinliği iptal etme bağlantısı.

Davetli Oluşturma Tarihi
payload.created_at string

Olayın oluşturulduğu an (örn. "2020-01-02T03:04:05.678123Z").

Davetli E-postası
payload.email string

Davetlinin e-posta adresi.

Olay URI'si
payload.event string

Olaya bir başvuru.

Davetli Adı
payload.name string

Davetlinin adı.

Davetli Adı
payload.first_name string

Olay türü ad ve soyadı için ayrı alanlar kullanacak şekilde yapılandırıldığında olayı rezerve eden davetlinin adı. Olay türü ad için tek bir alan kullanacak şekilde yapılandırıldığında null.

Davetli Soyadı
payload.last_name string

Olay türü ad ve soyadı için ayrı alanlar kullanacak şekilde yapılandırıldığında olayı rezerve eden davetlinin soyadı. Olay türü ad için tek bir alan kullanacak şekilde yapılandırıldığında null.

Yeni Davetli URI'sı
payload.new_invitee string

Yeniden zamanladıktan sonra yeni davetliye bağlan.

Eski Davetli URI'sı
payload.old_invitee string

Yeniden zamanlanan eski Davetli örneğine başvuru.

Davetlinin etkinlik rezervasyonu onay formundaki sorulara verdiği yanıtların bir koleksiyonu
payload.questions_and_answers array of object

Davetlinin etkinlik rezervasyonu onay formundaki sorulara verdiği yanıtların bir koleksiyonu.

Question
payload.questions_and_answers.question string

Davetlinin rezervasyon formunda bir soru.

Cevap
payload.questions_and_answers.answer string

Davetlinin soruya cevabı.

Soru Konumu
payload.questions_and_answers.position number

Sorunun rezervasyon formundaki diğer kişilerle ilgili konumu.

Olay URL'sini Yeniden Zamanla
payload.reschedule_url string

Davetli için olayı yeniden zamanlama bağlantısı.

Davetli Yeniden Zamanlandı mı?
payload.rescheduled boolean

yeniden zamanlandı

Davetli Durumu
payload.status string

statü

Davetli Metin Anımsatıcı Numarası
payload.text_reminder_number string

text_reminder_number

Davetli Saat Dilimi
payload.timezone string

timezone

UTM Kampanyası
payload.tracking.utm_campaign string

Kampanyayı izlemek için kullanılan UTM parametresi.

UTM Kaynağı
payload.tracking.utm_source string

Kaynağı tanımlayan UTM parametresi (trafiğin kaynaklandığı platform).

UTM Orta
payload.tracking.utm_medium string

Giriş türünü tanımlayan UTM parametresi (örn. Tıklama Başına Maliyet (TBM), sosyal medya, bağlı kuruluş veya QR kodu).

UTM İçeriği
payload.tracking.utm_content string

UTM içerik izleme parametresi.

UTM Terimi
payload.tracking.utm_term string

Anahtar sözcüğü izlemek için kullanılan UTM parametresi.

Salesforce UUID
payload.tracking.salesforce_uuid string

Salesforce kaydı benzersiz tanımlayıcısı.

Davetli URI'sı
payload.uri string

Davetli için kurallı başvuru (benzersiz tanımlayıcı).

Yönlendirme Formu Gönderimi URI'si
payload.routing_form_submission string

Davetliyi bir rezervasyon sayfasına yönlendiren yönlendirme formu gönderimine başvuru.

scheduled_event
payload.scheduled_event ScheduledEvent
Iptal
payload.cancellation Cancellation

Olayın iptaline ilişkin verileri sağlar

Ödeme
payload.payment Payment

Davetli ödemesi

no_show
payload.no_show NoShow

Davetli için ilişkili gösteri yok ile ilgili veriler sağlar.

yeniden doğrulama
payload.reconfirmation Reconfirmation

Olay türü için yeniden doğrulamanın etkinleştirildiği varsayıldığında, yeniden doğrulama istendiğinde bu nesne, yeniden doğrulama bildiriminin ne zaman gönderildiğini yansıtan bir created_at ile birlikte bulunur. Davetli yeniden onayladıktan sonra özniteliği, confirmed_at eylemde bulundukları zamanı yansıtan bir zaman damgasına dönüşür null .

Web Kancası Aboneliği Oluşturma (Yönlendirme Formu Gönderimi)

Yönlendirme formu gönderildiğinde tetiklenen bir Kuruluş için Web Kancası Aboneliği oluşturun.

Parametreler

Name Anahtar Gerekli Tür Description
events
events True array of string

events

Döndürülenler

Name Yol Tür Description
Web Kancası Oluşturma Tarihi
created_at string

Web kancasının oluşturulduğu an (örneğin, "2020-01-02T03:04:05.678123Z").

Web Kancası Oluşturucu URI'si
created_by string

Web kancası aboneliğini oluşturan kullanıcıya başvuru.

Web Kancası Olayı
event string

Web kancasının yanmasına neden olan olay.

Yönlendirme Formu Gönderimi URI'si
payload.uri string

Yönlendirme formu gönderimi için kurallı başvuru (benzersiz tanımlayıcı).

Yönlendirme Formu URI'si
payload.routing_form string

Gönderimle ilişkili yönlendirme formunun URI'sini.

questions_and_answers
payload.questions_and_answers array of object

questions_and_answers

Soru UUID
payload.questions_and_answers.question_uuid string

Yönlendirme formu sorusunun benzersiz tanımlayıcısı.

Question
payload.questions_and_answers.question string

Soru adı (insan tarafından okunabilir biçimde).

Cevap
payload.questions_and_answers.answer string

Yanıt, form gönderildiğinde yanıtlayan tarafından sağlanır.

UTM Kampanyası
payload.tracking.utm_campaign string

Kampanyayı izlemek için kullanılan UTM parametresi.

UTM Kaynağı
payload.tracking.utm_source string

Kaynağı tanımlayan UTM parametresi (trafiğin kaynaklandığı platform).

UTM Orta
payload.tracking.utm_medium string

Giriş türünü tanımlayan UTM parametresi (örn. Tıklama Başına Maliyet (TBM), sosyal medya, bağlı kuruluş veya QR kodu).

UTM İçeriği
payload.tracking.utm_content string

UTM içerik izleme parametresi.

UTM Terimi
payload.tracking.utm_term string

Anahtar sözcüğü izlemek için kullanılan UTM parametresi.

Salesforce UUID
payload.tracking.salesforce_uuid string

Salesforce kaydı benzersiz tanımlayıcısı.

Sonuç Türü
payload.result.type string

Yönlendirme formu gönderiminin özel bir iletiye, olay türüne veya dış URL'ye neden olup olmadığını gösterir.

Gönderici URI'si
payload.submitter string

Yönlendirme formu gönderimi zamanlanmış bir toplantıyla sonuçlanırken Davetli kaynağına başvuru.

Gönderici Türü
payload.submitter_type string

Formu gönderen ve toplantı zamanlayan yanıtlayan kaynağın türü.

Yönlendirme Formu Gönderimi Oluşturma:
payload.created_at string

Yönlendirme formunun gönderildiği an.

Yönlendirme Formu Gönderimi Şu Konumda Güncelleştirildi:
payload.updated_at string

Yönlendirme formu gönderiminin son güncelleştirildiği an.

Tanımlar

ScheduledEvent

Name Yol Tür Description
Olay URI'si
uri uri

Kaynak için kurallı başvuru (benzersiz tanımlayıcı).

Olay Adı
name string

Olay adı.

Olay Durumu
status string

Olayın "etkin" mi yoksa "iptal edildi mi" olduğunu gösterir.

Olay Başlangıç Saati
start_time date-time

Olayın UTC saatiyle başlamasının zamanlandığı an (örn. "2020-01-02T03:04:05.678123Z").

Olay Bitiş Saati
end_time date-time

Olayın UTC saatiyle bitmek üzere zamanlandığı an (örneğin, "2020-01-02T03:04:05.678123Z")

Olay Türü URI'si
event_type uri

Bu olayla ilişkili olay türü

location
location Location

Calendly tarafından desteklenen bir olay konumu için çok biçimli taban türü

Toplam Davetli Sayısı
invitees_counter.total number

İptal edilen davetliler de dahil olmak üzere bir etkinlik için toplam davetli sayısı

Toplam Etkin Davetli Sayısı
invitees_counter.active number

İptal edilmeyen bir etkinliğin toplam davetli sayısı.

Etkinlik En Fazla Davetli Sayısı
invitees_counter.limit number

Etkinlik için rezervasyon yapabilecek etkin davetli sayısı üst sınırı.

Olay Oluşturma Tarihi:
created_at date-time

Olayın oluşturulduğu an (örn. "2020-01-02T03:04:05.678123Z")

Olay Güncelleştirme Tarihi:
updated_at date-time

Olayın son güncelleştirme zamanı (örneğin, "2020-01-02T03:04:05.678123Z")

event_memberships
event_memberships array of object

Olay üyelik listesi

Olay Üyesi URI'si
event_memberships.user uri

Kullanıcı için kurallı başvuru (benzersiz tanımlayıcı).

Olay Üyesi E-postası
event_memberships.user_email email

Kullanıcının e-posta adresi.

event_guests
event_guests array of Guest

Davetli tarafından bir etkinliğe eklenen ek kişiler

Iptal
cancellation Cancellation

Olayın iptaline ilişkin verileri sağlar

Takvim Etkinliği
calendar_event LegacyCalendarEvent

Takvim sağlayıcısından takvim olayıyla ilgili bilgiler.

İptal

Olayın iptaline ilişkin verileri sağlar

Name Yol Tür Description
İptal Eden
canceled_by string

İptal eden kişinin adı.

İptal Nedeni
reason string

İptal işleminin gerçekleşme nedeni.

İptal Eden Türü
canceler_type string

Olayın "Konak" veya "Davetli" tarafından iptal edilip edilmediğini gösterir.

Guest

Davetlinin bir etkinliğe konuk katılımcı olarak davet ettiği bir kişi

Name Yol Tür Description
Olay Konuk E-postası
email email

Olay konuğunun e-postası.

Olay Konuğu Oluşturma Tarihi:
created_at date-time

Olay konuğunun oluşturulduğu saat.

Olay Konuğu güncelleştirildi:
updated_at date-time

Olay konuğunun en son güncelleştirilmiş olduğu saat.

Yer

Calendly tarafından desteklenen bir olay konumu için çok biçimli taban türü

Name Yol Tür Description
Konum Türü
type string

Olay konumu türünü gösterir.

Web Konferansı Durumu
status string

Bu alan yalnızca zoom_conference, webex_conference, google_conference, gotomeeting ve microsoft_teams_conference konum türleri için geçerlidir.

Web Konferansı Toplantısı URL'si
join_url uri

Bu alan yalnızca zoom_conference, webex_conference, google_conference, gotomeeting ve microsoft_teams_conference konum türleri için geçerlidir.

Olay Konumu
location string

Bu alan yalnızca outbound_call, inbound_call, fiziksel, ask_invitee ve özel konum türleri için geçerlidir.

LegacyCalendarEvent

Takvim sağlayıcısından takvim olayıyla ilgili bilgiler.

Name Yol Tür Description
Calendly Olay Türü
kind string

Olayın ait olduğu takvim sağlayıcısını gösterir.

Dış Takvim Olay Kimliği
external_id string

Bu takvim olayı için takvim sağlayıcısından sağlanan kimlik.

Ödeme

Davetli ödemesi

Name Yol Tür Description
Ödeme Dış Kimliği
external_id string

Ödeme için benzersiz tanımlayıcı.

Ödeme Sağlayıcısı
provider string

Ödeme sağlayıcısı.

Ödeme Tutarı
amount float

Ödeme tutarı.

Ödeme Para Birimi
currency string

Ödemenin içinde olduğu para birimi biçimi.

Ödeme Koşulları
terms string

Ödeme koşulları.

Ödeme Başarılı Mı?
successful boolean

Ödemenin başarıyla işlenip işlenmediğini gösterir.

NoShow

Davetli için ilişkili gösteri yok ile ilgili veriler sağlar.

Name Yol Tür Description
Gösteri URI'sı Yok
uri string

Gösteri yok için kurallı başvuru (benzersiz tanımlayıcı)

Gösteri Oluşturulmamış
created_at date-time

Gösterinin oluşturulmama anı.

EtkinlikTürü

Name Yol Tür Description
Olay Türü URI'si
uri string

Olay türü için kurallı başvuru (benzersiz tanımlayıcı).

Olay Türü Adı
name string

Olay türü adı (insan tarafından okunabilir biçimde).

Aktif
active boolean

Olayın etkin olup olmadığını gösterir.

Rezervasyon Yöntemi
booking_method string

Olay türünün bir yoklama veya anlık kayıt için olup olmadığını gösterir.

Başlık
slug string

Olay türünün URL'sinin belirli bir web sayfasını tanımlayan bölümü (okunabilir bir biçimde).

Zamanlama URL'si
scheduling_url string

Davetlilerin bu olay türünü rezerve ettiği kullanıcının zamanlama sitesinin URL'si.

Süre
duration integer

Bu olay türüyle ayrılmış oturumların uzunluğu.

Kind
kind string

Olay türünün "solo" (tek bir kullanıcıya ait) veya "group" olup olmadığını gösterir.

Havuz Türü
pooling_type string

Olay türünün "hepsini bir kez deneme" (konaklar arasında alternatifler) veya "kolektif" (davetliler tüm katılımcıların uygun olduğu zamanı seçer) veya "null" (olay türü grup katılımcılarının kullanılabilirliğini dikkate almaz) olup olmadığını gösterir.

Türü
type string

Olay türünün "AdhocEventType" (geçici olay) veya "StandardEventType" (standart olay türü) olup olmadığını gösterir.

Renk
color string

Olay türünün zamanlama sayfasının onaltılık renk değeri.

Oluşturma Tarihi
created_at string

Olay türünün oluşturulduğu an (örn. "2020-01-02T03:04:05.678123Z").

Güncelleştirme Tarihi:
updated_at string

Olay türünün son güncelleştirildiği an (örneğin, "2020-01-02T03:04:05.678123Z").

İç Not
internal_note string

Olay türüyle ilişkilendirilebilen bir notun içeriği.

Açıklama (Düz)
description_plain string

Olay türünün açıklaması (biçimlendirilmemiş metinde).

Açıklama (HTML)
description_html string

Olay türünün açıklaması (HTML ile biçimlendirilmiş).

Profil Türü
profile.type string

Profilin bir "kullanıcı" (bireysel) veya "takıma" ait olup olmadığını gösterir.

Profil Adı
profile.name string

Olay türüyle ilişkili kullanıcının profili için okunabilir ad.

Profil Sahibi URI'si
profile.owner string

Profille ilişkilendirilmiş kullanıcıya yapılan benzersiz başvuru.

Gizli
secret boolean

Olay türünün sahibin ana zamanlama sayfasında gizlenip gizlenmediğini gösterir.

Silindiği Yer
deleted_at string

Olay türünün silindiği an (örn. "2020-01-02T03:04:05.678123Z").

Yönetici Tarafından Yönetilen
admin_managed boolean

Bu olay türünün bir kuruluş yöneticisi tarafından yönetilip yönetilmediğini gösterir.

custom_questions
custom_questions array of object

custom_questions

Özel Soru Adı
custom_questions.name string

name

Özel Soru Türü
custom_questions.type string

type

Özel Soru Konumu
custom_questions.position integer

konum

Özel Soru Etkin
custom_questions.enabled boolean

enabled

Özel Soru Gerekli
custom_questions.required boolean

required

Özel Soru Yanıtı Seçenekleri
custom_questions.answer_choices array of string

answer_choices

Diğer ekle
custom_questions.include_other boolean

include_other

Yeniden doğrulama

Olay türü için yeniden doğrulamanın etkinleştirildiği varsayıldığında, yeniden doğrulama istendiğinde bu nesne, yeniden doğrulama bildiriminin ne zaman gönderildiğini yansıtan bir created_at ile birlikte bulunur. Davetli yeniden onayladıktan sonra özniteliği, confirmed_at eylemde bulundukları zamanı yansıtan bir zaman damgasına dönüşür null .

Name Yol Tür Description
Reconfirmation Created At
created_at date-time

Yeniden doğrulama oluşturulduğunda.

Davetli Onaylandı:
confirmed_at date-time

Davetli katılımlarını onayladığında.