Geri bildiriminiz için teşekkürler.

Ayrıntılı Çağrı Kayıtları web kancası, isteklerden ziyade olaylar tarafından yönlendirilen güvenli, ölçeklenebilir ve sağlam bir çözüm sunar. Bu web kancası, müşterilerinizin Webex Calling faaliyetleri hakkında daha fazla görünürlük sağlar ve faturalandırmadan özel raporlamaya kadar kullanım senaryolarını destekler.

Bu web kancasını, her müşteriyi ayrı ayrı sorgulamadan İş Ortağı Merkezi aracılığıyla yönetilen tüm müşter iler için uygun bir şekilde kayıt toplamak için kullanabilirsiniz. Bu web kancası, hem dahili iş gereksinimleri hem de katma değerli hizmetler için özel raporlama, faturalandırma ve analitik uygulamalar geliştirmenize olanak tanır.

Webhook ve beraberindeki API'lere giriş için, bu Vidcast: Webex Calling İş Ortağı Ayrıntılı Çağrı Geçmişi API'sini izleyin.

İş Ortağı web kancasının sunduğu özellikler

Webhook, her 5 dakikada bir ayrıntılı arama geçmişi kayıtları sunar. Her webhook yükü şunları içerir:

• Geçerli saatten 10 dakika ile 5 dakika önce biten çağrı kayıtları.
• Webex CallingBulut tarafından işlenen tüm geç kayıtlar.
• Güvenilir teslimat sağlamak için sonraki web kancası yüklerinde geç çağrı kayıtlarını otomatik olarak doldurur.

Çağrı kayıtlarının her bir yüke nasıl dahil edildiğini göstermek için aşağıdaki örneği göz önünde bulundurun:

• 14:05'te alınan bir yük, 13:55 ile 14:00 arasında sona eren aramaları içerir.
• 14:00 ile 14:05 arasında biten aramalar 14:10 yüküne dahildir.
• Daha önce tamamlanan kayıtlar (örneğin, 14:04'te sona eren bir çağrı) ancak Webex Calling bulut tarafından geç işlenen (örneğin, 14:11'de) bir sonraki planlanan yük yüküne dahil edilir ( örneğin, 14:15).

İş Ortağı Merkezi'nde Webhook

Bir web kancası sağlayarak, analiz platformunun arama kayıtlarını her oluşturulduğunda geri arama URL'nize göndermesini sağlarsınız.

Webex Callingkayıtlar, mevcut Ayrıntılı Çağrı Kayıtları API'leri ile aynı biçim kullanılarak teslim edilir. Bir web kancası kurabilir ve iki tür besleme arasından seçim yapabilirsiniz:

• Analitik — İş ortağının ilişkisi olduğu tüm müşteri kuruluşlarına ait tüm çağrı kayıtlarını içerir. Webex Calling Bu, aşağıdaki kuruluşları içerir:
  • İş ortağı, müşteri organizasyonunu İş Ortağı Tam Yöneticisi rolüyle yönetir.
  • Müşteri kuruluşunun ortak kuruluş içinde aktif bir Webex Calling aboneliği vardır.
• Faturalandırma—İş ortağı tarafından satılan ve sağlanan Webex Calling lisansa sahip kullanıcılar tarafından yapılan aramaların arama kayıtlarını içerir. Çalışma Alanları için çağrı kayıtları bu feed'e dahildir.

Erişim ve veri gizliliği

Yalnızca sahip iş ortağı faturalandırma için Arama Detay Kayıtlarına (CDR) erişebilir.

• Arama kaydıyla ilişkili lisansı yöneten bir ortak (veya alt ortak) sahip ortak olur.
• Sahiplik şu şekilde belirlenir: Kullanıcı Kimliği > Lisans Kimliği > Abonelik Kimliği > İş Ortağı Kimliği.
• Her CDR tek bir ortak tarafından erişilebilir.
• Bazı çağrı kayıtları bir faturalandırma ortağıyla eşlenmez ve bir kuruluşla ilişkili tüm ortaklar tüm kayıtlara eşit erişim sağlamaz, çünkü bu kayıtlar kişisel olarak tanımlanabilir bilgiler (PII) içerebilir.

Web kancasına ek olarak, veri mutabakatını desteklemek için API uç noktaları Webex Calling sağlar. Bu uç noktalar, veri depolarınızı webhook dinleyicinizin almamış olabileceği eksik kayıtlarla yakalamanıza veya uzlaştırmanıza olanak tanır. İki API uç noktası Mutabakat API'si ve Kayıtlar API 'si dir.

Bu API'lerden gelen kayıtlar 30 gün boyunca kullanılabilir. Beklenen tüm kayıtları aldığınızdan emin olmak için, plak depolarınızı periyodik olarak, örneğin her 12 veya 24 saatte bir uzlaştırmanızı öneririz.

