Веб-перехватчик с подробными записями вызовов позволяет лучше просматривать действия 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 являются конечной точкой 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 можно использовать в течение любого 1 часа от 5 минут до 48 часов назад, но для управления загрузкой службы одновременно можно вызвать только 1 час.

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

• startTime (строка) — время первого отчета, который необходимо собрать. Время отчета указывает время завершения вызова.

  Необходимо отформатировать время как ГГГГ-ММ-ДДTHH:MM:SS.mmmZ.

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

  Указанное время должно быть позже startTime , но не позднее 48 часов. Необходимо отформатировать время как ГГГГ-ММ-ДДTHH:MM:SS.mmmZ.

Ниже приведен пример того, как выглядит полезная нагрузка для возврата конечной точки JSON API сверки:

{ "cdr_counts": [{ "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 3009 }, { "orgId": "yyyyyyy-yyyy-zzzz-xxxx-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 129 }, { "orgId": "xxxxxxxx-yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy 278 } ] } 

В заголовках ответа API указано общее количество возвращенных организаций и наличие дополнительных страниц. Проверьте следующие параметры, чтобы убедиться в том, что запрошены все страницы.

 количество страниц = 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 часов назад, а также необходимо отформатировать время как ГГГГ-ММ-ДДTHH:MM:SS.mmmZ.

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

  Указанное время должно быть позже startTime , но не позднее 48 часов. Необходимо отформатировать время как ГГГГ-ММ-ДДTHH:MM:SS.mmmZ.