- Start
- /
- Artikel
Detaljerad webbhook för samtalsposter för Webex Calling i partnerhubben
Du kan konfigurera en webhook för att samla in Webex Calling-poster för alla dina kunder för faktureringsavstämning, analys eller rapportering.
Översikt
Med webhook för detaljerade samtalsposter kan du ha större synlighet i dina kunders Webex Calling-aktivitet för olika ändamål, från fakturering till anpassad rapportering. Du kan använda den här webhook för att samla in poster bekvämt för alla dina kunder utan att behöva fråga poster för varje kund en efter en. Med den här webhook kan du utveckla anpassade rapporterings- och analytiska program för både interna affärssyften eller tillhandahållande av mervärdestjänster till kunder. För en introduktion till webhook och dess åtföljande API:er kan du titta på detta vittcast.
Webhook levererar poster var 5:e minut. Varje webhook-nyttolast innehåller poster för samtal som avslutades för 10 till 5 minuter sedan. En nyttolast som tas emot klockan 17:00 inkluderar till exempel samtal som avslutades mellan 16:50 och 16:55. Samtal som avslutas mellan 16:55 och 17:00 kommer att vara i nyttolast 17:05.
Webex Calling-poster levereras med samma format som befintliga API:er för detaljerade samtalsposter. Du kan konfigurera en webhook och välja mellan två typer av feed:
- Analys – Inkluderar alla samtalsposter för alla kundorganisationer som partnern har en Webex Calling-relation med. Detta inkluderar organisationer för vilka:
- Partnern hanterar kundorganisationen med rollen fullständig partneradministratör.
- Kundorganisationen har en aktiv Webex Calling-prenumeration inom partnerorganisationen.
- Fakturering – inkluderar endast samtalsposter för samtal som görs av användare med en Webex Calling-licens som säljs av partnern. Samtalsposter för arbetsytor ingår i den här feeden.
Konfigurera en webhook-URL för återringning
Konfigurera webhook i partnerhubben. Du kan bara konfigurera en webhook per partnerorganisation. Du måste vara en fullständig administratör för att konfigurera en webhook.
1 |
Logga in på Partner Hub. |
2 |
Gå till . |
3 |
Ange en URL som ska användas under Webhook. |
4 |
Om du vill autentisera dina webhook-lönebelastningar med en hemlig token kan du lägga till en. Du hittar mer information om Webex-webbkrokar och hemliga tokens här. |
5 |
Välj en av följande resursty p som du vill använda för webbhook:
![]() |
API-slutpunkter
Vi tillhandahåller två API-slutpunkter tillsammans med webbhook för att hjälpa till med datamatchning. Med dessa slutpunkter kan du ”komma ikapp” eller synkronisera dina datalager med poster som saknas och som inte tas emot av webhook-lyssnaren. Dessa två API:er är Reconciliation API-slutpunkte n och Records API-slutpunkten.
Poster är tillgängliga från dessa API:er i 48 timmar. Vi rekommenderar att du regelbundet avstäms inspelningsbutiker, t.ex. var 12:e eller 24:e timme, så att alla inspelningar tas emot som förväntat. En token för partneråtkomst krävs för att använda detta API. Du kan hämta en token för partneråtkomst och hantera den enligt standard principer för hantering av åtkomsttoken för Webex Developer.
Försoning API-slutpunkt
Avstämnings-API-slutpunkten returnerar antalet poster som genererats av varje kund som hanteras av partnern under den angivna tidsperioden. Om en partner hanterar fler än 200 kundorganisationer kommer resultaten från API att pagineras för bättre läsbarhet. Du kan använda dessa summor för att kontrollera mot ditt lokala lagringsutrymme om det saknas poster för specifika kunder. Du hittar URL:en för försoning API-slutpunkt här:
https://analytics.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z
Parametrar
Avstämnings-API kan endast anropas under högst en timme, med parametrarna startTime
och sluttid
med högst 60 minuters mellanrum. API:et kan användas för valfri 1-timmarsperiod mellan 5 minuter och 48 timmar sedan, men för att hantera tjänstens belastning kan endast 1 timme i taget ringas upp.
Tillgängliga parametrar är:
- starttid (sträng) – Tid för den första rapporten som du vill samla in. Rapporttiden anger samtalets sluttid.
Du måste formatera tiden som
ÅÅÅÅ-MM-DDTHH:MM:SS.mmmZ
. - slutningstid (sträng) – Tid för den senaste rapporten som du vill samla in. Rapporttiden anger samtalets sluttid.
Den angivna tiden ska vara senare än
starttid
, men inte senare än 48 timmar, och du måste formatera tiden somÅÅÅÅ-MM-DDTHH:MM:SS.mmmZ
.
Här är ett exempel på hur en JSON-returnyttolast för avstämnings-API-slutpunkt ser ut:
{ "cdr_counts": [{ "orgId": "zzzzzzzz-yyyy-zzzz-xxxx-yyyyyyyy", "count": 3009 }, {"orgId": "yyyyyy-yyyy-zzzz-xxxx-yyyyyyyy", "count": 129 }, {"orgId": "xxxxxxxx-yyyy-zzzz-xxxx-yyyyyyyy", "count": 278 } ] }
Rubrikerna i API-svaret anger det totala antalet organisationer som returnerats och om det finns extra sidor. Kontrollera följande parametrar för att se till att alla sidor har frågats.
num-sidor = 2 totalt-organisationer = 283 aktuell-sida = 1
Ovanstående parametrar visar att den aktuella sidan är den första sidan, att det finns totalt 2 sidor och att hela svaret innehåller 283 organisationer. Öppna den andra sidan genom att lägga till parametern sida=2
i GET
-begäran, som visas nedan.
https://analytics.webexapis.com/v1/partners/cdrcountbyorg?endTime=YYYY-MM-DDTHH:MM:SS.000Z&startTime=YYYY-MM-DDTHH:MM:SS.000Z&page=2
Spelar in API-slutpunkt
Denna API-slutpunkt returnerar samtalsposter i JSON-format, identiskt med formatet enligt beskrivningen i API:et för detaljerad samtalshistorik. Den returnerade nyttobelastningen innehåller identiska fält för den återsända nyttobelastningen i detaljerad samtalshistorik. Du hittar mer information om värdena i varje fält som returneras här. Poster-API-slutpunkten används för att fråga saknade poster för organisationer som poster saknas. Du hittar URL:en för poster API-slutpunkt här:
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
Parametrar
-
org-ID – Det organisations-ID som du vill fråga poster för. Du kan öppna dessa identifierare från föregående avstämningsslutpunkt.
-
starttid (sträng) – Tid för den första rapporten som du vill samla in. Rapporttiden anger samtalets sluttid.
Den angivna tiden måste vara mellan 5 minuter och 48 timmar sedan och du måste formatera tiden som
ÅÅÅÅ-MM-DDTHH:MM:SS.mmmZ
. -
slutningstid (sträng) – Tid för den senaste rapporten som du vill samla in. Rapporttiden anger samtalets sluttid.
Den angivna tiden ska vara senare än
starttid
, men inte senare än 48 timmar, och du måste formatera tiden somÅÅÅÅ-MM-DDTHH:MM:SS.mmmZ
.