Katalogsynkronisering sikrer at Webex for Cisco BroadWorks-brukere kan bruke Webex-katalogen fra Webex-appen til å ringe alle anropsenheter fra BroadWorks-serveren. Denne funksjonen synkroniserer BroadWorks-anropsinformasjon som ikke var en del av brukerklargjøringen til Webex-katalogen.

Webex for Cisco BroadWorks-brukerklargjøring oppdaterer Webex-katalogen med anropsdetaljer for Webex for Cisco BroadWorks-brukere (primært telefonnummer, mobiltelefonnummer, internnummer), men utelates eksterne anropsoppføringer. Når katalogsynkronisering er aktivert, synkroniserer funksjonen imidlertid også følgende anropsoppføringer til Webex-katalogen.

• Brukere som kun ringer BroadWorks (som ikke er innfaset til Webex)

• Ikke-brukeroppringende enheter (f.eks. telefon i konferanserommet, faksmaskin, huntgruppenummer)

• Oppføringer i BroadWorks-telefonlisten

Tabellen nedenfor oppsummerer BroadWorks-anropsoppføringer og viser hvordan de legges til i Webex-katalogen.

Betingelser for katalogsynkronisering

• Partneradministratorer må aktivere funksjonen på partnernivå. Partneradministratorer kan slå funksjonen på eller av for flere kundeorganisasjoner i én enkelt operasjon.

• Som standard skjer den første synkroniseringen én uke etter at synkroniseringen er aktivert (tidspunktet som er valgt for å starte synkroniseringen er tilfeldig). Kundeorganisasjoner kan imidlertid bruke alternativet Synkroniser nå til å omgå venteperioden på én uke og utløse en umiddelbar synkronisering for en gitt kundeorganisasjon.

• Som standard kjører katalogsynkronisering ukentlig for hver kunde. Hver synkronisering finner sted én uke etter den siste synkroniseringen, uavhengig av om den siste synkroniseringen ble planlagt eller utløst manuelt med Synkroniser nå.

• Maksimalt antall samtidige synkroniseringer per BroadWorks-klynge er to: én planlagt synkronisering og én behovsbasert synkronisering (via API eller Partner Hub GUI). Administratorer kan imidlertid ikke kjøre to on-demand-synkronisering samtidig fra samme BroadWorks. Denne begrensningen finnes uavhengig av om synkroniseringen ble startet via API eller via Synkroniser nå -alternativet i Partner Hub. I tillegg planlegger ikke Webex å kjøre to planlagte synkroniseringer samtidig fra samme BroadWorks.

• Hvis det oppstår en synkroniseringsfeil, prøver Webex automatisk synkroniseringen hver 24. time til neste planlagte synkronisering.

• Synkroniseringen ignorerer brukere som ikke har et telefonnummer.

• I Partner Hub kan du vise synkroniseringsstatusinformasjon for en gitt kunde. I tillegg kan du eksportere detaljert informasjon om den siste synkroniseringen til en CSV-oppføring. CSV-oppføringen gir mer detaljer enn Control Hub-skjermen og kan hjelpe til med feilsøking, analyse og revisjon.

• Webex lagrer brukerkontakter i kryptert format. Bare brukeren som eier kontakten har tilgang til dekrypteringsnøkkelen.

• For kun BroadWorks-anropsbrukere og ikke-brukeranropsenheter synkroniserer denne funksjonen følgende telefonnummertyper fra BroadWorks:

  • Primærtelefonnummer

  • Mobiltelefonnummer

  • Internnummer

  Synkronisering utelukker imidlertid kun BroadWorks-anropsbrukere og enheter som ikke er brukere, fra synkroniseringen hvis det verken finnes et primært telefonnummer eller internnummer.

  Innstilling av personverntjeneste på brukernivå i BroadWorks støttes ikke som en del av katalogsynkronisering.

BroadWorks-telefonliste og kontaktmaksimum

Katalogsynkronisering synkroniserer også BroadWorks-telefonlisteoppføringer til Webex Contacts. Synkroniserte oppføringer legges til i én av følgende kontakttyper:

• Organisasjonskontakter – Webex lagrer disse kontaktene mot en organisasjon. Hver bruker kan få tilgang til organisasjonskontaktene for sin organisasjon. Maksimum er opptil 30000 kontakter.

• Brukerkontakter – Webex lagrer disse kontaktene mot en bruker. Bare brukeren som eier kontakten, har tilgang til kontaktoppføringen. Maksimum er opptil 2000 kontakter (1500 synkroniserte kontakter + 500 manuelle inngangskontakter).

Tabellen nedenfor tilordner Webex-kontakttyper mot kontaktkilden (synkronisert fra en BroadWorks-telefonliste eller lagt til manuelt):

Følgende betingelser gjelder rundt hvordan katalogsynkronisering håndterer kontaktmaksimum:

• Hvis en organisasjon overskrider maksimalt tillatte kontakter for synkronisering (30000 organisasjonskontakter eller 30000 vanlige kontakter for gruppen per gruppe), utelukker katalogsynkronisering oppføringer over den maksimale terskelen. Det er ingen spesiell rekkefølge som brukes på synkroniserte eller utelatte kontakter.

• Hvis en av kundene dine overskrider det maksimalt tillatte antallet kontakter i begge kategoriene, anbefaler vi at du legger opp en sak med Cisco for å få organisasjonen ekskludert fra katalogsynkronisering.