Bu API'lere erişmek için bir iş ortağı erişim belirteci kullanmanız gerekir. Kimlik doğrulaması yapan kullanıcı, Kuruluş tam yönetici düzeyinde erişime sahip bir İş Ortağı Tam Yöneticisi olmalı ve Webex CallingCDR API eriş iminin etkin olması gerekir. OAuth belirteci kapsamı içermelidir. spark-admin:calling_cdr_read İş Ortağı Mutabakatı ve Kayıtlar API'leri için salt okunur yönetici rolleri yeterli değildir.

Müşteri kuruluşunun Webex Calling veri bölgesi için analytics-callinguç noktayı kullanın. Hem Mutabakat hem de Kayıtlar API'leri için geçerli temel URL'yi kullanın:

• ABD ve Kanada: https://analytics-calling.webexapis.com
• Avrupa: https://analytics-calling-eu.webexapis.com
• Hindistan: https://analytics-calling-in.webexapis.com
• Avustralya: https://analytics-calling-au.webexapis.com

Mutabakat API uç noktası

Mutabakat API'si uç noktası, belirtilen süre içinde iş ortağı tarafından yönetilen her müşteri için oluşturulan toplam arama kaydı sayısını döndürür. Bu toplamları yerel depolama alanınızı doğrulamak ve belirli müşteriler için eksik veya tutarsız arama kayıtlarını belirlemek için kullanabilirsiniz.

200'den fazla müşteri kuruluşunu yönetiyorsanız, API okunabilirliği artırmak için sonuçları sayfalandırır.

Mutabakat API uç nokta URL'si aşağıdaki biçimi kullanır:

API Parametreleri

Son 30 gündeki çağrı kayıtlarını almak için API'yi kullanabilirsiniz. Seçtiğiniz zaman penceresi geçerli UTC saatinden en az 5 dakika önce başlamalı ve tek bir API çağrısında başlangıç ve bitiş saatleri arasında 12 saati geçmemelidir.

API parametreleri şunlardır:

• StartTime (zorunlu, dize) —Toplamak istediğiniz ilk kaydın başlangıç tarihi ve saati (UTC). Şunlardan emin olun:
  • Saati şu şekilde biçimlendirirsiniz YYYY-MM-DDTHH:MM:SS.mmmZ. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati geçerli UTC saatinden itibaren 30 günden daha eski olmamalıdır.
  • Arasındaki startTimeve 12 saati geç endTimeemez.
• EndTime (zorunlu, dize) —Toplamak istediğiniz kayıtların bitiş tarihi ve saati (UTC). Kayıtlar, aramanın tamamlandığı rapor süresine dayanır. Şunlardan emin olun:
  • Saati şu şekilde biçimlendirirsiniz YYYY-MM-DDTHH:MM:SS.mmmZ. Örneğin, 2025-08-15T18:00:00.000Z.
  • Bitiş tarihi ve saati geçerli UTC saatinden 5 dakika önce olmalı ve 30 günden eski olmamalıdır.
  • Bitiş tarihi ve saati şunlardan büyük olmalıdır startTime.
  • Aralarındaki startTimepencere 12 saati geç endTimeemez.

Mutabakat API uç nokta JSON yanıtı örneği:

          {
          "cdr_counts": [
          {
          "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 3009
          },
          {
          "orgId": "yyyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 129
          },
          {
          "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyy",
          "count": 27895
          }
          ]
          }          
        

API yanıt başlıkları, döndürülen toplam kuruluş sayısını ve ek sayfaların kullanılabilir olup olmadığını gösterir. Tüm sayfaları sorguladığınızdan emin olmak için aşağıdaki başlık parametrelerini kontrol edin:

• sayı sayfaları: Toplam sayfa sayısı (örneğin, 2)
• toplam organizasyonlar: Yanıta dahil edilen toplam kuruluş sayısı (örneğin 283)
• geçerli sayfa: Geçerli sayfa numarası (örneğin, 1)

Örneğin, üstbilgiler num-pages=2, total-orgs=283 ve current-page=1 gösteriyorsa, toplamda 283 kuruluş içeren iki sayfalık bir yanıtın ilk sayfasını görüntülersiniz. Sonraki sayfaya erişmek için, aşağıda gösterildiği gibi GET isteğinize page=2 parametresini ekleyin:

https://analytics-calling.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z&page=2

API uç noktasını kaydediyor

Kayıtlar API uç noktası, Uzlaşma API'si kullanılarak tutarsızlıkların veya eksik verilerin tespit edildiği belirli kuruluşlar için eksik çağrı kayıtlarını sorgulamak için kullanılır.

Önerilen akış: /v1/partners/cdrcountbyorgÖnce ara. Ardından, aradığınızda tam orgIdolarak dön cdr_counts[].orgIddürülen değeri kullanın /v1/partners/cdrsbyorg.

Kayıtlar API'si, Ayrıntılı Çağrı Geçmişi API'sinde açıklanan biçimle aynı olan JSON biçiminde çağrı kayıtlarını döndürür. Döndürülen yük, döndürülen Ayrıntılı Çağrı Geçmişi yükü ile aynı alanları içerir. Alanlar ve değerleri hakkında daha fazla bilgi için bkz. Ayrıntılı Webex CallingÇağrı Geçmişi Raporu.

