İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Zoom

Toplantıları yönetmek, kayıtlara erişmek ve görüşmelerinizden transkript almak için Zoom'u ajan'a bağlayın

Genel Bakış

Zoom, toplantılar, webinarlar ve iş birliği için bir video konferans platformudur. Bağlandıktan sonra ajan ile toplantı planlayabilir, kayıtlara erişebilir ve transkriptleri doğrudan görüşmelerinizden alabilirsiniz.

Kimlik Doğrulama: OAuth Kategori: Productivity & Collaboration Kullanılabilirlik: Tüm çalışma alanı planları

Önkoşullar

Entegrasyonu kurmadan önce şunlara sahip olduğunuzdan emin olun:

  • Üçüncü taraf OAuth uygulamalarını yetkilendirme iznine sahip bir Zoom hesabı
  • Kayıtlara ve transkriptlere erişmek istiyorsanız Zoom hesabınızda cloud recording etkin
  • Toplantı özetlerini kullanmak istiyorsanız Zoom AI Companion etkin

Kurulum

Entegrasyonlara gidin

ajan'da Integrations sayfasına gidin ve listede Zoom'u bulun.

OAuth ile bağlanın

OAuth akışını başlatmak için Connect düğmesine tıklayın. ajan'ı yetkilendirmek için Zoom'a yönlendirilirsiniz.

Erişimi yetkilendirin

İstenirse Zoom hesabınıza oturum açın, ardından ajan'a erişim vermek için istenen izinleri onaylayın.

ajan'da Zoom kullanmaya başlayın

Yetkilendirmeden sonra ajan'a geri yönlendirilirsiniz. Toplantılarınızı ve kayıtlarınızı yönetmeye başlamak için herhangi bir temsilcide entegrasyonu @ ile etiketleyin.

Ayrılmış Dağıtımlar için Kurulum

Ayrılmış dağıtım müşterileri standart Zoom Marketplace uygulamasını kullanamaz çünkü OAuth yönlendirme URL'sinin ayrılmış ajan örneğinize işaret etmesi gerekir. Bunun yerine kendi Zoom OAuth uygulamanızı oluşturup ajan'da özel bir OAuth istemcisiyle yapılandırmanız gerekir. Özel OAuth istemcileri ve grup atamalarının nasıl çalıştığı için Kendi OAuth İstemcinizi Getirin sayfasına bakın.

Önkoşullar

  • Zoom App Marketplace erişimine sahip Zoom yönetici veya geliştirici hesabı
  • Ayrılmış ajan örneğinize yönetici erişimi

Adım 1: Zoom OAuth Uygulaması Oluşturun

Zoom App Marketplace'i açın

Zoom App Marketplace adresine gidin ve Zoom hesabınızla oturum açın. Üst gezinmede Develop düğmesine tıklayın ve Build App seçin.

Temel bilgileri yapılandırın

Uygulama adını güncelleyin ve şunları yapılandırın:

  • App Name: Açıklayıcı bir ad seçin (ör. "ajan")
  • App Management Type: Bireysel kullanıcıların kendi Zoom hesaplarını bağlayabilmesi için User-managed seçin
  • OAuth Redirect URL: ajan örneğinizdeki yönlendirme URL'sini girin. Bulmak için Workspace settings → Integrations → Zoom yoluna gidin ve Configure your OAuth client to use this integration. düğmesine tıklayın. Yönlendirme URL'si yapılandırma iletişim kutusunda görünür.

Yönlendirme URL'si tam eşleşmelidir. Herhangi bir uyuşmazlık kimlik doğrulama sırasında redirect_uri_mismatch hatalarına yol açar.

Kapsamları yapılandırın

Scopes bölümüne gidin ve şu kapsamları ekleyin:

Recording

  • cloud_recording:read:meeting_transcript
  • cloud_recording:read:recording
  • cloud_recording:read:list_recording_files
  • cloud_recording:read:list_user_recordings

User

  • user:read:email
  • user:read:user

Meetings

  • meeting:read:past_meeting
  • meeting:read:meeting
  • meeting:read:list_past_instances
  • meeting:read:list_meetings
  • meeting:read:list_upcoming_meetings
  • meeting:write:meeting
  • meeting:read:summary

