Уеб куката за подробни записи на обаждания предлага сигурно, мащабируемо и надеждно решение, управлявано от събития, а не от заявки. Този уеб кукичка осигурява по-голяма видимост върху дейностите на вашите клиенти в Webex Calling, поддържайки случаи на употреба от фактуриране до персонализирано отчитане.

Можете да използвате този уеб кукичка, за да събирате удобно записи за всички клиенти, управлявани чрез Partner Hub, без да задавате въпроси към всеки клиент поотделно. Този уеб кукичка ви позволява да разработвате персонализирани приложения за отчитане, фактуриране и анализ, както за вътрешни бизнес изисквания, така и за услуги с добавена стойност.

За въведение в уебхука и съпътстващите го API, гледайте този Vidcast: API за подробна история на обажданията на партньора по обаждания на Webex.

Какво предоставя уеб кукичката на партньора

Уеб куката предоставя подробни записи за историята на обажданията на всеки 5 минути. Всеки полезен ресурс на уебкуката съдържа:

• Записи на обаждания, които са приключили между 10 и 5 минути преди текущото време.
• Всички закъснели записи, обработени от облака Webex Calling.
• Автоматично попълва записите за закъснели повиквания в следващите полезни товари на webhook, за да осигури надеждна доставка.

За да покажете как записите за обаждания са включени във всеки полезен товар, разгледайте следния пример:

• Полезен товар, получен в 14:05 съдържа обаждания, завършили между 13:55 и 14:00.
• Разговори, завършващи между 14:00 и 14:05 са включени в 14:10 полезен товар.
• Записи, завършени по-рано (например разговор, който е приключил в 14:04) но обработени късно от Webex Calling cloud (например в 14:11) са включени в следващия планиран полезен товар (например, 14:15).

Уеб кукичка в Parter Hub

Като предоставите уеб кукичка, вие позволявате на платформата за анализи да изпраща записи на обаждания към вашия URL адрес за обратно извикване, когато бъдат генерирани.

Записите за обаждания на Webex се предоставят в същия формат като съществуващите подробни API за записи на обаждания. Можете да настроите уеб кукичка и да избирате между два вида фийд:

• Анализ – Включва всички записи на обаждания за всички организации на клиенти, с които партньорът има връзка чрез Webex Calling. Това включва организации, където:
  • Партньорът управлява организацията на клиента с ролята на пълен администратор на партньор.
  • Организацията клиент има активен абонамент за Webex Calling в рамките на организацията партньор.
• Фактуриране – Включва записи на обаждания, направени от потребители с лиценз за Webex Calling, продаден и предоставен от партньора. Записите на обажданията за работни пространства са включени в този фийд.

Достъп и поверителност на данните

Само собственикът на услугата има достъп до данните за обажданията (CDR) за целите на фактурирането.

• Партньор (или подпартньор), който управлява лиценза, свързан със записа на обаждането, става собственик на лиценза.
• Собствеността се определя от: Потребителски идентификатор > Идентификационен номер на лиценза > Идентификационен номер на абонамента > Идентификационен номер на партньор.
• Всеки CDR е достъпен само за един партньор.
• Някои записи на обаждания не се свързват с партньор за фактуриране и не всички партньори, свързани с организацията, получават равен достъп до всички записи, тъй като тези записи може да съдържат лична информация (PII).

В допълнение към уебхука, Webex Calling предоставя крайни точки на API за поддръжка на съгласуване на данни. Тези крайни точки ви позволяват да наваксате или да съгласувате вашите хранилища за данни с липсващи записи, които вашият слушател на уеб куки може да не е получил. Двете крайни точки на API са API за съгласуване и API за записи.

Записите от тези API са достъпни за 30 дни. За да сте сигурни, че ще получите всички очаквани записи, препоръчваме периодично да сверявате данните в хранилищата си за записи, например на всеки 12 или 24 часа.

Трябва да използвате партньорски токен за достъп, за да получите достъп до тези API. Получете и управлявайте вашия партньорски токен за достъп съгласно стандартните практики за управление на токени за достъп за разработчици на Webex.

Крайна точка на API за съгласуване

Крайната точка на API за съгласуване връща общия брой генерирани записи на обаждания за всеки клиент, управляван от партньора, в рамките на посочения период от време. Можете да използвате тези общи суми, за да проверите локалното си хранилище и да идентифицирате липсващи или несъответстващи записи на обаждания за конкретни клиенти.

Ако управлявате повече от 200 клиентски организации, API страницира резултатите, за да подобри четимостта.

URL адресът на крайната точка на API за съгласуване използва следния формат:

Параметри на API

Можете да използвате API, за да извлечете записи на обаждания от последните 30 дни. Избраният от вас времеви прозорец трябва да започва поне 5 минути преди текущото UTC време и не може да надвишава 12 часа между началния и крайния час в едно API извикване.

Параметрите на API са:

