Webhook Podrobné záznamy hovorů umožňuje větší viditelnost aktivity služby Webex Calling pro zákazníky pro různé účely, od fakturace až po přizpůsobené sestavy. Tento webhook můžete použít k pohodlnému shromažďování záznamů pro všechny své zákazníky, aniž byste museli dotazovat záznamy pro každého zákazníka jeden po druhém. Tento webhook umožňuje vyvíjet vlastní reportingové a analytické aplikace jak pro interní obchodní účely, tak pro poskytování služeb s přidanou hodnotou zákazníkům. Chcete-li se seznámit s webhookem a jeho doprovodnými značkami API, podívejte se na tento vidcast.

Webhook poskytuje záznamy každých 5 minut. Každé datové zatížení webhooku obsahuje záznamy hovorů, které skončily před 10 až 5 minutami. Datová část přijatá v 17:00 například zahrnuje hovory, které končily v 16:50 až 16:55. Hovory končící mezi 16:55 a 17:00 budou v datové části 17:05.

Záznamy služby Webex Calling jsou dodávány ve stejném formátu jako stávající podrobné záznamy hovorů API. Můžete nastavit webhook a vybrat si mezi dvěma typy kanálů:

• Analýza – zahrnuje všechny záznamy hovorů pro všechny organizace zákazníků, se kterými má partner vztah se službou Webex Calling. Patří sem organizace, pro které:
  • Partner spravuje organizaci zákazníka s rolí úplného správce partnera.
  • Organizace zákazníka má v rámci partnerské organizace aktivní předplatné služby Webex Calling.
• Fakturace – zahrnuje pouze záznamy hovorů uskutečněné uživateli s licencí Webex Calling prodávanou partnerem. Záznamy hovorů pro pracovní prostory jsou zahrnuty do tohoto kanálu.

Poskytujeme dva koncové body rozhraní API spolu s webhookem, které vám pomohou se sladěním dat. Tyto koncové body umožňují „dohnat“ nebo sloučit vaše datové úložiště s chybějícími záznamy, které nebyly přijaty posluchačem webhooku. Tyto dva APIjsou koncový bod Reconciliation AP I a koncový bod Records API.

Záznamy jsou k dispozici z těchto APIpo dobu 48 hodin. Doporučujeme pravidelně slaďovat úložiště záznamů, například každých 12 nebo 24 hodin, aby byly všechny záznamy přijímány podle očekávání. K použití tohoto rozhraní API je nutný přístupový token partnera. Můžete získat přístupový token partnera a spravovat jej podle standardních zásad správy přístupového tokenu pro vývojáře Webex.

Koncový bod rozhraní API pro sloučení

Koncový bod API odsouhlasení vrací počet záznamů vygenerovaných každým zákazníkem, které jsou spravovány partnerem v zadaném časovém období. Pokud partner spravuje více než 200 zákaznických organizací, výsledky z rozhraní API budou pro lepší čitelnost stránkovány. Tyto součty můžete použít ke kontrole v místním úložišti, zda u konkrétních zákazníků chybí nějaké záznamy. Adresu URL koncového bodu rozhraní API pro sloučení naleznete zde:

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

Parametry

Rozhraní API odsouhlasení lze volat pouze po dobu maximálně 1 hodiny, přičemž parametry startTime a endTime jsou od sebe vzdáleny maximálně 60 minut. Rozhraní API lze používat pro libovolné 1hodinové období mezi 5 minutami a 48 hodinami, ale pro správu zatížení služby lze volat vždy pouze 1 hodinu.

Dostupné parametry jsou:

• Čas (řetězec) – čas první sestavy, kterou chcete shromáždit. Čas sestavy určuje čas dokončení hovoru.

  Čas musíte formátovat jako RRRR-MM-DDTHH:MM:SS.mmmZ.

• endtime (řetězec) – čas poslední sestavy, kterou chcete shromáždit. Čas sestavy určuje čas dokončení hovoru.

  Zadaný čas by měl být pozdější než startTime , ale nejpozději 48 hodin. Čas musíte formátovat ve formátu RRRR-MM-DDTHH:MM:SS.mmmZ.

Zde je příklad toho, jak vypadá payload návratové zatížení JSON koncového bodu API odsouhlasení:

{ "cdr_counts": [ { "orgId": "zzzzzzzz-rrrr-zzzz-xxxx-rrrr-rrrr", "počet": 3009 }, { "orgId": "rrrr-rrrr-rrrr-zzzz-xxxx-rrrr-rrrr-rrrr", "počet": 129 }, { "orgId": "xxxxxxxx-rrrr-zzzz-xxxx-rrrr-rrrr", "počet": 278 } ] } 

Záhlaví odpovědi rozhraní API indikují celkový počet vrácených organizací a zda jsou k dispozici další stránky. Zkontrolujte následující parametry a ujistěte se, že byly všechny stránky dotaženy.

 počet stránek = 2 total-orgs = 283 current-page = 1

Výše uvedené parametry ukazují, že aktuální stránka je první stránka, že jsou zde celkem 2 stránky a že celá odpověď obsahuje 283 organizací. Na druhou stránku otevřete přidáním parametru page=2 do požadavku GET , jak je ukázáno níže.

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

Koncový bod rozhraní API záznamů

Tento koncový bod rozhraní API vrací záznamy hovorů ve formátu JSON, který je totožný s formátem popsaným v rozhraní API podrobné historie hovorů. Vrácená datová část obsahuje stejná pole jako vrácená datová část Podrobná historie hovorů. Více informací o hodnotách v každém vráceném poli naleznete zde. Koncový bod rozhraní API záznamů se používá k dotazování chybějících záznamů organizací, pro které chybí záznamy. Adresu URL koncového bodu rozhraní API záznamů naleznete zde:

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

Parametry

• orgid – ID organizace, pro které chcete získat dotazy na záznamy. Tyto identifikátory můžete otevřít z předchozího koncového bodu sloučení.

• Čas (řetězec) – čas první sestavy, kterou chcete shromáždit. Čas sestavy určuje čas dokončení hovoru.

  Zadaný čas musí být mezi 5 minutami a 48 hodinami a čas musíte formátovat ve formátu RRRR-MM-DDTHH:MM:SS.mmmZ.

• endtime (řetězec) – čas poslední sestavy, kterou chcete shromáždit. Čas sestavy určuje čas dokončení hovoru.

  Zadaný čas by měl být pozdější než startTime , ale nejpozději 48 hodin. Čas musíte formátovat ve formátu RRRR-MM-DDTHH:MM:SS.mmmZ.