Yukarıda listelenen tüm kapsamlar gereklidir. Eksik kapsamlar, kullanıcılar ajan üzerinden belirli Zoom özelliklerine erişmeye çalıştığında hatalara yol açar.

Kimlik bilgilerinizi kaydedin

Uygulamayı oluşturduktan sonra uygulamanın credentials sayfasından Client ID ve Client Secret değerlerini not edin. Bir sonraki adımda bunlara ihtiyacınız olacak.

Adım 2: Uygulamayı Kullanıcılara Ekleyin

Uygulama oluşturulduktan sonra ajan ile bağlanabilmesi gereken Zoom kullanıcılarına eklemeniz gerekir.

Add app for others seçin ve Zoom hesabınızdaki belirli kullanıcıları veya tüm kullanıcıları seçin. Bu seçenek ek uygulama ayarlarını da yapılandırmanıza olanak tanır.

Yalnızca kendi hesabınız için entegrasyonu etkinleştirmek üzere Add app for yourself seçin. Bu seçenek ek uygulama ayarlarına erişim sağlamaz.

Ekledikten sonra uygulamanın yönetici görünümünde Users & groups sekmesi altında kullanıcıları ve izinlerini yönetebilirsiniz.

Adım 3: ajan'da OAuth İstemcisini Yapılandırın

Entegrasyon ayarlarını açın

Ayrılmış ajan örneğinizde Workspace settings → Integrations yoluna gidin ve Zoom seçin. Configure your OAuth client to use this integration. düğmesine tıklayın.

Kimlik bilgilerini girin

İstemci listesinde tanımlamak için isteğe bağlı bir Client name ekleyin. Access altında Entire workspace bırakın veya istemciyi belirli kullanıcı gruplarıyla sınırlamak için Groups seçin. Adım 1'de oluşturduğunuz Zoom uygulamasından Client ID ve Client secret girin. Save düğmesine tıklayın ve değişikliği onaylayın.

İstemciyi etkinleştirin

Kaydedilen istemciyi istemci listesinden seçin ve geçişi onaylayın.

Bağlantıyı test edin

Bir kullanıcının Zoom hesabını bağlayarak şunları doğrulayın:

  • OAuth izin ekranı doğru görünüyor
  • Gerekli tüm kapsamlar verildi
  • Zoom verileri (toplantılar, kayıtlar) ajan üzerinden erişilebilir

Yaygın Kullanım Durumları

  • Toplantı Yönetimi — Yeni toplantılar planlayın, yaklaşan veya geçmiş toplantıları alın ve katılım bağlantıları ile ayarlar gibi toplantı ayrıntılarına erişin
  • Toplantı Özetleri — Tamamlanan toplantılar için AI tarafından üretilen özetleri alın (Zoom AI Companion gerekir)
  • Kayıtlar — Bulut kayıtlarına göz atın, kayıt dosyalarına erişin ve tam metin transkriptleri alın
  • Yinelenen Toplantılar — Belirli oluşumları izlemek için yinelenen toplantıların geçmiş örneklerine bakın

Örnek Prompt'lar

  • "Schedule a 30-minute meeting called 'Q2 Planning' for tomorrow at 2pm Berlin time"
  • "What meetings do I have coming up this week?"
  • "Get the transcript from my last all-hands recording"
  • "Show me the summary of yesterday's team standup"
  • "List all recordings from last month"

İzinler

Entegrasyon şu Zoom kapsamlarını ister:

KategoriKapsamlar
Recordingcloud_recording:read:meeting_transcript, cloud_recording:read:recording, cloud_recording:read:list_recording_files, cloud_recording:read:list_user_recordings
Useruser:read:email, user:read:user
Meetingsmeeting:read:past_meeting, meeting:read:meeting, meeting:read:list_past_instances, meeting:read:list_meetings, meeting:read:list_upcoming_meetings, meeting:write:meeting, meeting:read:summary

Notlar

  • Toplantı özetleri için Zoom hesabınızda Zoom AI Companion etkin olmalıdır
  • Transkriptler yalnızca transkripsiyonun etkin olduğu bulut kayıtları için kullanılabilir
  • Toplantı oluşturmak, toplantı planlanmadan önce onayınızı gerektirir