• startTime (задължително, низ) – Началната дата и час (UTC) за първия запис, който искате да съберете. Уверете се, че:
  • Форматирате времето като YYYY-MM-DDTHH:MM:SS.mmmZ. Например, 2025-08-15T06:00:00.000Z.
  • Началната дата и час не трябва да са по-стари от 30 дни от текущото UTC време.
  • Прозорецът между startTime и endTime не може да надвишава 12 часа.
• endTime (задължително, низ) – Крайната дата и час (UTC) за записите, които искате да съберете. Записите се базират на времето на докладване, което е времето, когато е приключено обаждането. Уверете се, че:
  • Форматирате времето като YYYY-MM-DDTHH:MM:SS.mmmZ. Например, 2025-08-15T18:00:00.000Z.
  • Крайната дата и час трябва да са 5 минути преди текущото UTC време и не по-стари от 30 дни.
  • Крайната дата и час трябва да са по-големи от startTime.
  • Интервалът между startTime и endTime не може да надвишава 12 часа.

Пример за JSON отговор на крайна точка на Reconciliation API:

          {
          "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 показват общия брой върнати организации и дали са налични допълнителни страници. Проверете следните параметри на заглавката, за да се уверите, че сте направили заявка за всички страници:

• брой страници: Общ брой страници (например 2)
• общо организации: Общ брой организации, включени в отговора (например 283)
• текуща страница: Номерът на текущата страница (например 1)

Например, ако заглавките показват num-pages=2, total-orgs=283, и current-page=1, Преглеждате първата страница от двустраничен отговор, съдържащ общо 283 организации. За да получите достъп до следващата страница, добавете page=2 параметър към вашата GET заявка, както е показано по-долу:

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

Крайна точка на API за записи

Крайната точка на Records API се използва за заявки за липсващи записи на обаждания за конкретни организации, където са били идентифицирани несъответствия или липсващи данни с помощта на Reconciliation API.

API за записи връща записи на повиквания във формат JSON, идентичен с формата, описан в Подробна история на повикванията API. Върнатият полезен товар съдържа идентични полета с върнатия полезен товар „Подробна история на повикванията“. За повече информация относно полетата и техните стойности вижте Подробен отчет за историята на обажданията на Webex.

API предоставя записи на обаждания, които са приключили 5 минути преди текущото време. За да сте сигурни, че всички записи на обажданията са налични, препоръчваме да направите заявка към API един час след предпочитания от вас времеви прозорец.

URL адресът на крайната точка на Records API използва следния формат:

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

• OrgID (задължително, низ) – Идентификаторът на организацията, за която искате да извлечете записи. Можете да получите идентификационни номера на организации от API за съгласуване.
• startTime (задължително, низ) – Началната дата и час (UTC) за първия запис, който искате да съберете. Уверете се, че:
  • Форматирате времето като YYYY-MM-DDTHH:MM:SS.mmmZ. Например, 2025-08-15T06:00:00.000Z.
  • Началната дата и час не трябва да са по-стари от 30 дни от текущото UTC време.
  • Интервалът между startTime и endTime не трябва да надвишава 12 часа в една API заявка.
• endTime (задължително, низ) – Крайната дата и час (UTC) за последния запис, който искате да съберете. Записите се базират на времето на докладване, което е времето, когато е приключено обаждането. Уверете се, че:
  • Форматирате времето като YYYY-MM-DDTHH:MM:SS.mmmZ. Например, 2025-08-15T18:00:00.000Z.
  • Крайната дата и час трябва да са поне 5 минути преди текущото UTC време и не по-стари от 30 дни.
  • Крайната дата и час трябва да са по-големи от startTime.
  • Интервалът между startTime и endTime не трябва да надвишава 12 часа в една API заявка.
• Макс. (по избор, число) – Ограничава максималния брой записи на страница в отговора. Уверете се, че:
  • Диапазонът е от 500 до 5000. Стойността по подразбиране е 5000. Например, Max=1000.
  • Ако API има повече записи за връщане от зададената максимална стойност, тогава отговорът се номерира на страници.
  • Ако е зададена стойност под 500, тя автоматично се коригира до 500. Ако е зададена стойност над 5000, тя се намалява до 5000.

Страниране

За да определите дали отговорите на API са номерирани, проверете заглавките на отговорите за заглавка на връзка. Ако в заглавката на връзката има връзка next, извлечете я и използвайте стойността startTimeForNextFetch, за да заявите следващия набор от записи. Ако няма следваща връзка, тогава се събират всички отчети за избрания период от време.

API заявките за следващи страници могат да се правят незабавно, но скоростта трябва да бъде ограничена до максимум 10 странирани заявки в минута, за обхват на токен.

Например, ако първоначалната API заявка е:

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

тогава заглавката на връзката в отговора е:

; rel="next"

Други възможни стойности на връзките включват rel="first" и rel="prev" съответно за първата и предишната страница.

Партньор reports/templates API

Можете да генерирате и изтегляте отчети, налични в Partner Hub, като използвате API за партньорски отчети. За повече информация вижте партньора report/templates.

Партньорите могат също така да имат достъп и да изтеглят множество отчети директно от Partner Hub. За повече информация вижте доклади на Partner Hub.