Zoom (webinar ve toplantı)

Bu rehberde: Zoom hesabınızı bağlarsınız. İş akışları müşteri adaylarını webinarlarınıza kaydeder; yeni bir webinar kaydı geldiğinde veya bir toplantı bittiğinde otomatik akış başlar (ör. adayı CRM'e yaz, takip e-postası gönder).

⏱ 5 dakika (platformun Zoom uygulaması kayıtlıysa)

Kimlik kartı#

Ne işe yarar?#

Örnek akışlar:

• Formdan webinara: Form gönderimi → Müşteri adayı oluştur → Zoom: Webinara kaydet → E-posta gönder ("Kaydınız alındı").
• Kayıttan CRM'e: Entegrasyon olayı (Zoom · Yeni webinar kaydı) → Müşteri adayı oluştur (etiket webinar) → CRM'e yaz.
• Toplantı sonrası takip: Entegrasyon olayı (Zoom · Toplantı bitti) → Salesforce: Görev oluştur veya takip e-postası taslağı.

Aynı kayıt Zoom tarafından iki kez gönderilse bile akış bir kez başlar (yinelenen teslimler 7 gün ayıklanır).

Ön koşullar#

• Bir Zoom hesabı. Webinar işlemleri ve tetikleyicisi için bağlanan kullanıcıda Zoom Webinars lisansı (eklenti) olmalı.
• Webinarda Kayıt (Registration) gerekli seçeneği açık olmalı; kayıtsız webinarlara kişi eklenemez.
• Bağlanan kullanıcı webinarın sahibi (host) veya hesapta webinarı yönetebilen bir yönetici olmalı.

Adım adım kurulum#

A) OrqLabs'ta bağlama#

1. Entegrasyonlar → Zoom → Bağla → Proje seçin.
2. Bağla → Zoom'da oturum açın → uygulamaya izin verin.
3. Kart Zoom – siz@markaniz.com adıyla görünür. Bağlantıyı test et ile hesabı doğrulayın.
4. İş akışına Zoom kutusunu ekleyin, işlem olarak Webinara kaydet'i seçin, Webinar ID alanına webinar numarasını (boşluksuz, ör. 84512345678) yazın.
5. Tetikleyici için Entegrasyon olayı kutusunu ekleyin → hesap: Zoom bağlantınız → olay: Yeni webinar kaydı veya Toplantı bitti → iş akışını Etkin yapın.

Webhook adresi girmeniz gerekmez: Zoom olayları platformun Zoom uygulamasına gelir ve Zoom hesap kimliğinize göre sizin bağlantınıza yönlendirilir.

B) Platform yöneticisi: Zoom Marketplace uygulaması#

Bu adımlar OrqLabs'ı işleten taraf tarafından bir kez yapılır.

1. marketplace.zoom.us → Develop → Build App → General App → yönetim türü User-managed.
2. Basic Information → OAuth Information: Redirect URL for OAuth = https://api.orqlabs.com/api/v1/integrations/oauth/zoom/callback; aynı adresi OAuth Allow List'e ekleyin.
3. Client ID → ZOOM_CLIENT_ID, Client Secret → ZOOM_CLIENT_SECRET.
4. Scopes → Add Scopes: user:read:user, webinar:read:list_webinars, webinar:write:registrant, webinar:read:registrant, meeting:read:meeting.
5. Features → Access: Secret Token değerini kopyalayın → ZOOM_WEBHOOK_SECRET. API sunucusunu bu değişkenle yeniden başlatın (doğrulama isteği bu anahtarla yanıtlanır).
6. Aynı sayfada Event Subscription'ı açın → Add New Event Subscription → Event notification endpoint URL = https://api.orqlabs.com/api/v1/apps/zoom/webhook → Validate (OrqLabs endpoint.url_validation isteğini yanıtlar, yeşil onay görünür).
7. Add Events: Webinar → Registration has been created (webinar.registration_created) ve Meeting → End Meeting (meeting.ended) → Save. Zoom bir olay için ek kapsam isterse 4. adımdaki listeye ekleyin.
8. Diğer Zoom hesaplarının bağlanabilmesi için uygulamayı Publish (gerekirse listelenmemiş / unlisted) olarak incelemeye gönderin; onaylanana kadar yalnızca uygulamanın geliştirildiği Zoom hesabındaki kullanıcılar bağlanabilir.

Güvenlik#

• Her olay x-zm-signature başlığıyla imzalıdır (v0:{zaman damgası}:{gövde} üzerinde HMAC-SHA256, anahtar = Secret Token). İmzası tutmayan veya 5 dakikadan eski istekler reddedilir.
• Olaylar yalnızca payload.account_id değeri bağlantınızın Zoom hesap kimliğiyle eşleşen ve Bağlı durumdaki entegrasyonlara iletilir. Ayrıca webinarın / toplantının sahibi (host_id) bağlayan kullanıcı olmalıdır: aynı Zoom hesabındaki bir iş arkadaşınızın webinar kayıtları sizin akışınızı başlatmaz. Her sunucu kendi Zoom kullanıcısıyla ayrı bağlanır.

İzinler ve kapsamlar#

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

Sonraki adım#

• Tetikleyiciler, CRM'e aktarma
• Salesforce, Zoho CRM