Toplu Ses Dışa Aktarımı
Erişim Yolu
Üst menüden: Sağlayıcılar / Entegrasyonlar / Ses / API Anahtarları sekmeleri içinde Ses sekmesini açın.
Filtreler (Sol Panel)
Seçtiğiniz filtreler, dışa aktarılacak kayıt kümesini daraltır. Birden fazla filtre aynı anda kullanılabilir.
Tarih: Aralığı belirleyin. (Örn. 01.09.2025 00:00 – 30.09.2025 23:59). Zaman seçimi, performans ve doğruluk için önerilir.
Temsilciler: Belirli bir(kaç) temsilcinin çağrılarını süzmek için seçin.
Kuyruklar: Çağrıların geçtiği kuyruk(lar). Çoklu seçim desteklenir.
Projeler: Proje bazlı süzme.
Telefon: Belirli bir telefon numarası (uzak numara) için sonuçları daraltır.
Çağrı ID: Sistem içi tekil Interaction/Call ID ile nokta atışı arama.
Yön (Gelen/Giden):
Gelen: Müşteriden gelen çağrılar.
Giden: Temsilci/sistem tarafından başlatılan çağrılar.
Otomatik Arama: Auto Dialer kaynaklı çağrılar (seçiliyse filtreye dahil edilir).
İpucu: Büyük veri aralıklarında önce Tarih + Kuyruk ya da Temsilci ile daraltmanız önerilir. İşlem süresi kısalır, çıktı dosyaları daha derli toplu olur.
Ayarlar (Sağ Panel)
Bu panel, çıktı dosyalarının klasör yapısını, isimlendirme şablonunu ve iletişim kanallarını tanımlamanızı sağlar.
Zaman & Grup Seçenekleri (Üstteki Hızlı Seçimler)
Yıl / Ay / Gün: Klasörleme ve isimlendirmede kullanılacak tarih bileşenleri.
Ay (Sınırsız): Ay bazlı fakat gün detayına inmeden gruplayın.
Gün (Sınırsız): Gün bazlı fakat saat/dakika bazında ayrıştırma yapmadan gruplayın.
Temsilci: Dosya yolu veya dosya adında temsilci bilgisini kullanmak için hızlı etiket ekler.
Bu butonlar, aşağıdaki alanlarda kullandığınız şablonlara karşılık gelen etiketleri tek tıkla eklemenize yardımcı olur.
Dosya Yolu
Çıktıların kaydedileceği klasör yapısını tanımlar. Örn: {{Year}}/{{Month}}/{{Day}}
Sık Kullanılan Etiketler
{{Year}}→ Yıl (YYYY){{Month}}→ Ay (MM){{Day}}→ Gün (DD){{Agent}}→ Temsilci kullanıcı adı{{QueueName}}→ Kuyruk adı
Örnek: {{Year}}/{{Month}}/{{Day}}/{{Agent}} → 2025/09/30/iraz.ocal
Dosya Adı Formatı
Her ses kaydı için üretilecek dosya adının şablonu. Varsayılan örnek:
{{Direction}}_{{BaseRemoteNumber}}_{{Agent}}_{{StartTime}}_{{InteractionID}}Kullanılabilir Etiketler (Seçim Çipleri)
Start Time →
{{StartTime}}(epoch veya biçimlendirilmiş tarih—sistem ayarına göre)Phone →
{{BaseRemoteNumber}}(müşteri numarası)Agent →
{{Agent}}Direction →
{{Direction}}(inbound/outbound)Result Code →
{{ResultCode}}(varsa kampanya/sonuç kodu)Queue Name →
{{QueueName}}Call ID →
{{InteractionID}}Customer ID →
{{CustomerID}}(varsa CRM entegrasyonu)Full Name →
{{FullName}}(varsa müşteri adı)TCKN →
{{TCKN}}(varsa, KVKK uyumlu kullanım şarttır)
İyi Uygulama: Dosya adlarının benzersiz olması için StartTime + InteractionID kombinasyonunu koruyun.
Çıktı Dosya Adı (Opsiyonel)
Toplu arşiv/rapor çıktıları için üst dosya adı. Boş bırakılırsa sistem otomatik oluşturur.
E‑Posta (Opsiyonel)
İşlem tamamlandığında ilgili kişi/ekiplerin e‑posta ile bilgilendirilmesi için adres girin. Birden fazla adresi virgülle ayırabilirsiniz.
Zaman Damgası
Oluşturulan dosya adının sonuna zaman damgası ekler. Aynı adla çakışmayı önler.
FTP
Çıktının yapılandırılmış FTP sunucusuna yüklenmesini sağlar. (Öncesinde Entegrasyonlar > FTP yapılandırması gerekebilir.)
Yardımcı Butonlar
Voyce Voice Converter indir: Gerekli dönüştürücüyü bilgisayarınıza kurmak için.
Başlat: Seçili filtre ve ayarlarla işlemi başlatır.
API Anahtarı Yönetimi
Genel Bakış
Sistem üzerinde üçüncü parti uygulamalar ile entegrasyon sağlamak için API Anahtarı (API Key) oluşturmanız gerekir. API anahtarı, sisteme yapılacak çağrıların kimlik doğrulamasını ve güvenliğini sağlar.
Bu dökümanda, Voyce Paneli > Ayarlar > API Anahtarları ekranından nasıl API anahtarı oluşturulacağı adım adım anlatılmaktadır.
API Anahtarı Yönetim Ekranı
Erişim Yolu: Sol menüden Ayarlar > API Anahtarları sekmesine girilir.
Bu ekranda daha önce oluşturulmuş tüm API anahtarları listelenir.
Görünen Ad: API anahtarı için verilen isim.
API Anahtarı: Sistem tarafından üretilen benzersiz anahtar.
Oluşturan: Anahtarı oluşturan kullanıcı.
Oluşturulma Tarihi: Anahtarın üretildiği tarih.
Yeni bir API anahtarı oluşturmak için sağ üstteki Ekle butonuna tıklayın.
API Anahtarı Oluşturma Adımları
Görünen Ad
API anahtarını tanımlamak için bir isim verilir.
Örn:
CRM_Entegrasyon,Mobil_App,Raporlama_Tool
Yetkilendirmeler
Anahtarın hangi işlemleri yapabileceği burada belirlenir.
Örn:
read→ Sadece veri okumawrite→ Veri ekleme/güncellemedelete→ Veri silmeadmin.all → Tüm yetkiler
Öneri: Minimum gerekli yetkiler verilmelidir.
Anahtarın Oluşturulması
Bilgiler doldurulduktan sonra API Anahtarı Oluştur butonuna basılır.
Sistem otomatik olarak benzersiz bir anahtar üretir.
Bu anahtar ilk kez gösterildiğinde kopyalanmalı ve güvenli bir yerde saklanmalıdır.
Örnek Kullanım
API Çağrısı (cURL)
curl --request POST \ --url https://api.wrtcdev.voyce.cc/integration-voyce/v1/Profiles \ --header 'Authorization: <API_KEY>'
CtiToken ve Domain eşlemesine dayalı yetkilendirme işlemleri kullanılmaya devam etmektedir. Ancak, kullanıcı deneyimini hızlandırmak ve entegrasyon süreçlerini kolaylaştırmak amacıyla yeni bir yöntem olarak API Key desteği eklenmiştir.
Güvenlik Önerileri
API anahtarınızı üçüncü kişilerle paylaşmayın.
Gereksiz veya kullanılmayan anahtarları silin.
Sadece ihtiyacınız olan yetkileri tanımlayın.
Sonuç
Bu adımları izleyerek sisteme güvenli şekilde erişim sağlayacak API anahtarları oluşturabilirsiniz. Düzenli anahtar yönetimi, sistem güvenliğinin korunması için kritik öneme sahiptir.