API, geçerli saatten 5 dakika önce biten çağrı kayıtlarını sağlar. Tüm arama kayıtlarının kullanılabilir olduğundan emin olmak için, tercih ettiğiniz zaman aralığından bir saat sonra API'yi sorgulamanızı öneririz.

Kayıtlar API uç nokta URL'si aşağıdaki biçimi kullanır:

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z

API Parametreleri

• orgId(zorunlu, dize) —Kayıtları almak istediğiniz müşteri kuruluş kimliği. Parametre adı büyük/küçük harfe duyarlıdır. Mutabakat API'si yanıt alanından kuruluş kimliklerini edinebilirsiniz cdr_counts[].orgId.
• StartTime (zorunlu, dize) —Toplamak istediğiniz ilk kaydın başlangıç tarihi ve saati (UTC). Şunlardan emin olun:
  • Saati şu şekilde biçimlendirirsiniz YYYY-MM-DDTHH:MM:SS.mmmZ. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati geçerli UTC saatinden itibaren 30 günden daha eski olmamalıdır.
  • Tek bir API ist startTimeeğ endTimeinde ve arasındaki aralık 12 saati geçmemelidir.
• EndTime (zorunlu, dize) —Toplamak istediğiniz son kaydın bitiş tarihi ve saati (UTC). Kayıtlar, aramanın tamamlandığı rapor süresine dayanır. Şunlardan emin olun:
  • Saati şu şekilde biçimlendirirsiniz YYYY-MM-DDTHH:MM:SS.mmmZ. Örneğin, 2025-08-15T18:00:00.000Z.
  • Bitiş tarihi ve saati geçerli UTC saatinden en az 5 dakika önce ve 30 günden eski olmamalıdır.
  • Bitiş tarihi ve saati şunlardan büyük olmalıdır startTime.
  • Tek bir API ist startTimeeğ endTimeinde ve arasındaki aralık 12 saati geçmemelidir.
• max (isteğe bağlı, sayı) —Yanıttaki sayfa başına maksimum kayıt sayısını sınırlar. Şunlardan emin olun:
  • Aralığı 500 ila 5000 arasındadır. Varsayılan değer 5000'dir. Örneğin, max=1000.
  • API'nin döndürülmesi gereken belirtilen maksimum değerden daha fazla kaydı varsa, yanıt sayfalandırılır.
  • 500'ün altında bir değer belirtilmişse, otomatik olarak 500'e kadar ayarlanır. 5000'in üzerinde bir değer belirtilmişse, 5000'e düşürülür.

Sayfalandırma

API yanıtlarının sayfalandırılıp sınıflandırılmadığını belirlemek için Bağlantı başlığı için yanıt başlıklarını kontrol edin. Bağlantı baş nextlığında bir bağlantı varsa, onu ayıklayın ve bir sonraki startTimeForNextFetchkayıt kümesini istemek için değeri kullanın. Bir sonraki bağlantı yoksa, seçilen zaman aralığı için tüm raporlar toplanır.

Sonraki sayfalar için API istekleri hemen yapılabilir, ancak token kapsamı başına dakikada en fazla 10 sayfalandırılmış istek oranı ile sınırlandırılmalıdır.

Sayfalandırılmış yanıtlar veya tekrarlanan mutabakat pencereleri dahil olmak üzere kayıtları alırken idempotent işleme ve çoğaltma kaldırma özelliğini kullanın. Birincil anahtar reportIdolarak kullanın ve en reportTimeson işlenen kaydı belirlemek için.

Örneğin, ilk API isteği ise:

https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&max=5000

o zaman yanıttaki Bağlantı başlığı:

<https://analytics-calling.webexapis.com/v1/partners/cdrsbyorg?orgId=zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy&endTime=2025-08-15T18:00:00.000Z&startTime=2025-08-15T06:00:00.000Z&startTimeForNextFetch=2025-08-15T09:30:00.000Z&totalCount=20000&max=5000>; rel="next"

Sayfalandırma yalnızca rel="next"Bağlantı başlığını kullanır. Yanıt bir rel="next"bağlantı içeriyorsa, bir sonraki kayıt sayfasını almak için bu URL'yi kullanın. Yanıt bir rel="next"bağlantı içermiyorsa, seçilen zaman aralığı için mevcut tüm kayıtları aldınız demektir.

İş Ortağı Raporları API'lerini kullanarak İş Ortağı Merkezi'nde bulunan raporları oluşturabilir ve indirebilirsiniz. Daha fazla bilgi için iş ortağı raporu/şablonlarına bakın.

İş ortakları ayrıca doğrudan İş Ortağı Merkezi'nden birden fazla rapora erişebilir ve bunları indirebilir. Daha fazla bilgi için bkz. İş Or tağı Merkezi raporları.