Calendly

Bu rehberde: Calendly hesabınızı bir kişisel erişim anahtarıyla (personal access token) bağlarsınız. Biri sizinle toplantı ayarladığında veya iptal ettiğinde iş akışınız başlar. Calendly kutusu, sohbet botunun ya da e-postanın müşteriye gönderebileceği tek kullanımlık randevu bağlantısı üretir.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyiciler:

• New booking (invitee.created) – biri randevu aldığında. Yeniden planlanan bir toplantının yeni saati de bu olayla gelir (rescheduled, oldInvitee).
• Booking canceled (invitee.canceled) – davetli veya siz iptal ettiğinizde. Yeniden planlamada eski saat bu olayla, rescheduled: true olarak gelir.

İlk öğenin alanları:

Calendly kutusunun işlemleri:

Editördeki test çalıştırmalarında bağlantı üretme çalıştırılmaz; okuma işlemi çalışır.

Ön koşullar#

• Webhook'lar (tetikleyiciler) için Standard, Teams veya Enterprise Calendly planı. Ücretsiz planda bağlantı kurulur ve kutu çalışır, ancak tetikleyiciler kurulamaz.
• Toplantı türleri tanımlı bir Calendly kullanıcısı.

Adım adım kurulum#

A) Calendly'de kişisel erişim anahtarı#

1. Calendly → Integrations & apps → API and webhooks.
2. Personal access tokens → Generate new token → ad: OrqLabs.
3. İzin seçimi istenirse şunları işaretleyin: users:read, event_types:read, scheduling_links:write, scheduled_events:read, webhooks:read, webhooks:write.
4. Anahtarı kopyalayın; yalnızca bir kez gösterilir.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Calendly → Bağla → Proje seçin.
2. Personal access token alanına anahtarı yapıştırın → Bağla.

OrqLabs kullanıcınızı okur ve kullanıcı kapsamında (yalnızca sizin toplantılarınız) bir webhook aboneliği oluşturur. Her teslimat OrqLabs'ın ürettiği imza anahtarıyla imzalanır; imzası tutmayan veya 24 saatten eski istekler reddedilir. Planınız webhook'a izin vermiyorsa entegrasyon kartında "webhooks need a paid Calendly plan" hatası görünür; planı yükselttikten sonra ayrıntı panelinde Şimdi senkronize et'e basın.

C) Tetikleyiciyi kurma#

Entegrasyon olayı → Account: Calendly bağlantınız → Event: CALENDLY · New booking veya CALENDLY · Booking canceled. Tek bir toplantı türü için Payload filter: {{ $json.eventName === "30 Minute Discovery Call" }}.

Örnek iş akışları#

1) Sohbet botu randevu bağlantısı gönderir#

1. Mesaj geldi (WhatsApp / Instagram).
2. Sınıfla – niyet randevu mu?
3. Calendly → Create single-use booking link – Event type 30min.
4. Mesaj gönder – Size özel randevu bağlantınız: {{ $json.bookingUrl }}.

2) Yeni randevu → aday + hazırlık notu#

Entegrasyon olayı (CALENDLY · New booking) → Aday oluştur (e-posta {{ $json.email }}, ad {{ $json.name }}, telefon {{ $json.phone }}) → Metin üret ({{ $json.answers }} cevaplarına göre görüşme hazırlık notu) → Ekibe bildir ({{ $json.name }} – {{ $json.startTime }}).

3) İptalde geri kazanım e-postası#

Entegrasyon olayı (CALENDLY · Booking canceled) → Eğer ({{ $json.cancelerType === "invitee" && !$json.rescheduled }}) → E-posta gönder (Yeni bir zaman seçmek ister misiniz? + randevu sayfanız).

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et adınızı, e-postanızı ve randevu sayfanızı gösterir.

Kimlik bilgilerini yenileme#

Calendly'de yeni anahtar üretin → OrqLabs'ta Kimlik bilgileri → Güncelle → Kaydet → eski anahtarı Calendly'de silin. Webhook aboneliği anahtardan bağımsızdır. Bağlantıyı OrqLabs'ta silerseniz abonelik de silinir.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Toplantıyı yeniden planlamak iki olay mı üretir? Evet: eski saat için Booking canceled (rescheduled: true), yeni saat için New booking (oldInvitee dolu). Geri kazanım akışlarında rescheduled alanını kontrol edin.

Ekip (Teams) hesabımdaki herkesin randevuları gelir mi? Hayır; abonelik anahtarı oluşturan kullanıcının toplantılarını kapsar. Her ekip üyesi kendi anahtarıyla ayrı bir bağlantı ekleyebilir.

Sonraki adım#

• Cal.com
• Entegrasyonlara genel bakış