הוובהוק של רשומות השיחות המפורטות מאפשר לך לראות טוב יותר את הפעילות של Webex Calling ללקוחות שלך למטרות שונות, החל מחיוב ועד לדיווח מותאם אישית. באפשרותך להשתמש בוובהוק זה כדי לאסוף רשומות בנוחות עבור כל הלקוחות שלך מבלי לבצע שאילתה רשומות עבור כל לקוח אחד אחד. וובהוק זה מאפשר לך לפתח דיווח מותאם אישית ויישומים אנליטיים למטרות עסקיות פנימיות או למתן שירותי ערך מוסף ללקוחות. עבור הקדמה לוובהוק וממשקי ה-API הנלווים שלו, אתה יכול לצפות בשידור וידאו זה.

הוובהוק מספק רשומות כל 5 דקות. כל מנה של וובהוק מכילה רשומות עבור שיחות שהסתיימו לפני 10 עד 5 דקות. לדוגמה, תוכן מנה שהתקבל בשעה 17:00 כולל שיחות שהסתיימו בין 16:50 ל-16:55. שיחות שהסתיימו בין 16:55 ל-17:00 יהיו בעומס של 17:05.

רשומות Webex Calling מועברות באמצעות אותו פורמט של ממשקי ה-API הקיימים של רשומות שיחה מפורטות. באפשרותך להגדיר וובהוק ולבחור בין שני סוגי הזנה:

• ניתוח נתונים—כולל את כל רשומות השיחות עבור כל ארגוני הלקוחות שאיתם יש לשותף מערכת Webex Calling. זה כולל ארגונים שעבורם:
  • השותף מנהל את ארגון הלקוח עם תפקיד מנהל מערכת מלא של שותף.
  • לארגון הלקוח יש מינוי פעיל של Webex Calling בארגון השותף.
• חיוב – כולל רק רשומות שיחות עבור שיחות שבוצעו על-ידי משתמשים עם רישיון Webex Calling שנמכר על-ידי השותף. רשומות שיחות עבור סביבות עבודה כלולות בעדכון זה.

אנו מספקים שתי נקודות קצה של API יחד עם הוובהוק כדי לעזור בפיוס נתונים. נקודות קצה אלה מאפשרות לך "להתעדכן" או ליישב את מאגרי הנתונים שלך עם רשומות חסרות שלא התקבלו על-ידי מאזין הוובהוק. שני ממשקי ה-API האלה הם נקודת הקצ ה של Reconciliation API ונקודת הקצה של Records.

הרשומות זמינות ממשקי ה-API האלה במשך 48 שעות. אנו ממליצים ליישב בין חנויות תקליטים מעת לעת, כגון כל 12 או 24 שעות, כך שכל הרשומות יתקבלו כצפוי. אסימון גישה של שותף נדרש כדי להשתמש ב-API זה. באפשרותך להשיג אסימון גישה לשותף ולנהל אותו בהתאם לעקרונות הניהול הסטנדרטיים של Webex Developer.

נקודת קצה של API של פיוס

נקודת הקצה של ה-API של הפיוס מחזירה את מספר הרשומות שנוצרו על-ידי כל לקוח ומנוהלות על-ידי השותף בפרק הזמן שצוין. אם שותף מנהל יותר מ-200 ארגוני לקוחות, תוצאות מה-API יועברו זימון לקבלת יכולת קריאה טובה יותר. באפשרותך להשתמש בסכומים אלה כדי לבדוק כנגד האחסון המקומי שלך אם חסרים רשומות כלשהן עבור לקוחות ספציפיים. תוכל למצוא את כתובת ה-URL של נקודת הקצה של ה-API של פיוס כאן:

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

פרמטרים

ניתן לקרוא ל-API של הפיוס למשך זמן מרבי של שעה אחת בלבד, כאשר הפרמטרים startTime ו-endTime לא יותר מ-60 דקות בנפרד. ניתן להשתמש ב-API עבור כל תקופה של שעה אחת בין 5 דקות ל-48 שעות, אבל כדי לנהל את עומס השירות, ניתן להתקשר רק שעה אחת בכל פעם.

הפרמטרים הזמינים הם:

• startTime (מחרוזת) - שעת הדוח הראשון שברצונך לאסוף. שעת הדוח מציינת את זמן השלמת השיחה.

  עליך לעצב את השעה כ-YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (מחרוזת) - שעת הדוח האחרון שברצונך לאסוף. שעת הדוח מציינת את זמן השלמת השיחה.

  השעה שצוינה צריכה להיות מאוחרת יותר מ-startTime אך לא יאוחר מ-48 שעות, ועליך לעצב את השעה כ-YYYY-MM-DDTHH:MM:SS.mmmZ.

הנה דוגמה כיצד נראה מטען החזר של נקודת קצה של JSON נקודת קצה:

{ "cdr_counts": [{ "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyy", "count": 3009 }, { "orgId": "yyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyy", "count": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyy", "count": 278 } ] } 

הכותרות של תגובת ה-API מציגות את המספר הכולל של הארגונים שהוחזרו ואם יש דפים נוספים. בדוק את הפרמטרים הבאים כדי לוודא שכל הדפים מבוקשים.

 num-pages = 2 סה"כ ארגונים = 283 עמוד נוכחי = 1

הפרמטרים לעיל מראים כי הדף הנוכחי הוא הדף הראשון, שיש 2 עמודים בסך הכל, וכי התגובה כולה מכילה 283 ארגונים. קבל גישה לדף השני על-ידי הוספת הפרמטר page=2 לבקשת GET , כפי שמוצג להלן.

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

נקודת קצה של API של רשומות

נקודת הקצה של API זו מחזירה רשומות שיחה בפורמט JSON, זהות לפורמט כפי שמתואר ב-API המפורט של היסטוריית שיחות. המטען המוחזר מכיל שדות זהים למטען המוחזר של היסטוריית השיחות המפורט. תוכל למצוא פרטים נוספים על הערכים בכל שדה המוחזר כאן. נקודת הקצה של API של רשומות משמשת לאיתור רשומות חסרות עבור ארגונים שעבורם רשומות חסרים. תוכל למצוא את כתובת ה-URL של נקודת הקצה של ה-API של הרשומות כאן:

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

פרמטרים

• orgID—מזהה הארגון שעבורו ברצונך לשאול רשומות. ניתן לפתוח את המזהים האלה מנקודת הקצה של הפיוס הקודמת.

• startTime (מחרוזת) - שעת הדוח הראשון שברצונך לאסוף. שעת הדוח מציינת את זמן השלמת השיחה.

  השעה שצוינה חייבת להיות לפני 5 דקות עד לפני 48 שעות, ועליך לעצב את השעה כ-YYYY-MM-DDTHH:MM:SS.mmmZ.

• endTime (מחרוזת) - שעת הדוח האחרון שברצונך לאסוף. שעת הדוח מציינת את זמן השלמת השיחה.

  השעה שצוינה צריכה להיות מאוחרת יותר מ-startTime אך לא יאוחר מ-48 שעות, ועליך לעצב את השעה כ-YYYY-MM-DDTHH:MM:SS.mmmZ.