Ayrıntılı Çağrı Kayıtları webhook'u, isteklerden ziyade olaylara dayalı, güvenli, ölçeklenebilir ve sağlam bir çözüm sunar. Bu webhook, müşterilerinizin Webex arama etkinliklerine daha fazla görünürlük sağlayarak faturalandırmadan özel olarak hazırlanmış raporlamaya kadar çeşitli kullanım durumlarını destekler.

Bu webhook'u kullanarak, her müşteriyi ayrı ayrı sorgulamanıza gerek kalmadan, Partner Hub üzerinden yönetilen tüm müşterilerin kayıtlarını kolayca toplayabilirsiniz. Bu webhook, hem dahili iş gereksinimleri hem de katma değerli hizmetler için özel raporlama, faturalama ve analitik uygulamalar geliştirmenize olanak tanır.

Webhook ve ona eşlik eden API'lere giriş için bu Vidcast'i izleyin: Webex Arama Ortağı Ayrıntılı Arama Geçmişi API'si.

Partner webhook'un sunduğu özellikler

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

• Mevcut zamandan 10 dakika ile 5 dakika öncesi arasında sona eren arama kayıtları.
• Webex Calling bulut sistemi tarafından işlenen tüm geç kayıtlar.
• Güvenilir teslimatı sağlamak için, gecikmiş çağrı kayıtlarını sonraki webhook yüklerinde otomatik olarak doldurur.

Çağrı kayıtlarının her bir veri paketine nasıl dahil edildiğini göstermek için aşağıdaki örneği ele alalım:

• Alınan bir veri yükü 14:05 Bu, şu tarihler arasında sona eren aramaları içerir. 13:55 Ve 14:00.
• Çağrıların sona ermesi arasında 14:00 Ve 14:05 dahil edilmiştir 14:10 yük.
• Daha önce tamamlanan kayıtlar (örneğin, şu saatte sona eren bir arama) 14:04) ancak Webex Calling bulut hizmeti tarafından geç işlendi (örneğin, şu saatte) 14:11) bir sonraki planlanan yük paketine dahil edilir (örneğin, 14:15).

Partner Hub'da Webhook

Bir webhook sağlayarak, analiz platformunun çağrı kayıtları oluşturulduğu anda bunları geri arama URL'nize göndermesini sağlarsınız.

Webex Çağrı kayıtları, mevcut Ayrıntılı Çağrı Kayıtları API'leriile aynı formatta sunulmaktadır. Bir webhook kurabilir ve iki tür besleme arasından seçim yapabilirsiniz:

• Analizler—İş ortağının Webex Calling ilişkisi bulunan tüm müşteri kuruluşlarına ait tüm çağrı kayıtlarını içerir. Bu, aşağıdaki kuruluşları kapsar:
  • İş ortağı, Tam Yetkili İş Ortağı rolüyle müşteri organizasyonunu yönetir.
  • Müşteri kuruluşunun, iş ortağı kuruluş bünyesinde aktif bir Webex Calling aboneliği bulunmaktadır.
• Faturalama—İş ortağı tarafından satılan ve sağlanan Webex Calling lisansına sahip kullanıcılar tarafından yapılan aramaların çağrı kayıtlarını içerir. Çalışma alanlarına ait arama kayıtları bu akışa dahildir.

Erişim ve veri gizliliği

Fatura işlemleri için Çağrı Detay Kayıtlarına (CDR) yalnızca sahip olan ortak erişebilir.

• Çağrı kaydıyla ilişkili lisansı yöneten ortak (veya alt ortak), lisans sahibi ortak haline gelir.
• Mülkiyet şu unsurlar tarafından belirlenir: Kullanıcı kimliği > Lisans Kimliği > Abonelik Kimliği > İş Ortağı Kimliği.
• Her bir CDR'ye yalnızca tek bir iş ortağı erişebilir.
• Bazı çağrı kayıtları faturalandırma ortağıyla eşleştirilemez ve bir kuruluşla ilişkili tüm ortaklar, bu kayıtlar kişisel olarak tanımlanabilir bilgiler (PII) içerebileceğinden, tüm kayıtlara eşit erişime sahip değildir.

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

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

Bu API'lere erişmek için iş ortağı erişim belirteci kullanmanız gerekmektedir. İş ortağı erişim belirtecinizi standart Webex Geliştirici erişim belirteci yönetimi uygulamalarınagöre edinin ve yönetin.

Mutabakat API uç noktası

Mutabakat API uç noktası, belirtilen zaman dilimi içinde iş ortağı tarafından yönetilen her müşteri için oluşturulan toplam çağrı 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 çağrı kayıtlarını tespit etmek için kullanabilirsiniz.

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

Uzlaşma API uç noktası URL'si aşağıdaki formatı kullanır:

API Parametreleri

API'yi kullanarak son 30 güne ait çağrı kayıtlarını alabilirsiniz. Seçtiğiniz zaman aralığı, 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 (gerekli, dize)—Toplamak istediğiniz ilk kaydın başlangıç tarihi ve saati (UTC). Şunlardan emin olun:
  • Zamanı köşeli parantez içinde YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendiriyorsunuz. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati, mevcut UTC saatinden itibaren 30 günden daha eski olmamalıdır.
  • startTime ve endTime arasındaki zaman aralığı 12 saati geçemez.
