Ayrıntılı Çağrı Kayıtları webhook'u, isteklerden ziyade olaylar tarafından yönlendirilen güvenli, ölçeklenebilir ve sağlam bir çözüm sunar. Bu webhook, faturalandırmadan özel olarak hazırlanmış raporlamaya kadar kullanım durumlarını destekleyerek müşterilerinizin Webex Calling etkinliklerine ilişkin daha fazla görünürlük sağlar.

Bu webhook'u kullanarak, her müşteriye ayrı ayrı sorgulama yapmadan, 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'ler hakkında bir giriş için şu Vidcast'i izleyin: Webex Çağrı Ortağı Ayrıntılı Çağrı Geçmişi API'si.

Partner webhook'un sunduğu hizmetler

Webhook her 5 dakikada bir detaylı çağrı geçmişi kayıtları sunar. Her webhook yükü şunları içerir:

• Mevcut zamandan 10 dakika ile 5 dakika önce sona eren çağrı kayıtları.
• Webex Calling bulutu tarafından işlenen tüm geç kayıtlar.
• Güvenilir teslimatı sağlamak için sonraki webhook yüklerinde geç çağrı kayıtlarını otomatik olarak geri 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 ele alalım:

• Alınan bir yük 14:05 arasında sona eren çağrıları içerir 13:55 Ve 14:00.
• Arasında biten çağrılar 14:00 Ve 14:05 dahildir 14:10 yük.
• Daha önce tamamlanan kayıtlar (örneğin, saat 11:00'de sona eren bir çağrı) 14:04) ancak Webex Calling bulutu tarafından geç işleniyor (örneğin, 14:11) bir sonraki planlanmış yüke dahil edilir (örneğin, 14:15).

Parter Hub'daki Webhook

Bir webhook sağlayarak, analiz platformunun çağrı kayıtlarını, oluşturuldukları her an 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ı format kullanılarak teslim edilir. Bir webhook ayarlayabilir ve iki tür besleme arasından seçim yapabilirsiniz:

• Analizler—Ortağın Webex Calling ilişkisinin olduğu tüm müşteri kuruluşlarına ait tüm çağrı kayıtlarını içerir. Bunlara şunlar dahildir:
  • Ortak, müşteri organizasyonunu Ortak Tam Yönetici rolüyle yönetir.
  • Müşteri kuruluşunun, ortak kuruluş içerisinde etkin bir Webex Calling aboneliği vardır.
• Faturalandırma—Ortak tarafından satılan ve sağlanan Webex Calling lisansına sahip kullanıcılar tarafından yapılan çağrıların çağrı kayıtlarını içerir. Bu beslemede Çalışma Alanlarına ait çağrı kayıtları yer almaktadır.

Erişim ve veri gizliliği

Faturalama 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), sahip ortak olur.
• Mülkiyet şu şekilde belirlenir: Kullanıcı kimliği > Lisans Kimliği > Abonelik Kimliği > Ortak Kimliği.
• Her CDR'ye tek bir ortağa erişilebilir.
• Bazı çağrı kayıtları bir faturalama ortağına eşlenmez 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 olmaz.

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

Bu API'lerden gelen kayıtlar 30 gün boyunca erişilebilir. Beklenen 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 mutabakatlandırmanızı öneririz.

Bu API'lere erişmek için bir ortak erişim belirteci kullanmanız gerekir. Standart Webex Developer erişim belirteci yönetim uygulamalarınagöre iş ortağı erişim belirtecinizi edinin ve yönetin.

Uzlaştırma API uç noktası

Mutabakat API uç noktası, belirtilen zaman dilimi içerisinde 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 depolamanızı doğrulamak ve belirli müşteriler için eksik veya tutarsız çağrı kayıtlarını belirlemek için kullanabilirsiniz.

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

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

API Parametreleri

Son 30 güne ait çağrı kayıtlarını almak için API'yi kullanabilirsiniz. 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). Şunları sağlayın:
  • Zamanı YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendirirsiniz. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati, geçerli UTC saatinden 30 günden eski olmamalıdır.
  • startTime ile endTime arasındaki pencere 12 saati aşamaz.
