Webhook-ul Detailed Call Records vă permite să aveți o vizibilitate mai mare în activitatea Webex Calling a clienților dvs. în diverse scopuri, de la facturare la raportarea personalizată. Puteți utiliza acest cârlig web pentru a colecta înregistrări în mod convenabil pentru toți clienții dvs., fără a fi nevoie să solicitați înregistrări pentru fiecare client unul câte unul. Acest webhook vă permite să dezvoltați aplicații personalizate de raportare și analiză atât în scopuri de afaceri interne, cât și pentru furnizarea de servicii cu valoare adăugată clienților. Pentru o introducere la webhook-ul și API-urile sale de însoțire, puteți viziona acest vidcast.

Webhookul furnizează înregistrări la fiecare 5 minute. Fiecare sarcină utilă webhook conține înregistrări pentru apelurile care s-au încheiat cu 10-5 minute în urmă. De exemplu, o sarcină utilă primită la ora 17:00 include apelurile care s-au încheiat între orele 16:50 și 16:55. Apelurile care se încheie între orele 16:55 și 17:00 vor fi în sarcina utilă 17:05.

Înregistrările Webex Calling sunt livrate utilizând același format ca API-urile existente pentru evidențele detaliate ale apelurilor. Puteți configura un cârlig web și puteți alege între două tipuri de feed:

• Statistici—Include toate înregistrările apelurilor pentru toate organizațiile de clienți cu care partenerul are o relație Webex Calling. Aceasta include organizații pentru care:
  • Partenerul gestionează organizația client cu un rol de Administrator complet partener.
  • Organizația client are un abonament Webex Calling activ în cadrul organizației partenere.
• Facturare- Include numai înregistrările apelurilor pentru apelurile efectuate de utilizatori cu o licență Webex Calling vândută de partener. În acest feed sunt incluse înregistrările apelurilor pentru spațiile de lucru.

Oferim două puncte finale API împreună cu webhook-ul pentru a ajuta la reconcilierea datelor. Aceste terminale vă permit să „puneți la curent” sau să reconciliați magazinele de date cu înregistrările lipsă care nu sunt primite de ascultătorul webhook. Aceste două API-uri sunt punctul fina l API reconciliere și punctul final API Records.

Înregistrările sunt disponibile de la aceste API-uri timp de 48 de ore. Vă recomandăm să reconciliați periodic magazinele de înregistrări, cum ar fi la fiecare 12 sau 24 de ore, astfel încât toate înregistrările să fie primite conform așteptărilor. Pentru a utiliza acest API este necesar un token de acces pentru parteneri. Puteți obține un token de acces pentru partener și îl puteți gestiona conform principiilor standard de gestionare a tokenului Webex Developer.

punct de sfârșit API de reconciliere

Terminalul API de reconciliere returnează numărul de înregistrări generate de fiecare client care sunt gestionate de partener în perioada de timp specificată. Dacă un partener gestionează mai mult de 200 de organizații ale clienților, rezultatele din API vor fi paginate pentru o mai bună lizibilitate. Puteți utiliza aceste valori totale pentru a verifica depozitarea locală dacă lipsesc înregistrări pentru anumiți clienți. Puteți găsi adresa URL a punctului final API pentru reconciliere aici:

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

Parametrii

API-ul de reconciliere poate fi apelat numai pentru o durată maximă de 1 oră, cu parametrii startTime și endTime la maximum 60 de minute distanță. API-ul poate fi utilizat pentru orice perioadă de 1 oră între 5 minute și 48 de ore în urmă, dar pentru a gestiona încărcarea serviciilor, se poate apela doar 1 oră la un moment dat.

Parametrii disponibili sunt:

• startTime (șir) – Ora primului raport pe care doriți să îl colectați. Ora raportului specifică ora de finalizare a apelului.

  Trebuie să formatați ora ca AAAA-MM-DDTHH:MM:SS.mmmZ.

• endTime (șir) – Ora ultimului raport pe care doriți să îl colectați. Ora raportului specifică ora de finalizare a apelului.

  Ora specificată trebuie să fie ulterioară începeriiOra , dar nu mai târziu de 48 de ore și trebuie să formatați ora ca AAAA-MM-DDTHH:MM:SS.mmmZ.

Iată un exemplu de cum arată o sarcină utilă returnare JSON a punctului final API de reconciliere:

{ "cdr_counts": [ { "orgId": "zzzzzzzz-aaaa-zzzz-xxxx-aaaa aaaa aaaa", "count": 3009 }, { "orgId": "aaaa-aaaa-aaaa-zzzz-xxxx-aaaa-aaaa", "număr": 129 }, { "orgId": "xxxxxxxx-aaaa-zzzz-xxxx-aaaa-aaaa", "număr": 278 } ] } 

Antetele răspunsului API indică numărul total de organizații returnate și dacă există pagini suplimentare. Verificați următorii parametri pentru a vă asigura că toate paginile au fost interogate.

 num-pagini = 2 total-orgs = 283 curent-pagină = 1

Parametrii de mai sus arată că pagina curentă este prima pagină, că există 2 pagini în total și că întregul răspuns conține 283 de organizații. Accesați a doua pagină adăugând parametrul page=2 la solicitarea GET , după cum se arată mai jos.

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

punct de sfârșit API al înregistrărilor

Acest punct final API returnează înregistrările apelurilor în format JSON, identice cu formatul descris în API-ul pentru istoricul apelurilor detaliate. Sarcina utilă returnată conține câmpuri identice cu sarcina utilă returnată din istoricul detaliat al apelurilor. Puteți găsi mai multe detalii despre valorile din fiecare câmp returnat aici. Punctul final API al înregistrărilor este utilizat pentru a interoga evidențele lipsă pentru organizațiile pentru care lipsesc evidențele. Puteți găsi adresa URL a punctului final API al înregistrărilor aici:

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

Parametrii

• orgID- ID-ul organizației pentru care doriți să solicitați înregistrări. Puteți deschide acești identificatori de la terminalul de reconciliere anterior.

• startTime (șir) – Ora primului raport pe care doriți să îl colectați. Ora raportului specifică ora de finalizare a apelului.

  Ora specificată trebuie să se încadreze între acum 5 minute și acum 48 de ore și trebuie să formatați ora în formatul AAAA-MM-DDTHH:MM:SS.mmmZ.

• endTime (șir) – Ora ultimului raport pe care doriți să îl colectați. Ora raportului specifică ora de finalizare a apelului.

  Ora specificată trebuie să fie ulterioară începeriiOra , dar nu mai târziu de 48 de ore și trebuie să formatați ora ca AAAA-MM-DDTHH:MM:SS.mmmZ.