• endTime (gerekli, dize)—Toplamak istediğiniz kayıtların bitiş tarihi ve saati (UTC). Kayıtlar, görüşmenin tamamlandığı zamana, yani raporlama zamanına göre tutulmaktadır. Şunlardan emin olun:
  • Zamanı köşeli parantez içinde YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendiriyorsunuz. Örneğin, 2025-08-15T18:00:00.000Z.
  • Bitiş tarihi ve saati, mevcut UTC saatinden 5 dakika önce olmalı ve 30 günden eski olmamalıdır.
  • Bitiş tarihi ve saati startTime'den büyük olmalıdır.
  • startTime ve endTime arasındaki zaman aralığı 12 saati geçemez.

Mutabakat API uç noktası JSON yanıtına örnek:

          {
          "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 kuruluşların toplam sayısını ve ek sayfaların mevcut olup olmadığını gösterir. Tüm sayfaları sorguladığınızdan emin olmak için aşağıdaki başlık parametrelerini kontrol edin:

• sayfa sayısı: Toplam sayfa sayısı (örneğin, 2)
• toplam-örgütler: Yanıta dahil edilen kuruluşların toplam sayısı (örneğin, 283)
• mevcut sayfa: Geçerli sayfa numarası (örneğin, 1)

Örneğin, başlıklar şu şekilde görünüyorsa: num-pages=2, total-orgs=283, Ve current-page=1, Şu anda toplam 283 kuruluşu içeren iki sayfalık yanıtın ilk sayfasını görüntülüyorsunuz. Sonraki sayfaya geçmek için şunu ekleyin: page=2 GET isteğinize aşağıdaki gibi bir parametre 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

Kayıtlar API uç noktası

Kayıtlar API uç noktası, Mutabakat API'si kullanılarak tutarsızlıklar veya eksik veriler tespit edilen belirli kuruluşlar için eksik çağrı kayıtlarını sorgulamak amacıyla kullanılır.

Kayıtlar API'si, Ayrıntılı Çağrı Geçmişi API'sindeaçıklanan formatla aynı olan JSON formatında çağrı kayıtlarını döndürür. Geri dönen veri, Ayrıntılı Çağrı Geçmişi verisiyle aynı alanları içerir. Alanlar ve değerleri hakkında daha fazla bilgi için Webex Arama Detaylı Arama Geçmişi Raporubölümüne bakın.

API, mevcut zamandan 5 dakika önce sona eren çağrı kayıtlarını sağlar. Tüm çağrı kayıtlarının erişilebilir olmasını sağlamak için, tercih ettiğiniz zaman aralığından bir saat sonra API'yi sorgulamanızı öneririz.

Kayıtlar API uç noktası URL'si aşağıdaki formatı 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 (gerekli, dize)—Kayıtlarını almak istediğiniz kuruluşun kimliği. Mutabakat API'sinden kuruluş kimliklerini edinebilirsiniz.
• startTime (gerekli, dize)—Toplamak istediğiniz ilk kaydın başlangıç tarihi ve saati (UTC). Şunlardan emin olun:
  • Zamanı köşeli parantez içinde YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendiriyorsunuz. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati, mevcut UTC saatinden itibaren 30 günden daha eski olmamalıdır.
  • startTime ve endTime arasındaki aralık, tek bir API isteğinde 12 saati geçmemelidir.
• endTime (gerekli, dize)—Toplamak istediğiniz son kaydın bitiş tarihi ve saati (UTC). Kayıtlar, görüşmenin tamamlandığı zamana, yani raporlama zamanına göre tutulmaktadır. Şunlardan emin olun:
  • Zamanı köşeli parantez içinde YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendiriyorsunuz. Örneğin, 2025-08-15T18:00:00.000Z.
  • Bitiş tarihi ve saati, mevcut UTC saatinden en az 5 dakika önce olmalı ve 30 günden eski olmamalıdır.
  • Bitiş tarihi ve saati startTime'den büyük olmalıdır.
  • startTime ve endTime arasındaki aralık, tek bir API isteğinde 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ık 500 ile 5000 arasındadır. Varsayılan değer 5000'dir. Örneğin, Max=1000.
  • API'nin döndüreceği kayıt sayısı belirtilen Maksimum değerden fazlaysa, yanıt sayfalandırılır.
  • 500'ün altında bir değer belirtilirse, otomatik olarak 500'e yükseltilir. 5000'in üzerinde bir değer belirtilirse, bu değer 5000'e düşürülür.

Sayfa Numaralandırma

API yanıtlarının sayfalara ayrılmış olup olmadığını belirlemek için, yanıt başlıklarında Link başlığını kontrol edin. Bağlantı başlığında next bağlantısı varsa, onu çıkarın ve bir sonraki kayıt kümesini istemek için startTimeForNextFetch değerini kullanın. Sonraki bağlantı yoksa, seçilen zaman aralığına ait tüm raporlar toplanır.

Sonraki sayfalara yönelik API istekleri hemen yapılabilir, ancak her token kapsamı için dakikada en fazla 10 sayfalandırılmış istekle sınırlandırılmalıdır.

Örneğin, ilk API isteği şu şekildeyse:

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

Yanıtın Link başlığı şu şekildedir:

; rel="next"

Diğer olası bağlantı değerleri, sırasıyla ilk ve önceki sayfalar için rel="first" ve rel="prev" şeklindedir.

Partner Hub'da bulunan raporları Partner Raporları API'lerinikullanarak oluşturabilir ve indirebilirsiniz. Daha fazla bilgi için ortağına bakın. report/templates.

İş ortakları, İş Ortağı Merkezi'nden doğrudan birden fazla rapora erişebilir ve bunları indirebilirler. Daha fazla bilgi için Partner Hub raporlarınabakın.