Ayrıntılı Çağrı Kayıtları web kancası, faturalandırmadan kişiye özel raporlamaya kadar çeşitli amaçlar için müşterilerinizin Webex Calling etkinliğini daha geniş bir şekilde görebilmenizi sağlar. Bu web kancasını, her bir müşteri için tek tek kayıtları sorgulamak zorunda kalmadan tüm müşterileriniz için kayıtları kolayca toplamak üzere kullanabilirsiniz. Bu web kancası, hem dahili iş amaçları hem de müşterilere katma değerli hizmetler sağlanması için özel raporlama ve analitik uygulamalar geliştirmenize olanak tanır. Web kancasına ve eşlik eden API'lerine giriş için bu video yayınını izleyebilirsiniz.

Web kancası, kayıtları 5 dakikada bir teslim eder. Her web kancası yükü, 10 ila 5 dakika önce sona eren çağrıların kayıtlarını içerir. Örneğin, saat 17:00'de alınan bir yük, 16:50 ile 16:55 arasında sonlanan çağrıları içerir. 16:55 ile 17:00 arasında biten çağrılar, 17:05 yük içinde olacaktır.

Webex Calling kayıtları, mevcut Ayrıntılı Çağrı Kayıtları API'leriyle aynı biçimde teslim edilir. Bir web kancası ayarlayabilir ve iki tür özet akışı arasından seçim yapabilirsiniz:

• Analizler—Iş ortağının Webex Calling ilişkisinin olduğu tüm müşteri kuruluşları için tüm çağrı kayıtlarını içerir. Buna şunlar için kuruluşlar dahildir:
  • Iş ortağı, müşteri kuruluşunu Iş Ortağı Tam Yöneticisi rolüyle yönetir.
  • Müşteri kuruluşunun, iş ortağı kuruluşu içinde etkin bir Webex Calling aboneliği vardır.
• Faturalandırma: Yalnızca iş ortağı tarafından satılan Webex Calling lisansına sahip kullanıcılar tarafından yapılan çağrılar için çağrı kayıtlarını içerir. Çalışma Alanları için çağrı kayıtları bu özet akışına dahildir.

Veri uzlaşmasına yardımcı olmak için web kancasıyla birlikte iki API uç noktası sağlıyoruz. Bu uç noktalar, veri depolarınızı web kancası dinleyicisi tarafından alınmayan eksik kayıtlarla "arayı kapatmanıza" veya aramanıza olanak tanır. Bu iki API, Reconciliation API uç noktas ı ve Records API uç noktasıdır.

Bu API'lerden 48 saat boyunca kayıtlar edinilebilir. Tüm kayıtların beklendiği gibi alınması için kayıt depolarını 12 veya 24 saatte bir gibi düzenli olarak tekrar bağlamanızı öneririz. Bu API'yi kullanmak için bir iş ortağı erişim belirteci gereklidir. Iş ortağı erişim belirteci alabilir ve bunu standart Webex Geliştirici erişim belirteci yönetim ilkelerine göre yönetebilirsiniz.

Uzlaşma API uç noktası

Mutabakat API uç noktası, belirtilen zaman diliminde iş ortağı tarafından yönetilen her bir müşteri tarafından oluşturulan kayıt sayısını döndürür. Bir iş ortağı 200’den fazla müşteri kuruluşunu yönetiyorsa API’den elde edilen sonuçlar daha iyi okunabilirlik için sayfalara ayrılmıştır. Belirli müşteriler için herhangi bir kayıt yoksa yerel depolama alanınızı kontrol etmek için bu toplamları kullanabilirsiniz. Uzlaşma API uç noktası URL'sini şuradan bulabilirsiniz:

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

Parametreler

Mutabakat API’si yalnızca en fazla 1 saat için çağrılabilir ve startTime ve endTime parametreleri 60 dakikadan fazla olamaz. API, 5 dakika ile 48 saat önce arasındaki herhangi bir 1 saatlik süre için kullanılabilir, ancak hizmet yükünü yönetmek için bir defada yalnızca 1 saat aranabilir.

Mevcut parametreler şunlardır:

• startTime (dize)—Toplamak istediğiniz ilk raporun saati. Rapor saati, çağrının tamamlanma süresini belirtir.

  Saati YYYY-AA-DDTHH:MM:SS.mmmZ olarak biçimlendirmelisiniz.

• endTime (dize)—Toplamak istediğiniz son raporun saati. Rapor saati, çağrının tamamlanma süresini belirtir.

  Belirtilen saat, startTime 'dan sonra olmalı ancak 48 saatten daha geç olmamalıdır ve saati YYYY-AA-DDTHH:MM:SS.mmmZ olarak biçimlendirmelisiniz.

Işte bir Mutabakat API uç noktası JSON dönüş yükünün neye benzediğine dair bir örnek:

{ "cdr_counts": [ { "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyyy", "count": 3009 }, { "orgId": "yyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyyy", "count": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyyyy", "count": 278 } ] } 

API yanıtının üstbilgileri, döndürülen kuruluşların toplam sayısını ve ek sayfalar olup olmadığını belirtir. Tüm sayfaların sorgulandığından emin olmak için aşağıdaki parametreleri kontrol edin.

 sayfa sayısı = 2 toplam kuruluş = 283 güncel sayfa = 1

Yukarıdaki parametreler, mevcut sayfanın ilk sayfa olduğunu, toplam 2 sayfa olduğunu ve tüm yanıtın 283 kuruluş içerdiğini gösterir. Aşağıda gösterildiği gibi GET isteğine page=2 parametresini ekleyerek ikinci sayfaya erişin.

https://analytics.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ı kaydeder

Bu API uç noktası, çağrı kayıtlarını Ayrıntılı Çağrı Geçmişi API'sinde açıklanan biçimle aynı şekilde 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 ile aynı alanları içerir. Burada döndürülen her alanda değerler hakkında daha fazla detay bulabilirsiniz. Kayıtlar API uç noktası, kayıtların eksik olduğu kuruluşlar için eksik kayıtları sorgulamak için kullanılır. Kayıt API uç noktası URL'sini burada bulabilirsiniz:

https://analytics.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

Parametreler

• orgID—Kayıtları sorgulamak istediğiniz kuruluş kimliği. Bu tanımlayıcıları önceki mutabakat uç noktasından açabilirsiniz.

• startTime (dize)—Toplamak istediğiniz ilk raporun saati. Rapor saati, çağrının tamamlanma süresini belirtir.

  Belirtilen saat, 5 dakika ile 48 saat önce olmalıdır ve saati YYYY-AA-DDTHH:MM:SS.mmmZ olarak biçimlendirmelisiniz.

• endTime (dize)—Toplamak istediğiniz son raporun saati. Rapor saati, çağrının tamamlanma süresini belirtir.

  Belirtilen saat, startTime 'dan sonra olmalı ancak 48 saatten daha geç olmamalıdır ve saati YYYY-AA-DDTHH:MM:SS.mmmZ olarak biçimlendirmelisiniz.