• Manuelle kontakter er kontakter som en bruker legger til manuelt i Webex-appen. En bruker kan legge til opptil 500 manuelle kontakter. Manuelle kontakter faller innenfor den større Brukerkontaktkategorien på Webex, men er ikke inkludert i synkroniseringen.

• Den totale kombinerte grensen for organisasjonskontakter (30000) og gruppekontakter (30000 per gruppe) er 200000.

Oppdateringer

Slik håndterer Webex-katalogen oppdateringer:

• Hvis kontaktnavnet endres på BroadWorks, slettes den eksisterende kontakten fra Webex-katalogen, og en ny kontakt opprettes.

• Hvis kontaktnummeret endres på BroadWorks, oppdaterer Webex den eksisterende kontakten i Webex-katalogen med det nye nummeret.

Etter at en administrator oppdaterer en kontakt på BroadWorks, beskriver følgende betingelser når oppdateringen vises i en brukers Webex-app:

• Hvis oppdateringen gjelder for en BroadWorks-oppringingsbruker eller en ikke-brukeroppringingsenhet, vises oppdateringen i en brukers Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

• Hvis oppdateringen er til en BroadWorks-telefonlisteoppføring:

  • For brukerkontakter – Oppdateringer vises i brukerens Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

  • For gruppekontakter – Oppdateringer vises i brukernes Webex-app umiddelbart etter den påfølgende katalogsynkroniseringen.

  • For organisasjonskontakter – Webex-katalogen oppdateres ved den påfølgende katalogsynkroniseringen, men brukere vil ikke se endringen i Webex-appen før de starter Webex-appen på nytt eller før den lokale 72-timers hurtigbufferen utløper.

Vi anbefaler at du bruker følgende innstillinger:

• Hastighetsbegrensende verdier – angi følgende OverloadControl-systemegenskaper (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit – Satt til nullverdi.

  • globalDirectoryTransactionLimit – Satt til nullverdi.

  Det anbefales at du angir userDirectoryTransactionLimit og globalDirectoryTransactionLimit til nullverdi. Men hvis du bestemmer deg for å tilordne verdier, må hver settes til minst fem ganger verdien av transactionLimitPeriodSeconds (som skal være 1).

• Transaksjonsgrenser – angi følgende verdier (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit – Satt til minst 100.

  • transactionLimitPeriodSecs – Satt til 1.

• Oppkallingsverdier – angi egenskapene for oppkallingssystemet (XSP_CLI/Applications/Xsi-Actions/Oppkalling):

  • defaultPageSize – Satt til 50

  • tilgjengeligUserMaxLimit – Satt til 100

• CTI-grensesnitt – Sørg for å laste opp Webex CA-sertifikatene til klareringslageret for CTI-grensesnittet og aktivere klientgodkjenning på CTI-grensesnittet.

I tillegg, avhengig av din BroadWorks-utgivelse, anbefaler vi at du bruker følgende systemoppdateringer på BroadWorks-distribusjon før du aktiverer denne funksjonen:

• For R22: AP.as.22.0.1123.ap368517

• For R23: AP.as.23.0.1075.ap368517

• For R24: ingen oppdatering er nødvendig

Partneradministratorer kan aktivere katalogsynkronisering for en kundemal mens de oppretter den nye malen. Alle nye kundeorganisasjoner som blir tilordnet denne malen, vil ha katalogsynkronisering aktivert. Hvis du vil ha mer informasjon, kan du se «Konfigurere kundemalene dine» i Konfigurere partnerorganisasjonen i Partner Hub i løsningsveiledningen for Webex for Cisco BroadWorks.

Hva du skal gjøre Neste

Sørg for at brukerne vet at de må klikke på Kontakter -fanen i Webex-appen minst én gang for å slå på funksjonen i Webex-appen. Dette må bare fullføres én gang.

Offentlige API-er er tilgjengelige på developer.webex.com som gjør det mulig for partneradministratorer å oppdatere innstillinger for katalogsynkronisering for kundeorganisasjonene de administrerer, for å utløse en umiddelbar synkronisering eller hente synkroniseringsstatusinformasjon. Katalogsynkroniseringsmetodene grupperes under BroadWorks Enterprises:

• List BroadWorks Enterprises – Bruk denne API-metoden til å få en liste over bedrifter under en gitt tjenesteleverandør og hver bedrifts ID. Du må angi spEnterpriseId som tilordnet ved klargjøring.

• Oppdater katalogsynkronisering for en BroadWorks-bedrift– angi ID-en for å oppdatere katalogsystemstatusen for denne bedriften, ved å aktivere eller deaktivere katalogsynkronisering.

• Utløs katalogsynkronisering for en bedrift – Bruk denne API-metoden hvis du vil utløse en umiddelbar synkronisering for en gitt bedrift-ID. For syncStatus skriver du inn kommandoen SYNC_NOW .

• Få katalogsynkroniseringsstatus for en bedrift– angi bedrifts-ID og kjør for å få status og sporings-ID for den nyeste synkroniseringen. Du kan bruke sporings-ID til å kjøre ytterligere analyser via verktøy som Kibana og Grafana.

I tillegg kan administratorer bruke Trigger Directory Sync for en enkeltbruker API til å utløse en behovskatalogsynkronisering for en enkeltbruker.

For detaljert API-dokumentasjon, se https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du må logge på for å lese API-spesifikasjonen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Følgende feilkoder gjelder for katalogsynkronisering.

Tabellen nedenfor oppsummerer oppdateringer av denne artikkelen.