Вебсигнальник докладних записів викликів дає змогу підвищити видимість активності клієнтів у Webex Calling для різних цілей: від виставлення рахунків до створення звітів, які налаштовуються користувачами. Можна використовувати цей вебсигнальник, щоб збирати записи зручно для всіх клієнтів, не запитуючи записи для кожного клієнта по черзі. Цей вебсигнальник дозволяє розробляти користувацькі звіти та аналітичні програми як для внутрішніх бізнес-цілей, так і для надання клієнтам послуг з доданою вартістю. Ознайомлення з вебсигнальником і його супутніми API можна переглянути в цьому vidcast.

Вебсигнальник надає записи кожні 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 є кінцевою точкою API узгодження та кінцевою точкою API записів.

Записи доступні з цих API протягом 48 годин. Ми рекомендуємо періодично узгоджувати сховища записів, наприклад раз на 12 або 24 години, щоб усі записи отримувалися як очікувалося. Для використання цього API потрібен маркер доступу партнера. Маркер доступу партнера можна отримати й керувати ним відповідно до стандартних принципів керування маркерами доступу розробника Webex.

Кінцевий пристрій 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 узгодження може бути викликано максимум тривалістю 1 годину з параметрами startTime і endTime з інтервалом не більше 60 хвилин. API можна використовувати протягом будь-якої години з 5 хвилин до 48 годин тому, але для керування завантаженням служби одночасно можна здійснити виклик лише 1 годину.

Доступні параметри:

• startTime (рядок) — час першого звіту, який потрібно зібрати. Час звіту визначає час завершення виклику.

  Потрібно відформатувати час як РРРР-ММ-ДДТГ:ХХ:СС.мммЗ.

• endTime (рядок) — час останнього звіту, який потрібно зібрати. Час звіту визначає час завершення виклику.

  Вказаний час має бути пізніше за startTime , але не пізніше ніж 48 годин. Час потрібно відформатувати як РРРР-ММ-ДДТГ:ХХ:СС.мммЗ.

Ось приклад того, як виглядає корисне навантаження на повернення JSON кінцевого пристрою Reconciliation API:

{ "cdr_counts": [ { "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyy", "count": 3009 }, { "orgId": "рррр-ррр-ррр-ррр-ррр-ррр-ррр", "кількість": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyyyy", "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 годин тому. Його необхідно відформатувати як РРРР-ММ-ДДТГ:ХХ:СС.мммЗ.

• endTime (рядок) — час останнього звіту, який потрібно зібрати. Час звіту визначає час завершення виклику.

  Вказаний час має бути пізніше за startTime , але не пізніше ніж 48 годин. Час потрібно відформатувати як РРРР-ММ-ДДТГ:ХХ:СС.мммЗ.