Общ преглед

Уеб обратното повикване с подробни записи на повиквания ви позволява да имате по-голяма видимост на дейността на 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, продаден от партньора. Записите за повиквания за работни области са включени в тази емисия.

Настройване на URL адрес за обратно повикване webhook

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

1

Влезте в Partner Hub.

2

Отидете на Настройки на организацията > Записи на данни за повикванията.

3

Въведете URL адрес, който да се използва под Уеб обратно повикване.

4

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

5

Изберете един от следните типове ресурси , които да използвате за уеб обратното повикване:

  • Анализ – включва всички записи на повиквания за всички клиентски организации, с които партньорът има връзка с Webex Calling.
  • Фактуриране – включва само записи на повиквания, на които партньорът е продал лицензи за Webex Calling. Тази емисия включва записи на повиквания за работни области.
Настройка на подробни записи на повикване в Partner Hub

Крайни точки на API

Предоставяме две крайни точки на 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 (низ) – Час на първия отчет, който искате да съберете. Часът на отчета посочва времето за завършване на повикването.

    Трябва да форматирате часа като ГГГГ-MM-DDTHH:MM:SS.mmmZ.

  • endTime (низ) – Час на последния отчет, който искате да съберете. Часът на отчета посочва времето за завършване на повикването.

    Посоченото време трябва да е по-късно от startTime , но не по-късно от 48 часа, и трябва да форматирате часа като ГГГГ-MM-DDTHH:MM:SS.mmmZ.

Ето пример как изглежда полезният обем за връщане на крайна точка JSON на API за съгласуване:

{ "cdr_counts": [{ "orgId": \„zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyy\“, \„count\“: 3009 }, { "orgId": "yyyyyy-yyyy-zzzz-xxxx-yyyyyyy", "count": 129 }, { "orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyy", "count": 278 } ] }

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

 num-pages = 2 total-orgs = 283 current-page = 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 часа, като трябва да го форматирате като ГГГГ-MM-DDTHH:MM:SS.mmmZ.

  • endTime (низ) – Час на последния отчет, който искате да съберете. Часът на отчета посочва времето за завършване на повикването.

    Посоченото време трябва да е по-късно от startTime , но не по-късно от 48 часа, и трябва да форматирате часа като ГГГГ-MM-DDTHH:MM:SS.mmmZ.