Kayıtlar/Sesli Mesajlar için Google Cloud Storage ve Speech API V2 Transkripsiyon 3CX V20'de
Not: Zaten uygun haklara ve Google gruplarına sahip bir GCloud hesabınız varsa 1. ve 2. adımlar atlanabilir.
Bı konuda:
Notlar:
- Zaten uygun yetkilere sahip bir GCloud hesabınız ve Google depolama alanlarınız varsa, 1. ve 2. adımlar atlanabilir.
- Google hizmetleri için sihirbaz tabanlı bir entegrasyon sunuyoruz; bu belge, bu bileşeni manuel olarak kurmak isteyenler için sınırlı bir kılavuz niteliğindedir.
Adım 1: Gerekli Hesap Erişimi
Google Storage Buckets yapılandırmak için şuraya gidin: "IAM ve Admin" > "IAM" Google Cloud kontrol panelinizde hesabınıza en azından şu rollerin atandığını doğrulayın:
- “Service Account Admin”.
- “Service Account Key Admin”.
- "Project IAM Admin".
- “Storage Admin”.
Adım 2: Storage Bucket Oluşturma
Projenizde zaten yapılandırılmış Storage Buckets varsa bu bölümü atlayabilirsiniz
Yapılandırılmış ödeme seçeneklerine sahip etkin bir aboneliğiniz varsa Google bulut projeniz altında yeni bir depolama alanı grubu oluşturmaya devam edin:
Ana gezinme menüsünden "Storage" > "Browser" gidin ve yeni bir depolama oluşturmak için “Create Bucket” seçin.
- "Create a bucket" sayfasında şunları yapılandırın:
- Name - küresel olarak benzersiz bir kalıcı ad girin.
- Where to store data - gereksinimlerinize göre depolama konumu türünü seçin.
- Storage class - kullanımınıza uygun depolama sınıfını seçin.
- Access control - depolama paketindeki nesnelere erişimin nasıl kontrol edileceğini ayarlayın.
- Advanced settings - isteğe bağlı olarak depolama grubu için şifreleme ve saklama ilkesi tercihlerini ayarlayın.
- Yeni depolama paketini ayarlamak için “Create”e tıklayın.
- Depolama paketinizi oluşturduktan sonra, yedekleri ve arşivlenmiş ses kayıtlarını saklamak üzere yeni klasörler eklemek için “Create Folder”a tıklayabilirsiniz; örnek: “3cx_backups”.
Kaydedilmiş JSON anahtarınızı kullanmaya devam edin ve yapılandırılmış Google Cloud depolama grubunu 3CX yedeklemelerini ve arşiv kayıtlarını depolamak için bir konum olarak ayarlayın.
⚠Önemli:
Etkin saklama politikası nedeniyle “Bekletme” durumunda veya saklanan/arşivlenen yedek dosyalar veya arşivlenmiş kayıtlar, PBX tarafından silinemez veya üzerine yazılamaz.
Adım 3: Projeniz için Cloud Speech-to-Text API'yi etkinleştirin
Google Konsolundan APIs & Services > Library'a gidin ve Cloud Speech-to-Text API'yi arayın. Onu seçin ve “Enable”’a tıklayın.
Adım 4: Depolama ve Konuşma Erişimi ile Hizmet Hesabı ve Anahtar Oluşturun
GCloud Projenizde IAM & Admin > Service Accounts'a gidin ve "Create Service Account” tıklayın. Ona bir ad verin ve “Create and Continue” tıklayın.
Aşağıdaki Rolleri Hizmet Hesabınıza ekleyin ve “Continue" ve daha sonra "Done”:
- Storage Admin
- Cloud Speech Administrator
Yeni oluşturulan Hizmet Hesabını düzenleyin ve “Keys” sekmesine, ardından “Add Key” tıklayın
Json türünü seçin ve “Create” tıklayın.
Bir json dosyası indirilecektir. Tekrar indiremeyeceğiniz için güvenli bir yere kaydedin.
Adım 5: Uzaktan Arşivlemeyi ve Transkripsiyonu Etkinleştirin
- 3CX’i sesli mesajlar ve/veya kayıtlar için transkripsiyon kullanacak şekilde yapılandırmak için, Yönetici Konsolu > “Sistem” > “Depolama” bölümüne gidin.
- “Uzaktan Veri Depolama & Arşivlemeyi Etkinleştir” seçeneğini seçin ve Konum Türü (Gerekli) alanında “Google Depolama”yı seçin.
- Önceki adımda indirdiğiniz json dosyasını Özel Anahtar (JSON türü) alanına yükleyin ve Google Depolama Kovası içindeki bir Klasör/Yol seçin.
- Google Depolama'ya otomatik arşivlemeyi etkinleştirmek için “Kayıtlar” ve “Sesli Mesajlar” onay kutularını işaretleyin.
- Kaydedin ve “Entegrasyonlar” > “Transkripsiyon” bölümüne gidin
- Transkripsiyon motoru olarak “Google Speech” seçeneğini seçin.
- Transkripsiyon dilini ayarlamak için “Konuşma Dili” açılır menüsünü seçin.
- Transkripsiyon yapılacak öğeyi seçin:
- “Yalnızca Sesli Mesajlar” - sesli mesajlarla sınırlandırın.
- “Yalnızca Kayıtlar” - yalnızca kayıtlarla sınırlayın.
- “Hem Sesli Mesajlar Hem de Kayıtlar”
- Ayarları uygulamak için “Tamam”ı tıklayın. Sesli Mesaj Transkripsiyonu etkinleştirildikten sonra, alınan sesli mesajların e-posta gövdesine transkripsiyon metni eklenir. Ayrıca, 3CX Web İstemcisi’nin Sesli Mesajlar/Kayıtlar bölümlerinde, her sesli mesajın/kayıtın yanında transkripsiyon metni görüntülenir.
Kayıtlar, uzaktan arşivleme sırasında (hemen / planlanan zamanda) tam olarak kopyalanır. Bunun nedeni, 3CX'in Bucket Arşivleme özelliğini içermesi ve dolayısıyla dosyanın tam olarak kopyalanabilmesidir.
Ayrıca Bakınız
- Linux için Çağrı Kontrolü API'si
- Windows için Çağrı Denetimi API'si
- Çağrı İşleme Komut Dosyası Oluşturma
- DTMF Girişi için Çağrı İşleme Komut Dosyası
Son güncelleme
Bu belge en son 9 Temmuz 2026'te güncellendi
https://www.3cx.com.tr/docs/yonetici-kilavuzu/google-speech-api-v2/