• endTime (gerekli, dize)—Toplamak istediğiniz kayıtların bitiş tarihi ve saati (UTC). Kayıtlar, çağrının bittiği zaman olan rapor zamanına göre yapılır. Şunları sağlayın:
  • Zamanı YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendirirsiniz. Örneğin, 2025-08-15T18:00:00.000Z.
  • Bitiş tarihi ve saati güncel UTC saatinden 5 dakika önce olmalı ve 30 günden eski olmamalıdır.
  • Bitiş tarihi ve saati startTimedeğerinden büyük olmalıdır.
  • startTime ile endTime arasındaki pencere 12 saati geçemez.

Uzlaştırma API uç noktası JSON yanıtının ö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 mevcut olup olmadığını gösterir. Tüm sayfalara sorgu gönderdiğinizden 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)
• geçerli sayfa: Geçerli sayfa numarası (örneğin, 1)

Örneğin, başlıklar şunu gösteriyorsa num-pages=2, total-orgs=283, Ve current-page=1, Toplam 283 kuruluş içeren iki sayfalık bir yanıtın ilk sayfasını görüntülüyorsunuz. Sonraki sayfaya erişmek için şunu ekleyin: page=2 GET isteğinize aşağıda gösterildiği 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ıt API uç noktası

Kayıtlar API uç noktası, Mutabakat API'si kullanılarak tutarsızlıkların veya eksik verilerin belirlendiği 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 biçime benzer şekilde, çağrı kayıtlarını JSON biçiminde döndürür. Döndürülen yük, Ayrıntılı Çağrı Geçmişi döndürülen yüküyle aynı alanları içerir. Alanlar ve değerleri hakkında daha fazla bilgi için Webex Calling Ayrıntılı Çağrı Geçmişi Raporu'nabakı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 olduğundan emin olmak için, tercih ettiğiniz zaman aralığından bir saat sonra API'ye sorgu göndermenizi ö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 (gerekli, dize)—Kayıtlarını almak istediğiniz kuruluşun kimliği. Kuruluş kimliklerini Mutabakat API'sinden alabilirsiniz.
• startTime (gerekli, dize)—Toplamak istediğiniz ilk kaydın başlangıç tarihi ve saati (UTC). Şunları sağlayın:
  • Zamanı YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendirirsiniz. Örneğin, 2025-08-15T06:00:00.000Z.
  • Başlangıç tarihi ve saati, geçerli UTC saatinden 30 günden eski olmamalıdır.
  • startTime ile 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, çağrının bittiği zaman olan rapor zamanına göre yapılır. Şunları sağlayın:
  • Zamanı YYYY-MM-DDTHH:MM:SS.mmmZolarak biçimlendirirsiniz. Ö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 startTimedeğerinden büyük olmalıdır.
  • startTime ile 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. Şunları sağlayın:
  • Aralık 500 ile 5000 arasındadır. Varsayılan değer 5000'dir. Örneğin, Max=1000.
  • API'nin belirtilen Maksimum değerden daha fazla kayıt döndürmesi gerekiyorsa, yanıt sayfalandırılır.
  • 500'ün altında bir değer belirtildiğinde otomatik olarak 500'e ayarlanır. 5000'in üzerinde bir değer girildiğinde 5000'e kadar düşürülür.

Sayfa Numaralandırma

API yanıtlarının sayfalandırılıp sayfalandırılmadığını belirlemek için yanıt başlıklarında bir Bağlantı başlığı olup olmadığını kontrol edin. Bağlantı başlığında next bağlantısı varsa, bunu çı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 sayfalar için API istekleri hemen yapılabilir, ancak her token kapsamı için dakikada en fazla 10 sayfalı istekle sınırlandırılmalıdır.

Örneğin, ilk API isteği şuysa:

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ığı şu şekildedir:

; rel="next"

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

Ortak reports/templates API

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

Ortaklar ayrıca doğrudan Partner Hub'dan birden fazla rapora erişebilir ve bunları indirebilir. Daha fazla bilgi için Partner Hub raporlarınabakın.