Adressebogssynkronisering sikrer, at Webex for Cisco BroadWorks-brugere kan bruge Webex-adresselisten fra Webex-appen til at ringe til enhver opkaldsenhed fra BroadWorks-serveren. Denne funktion synkroniserer BroadWorks-opkaldsoplysninger, der ikke var en del af brugerklargøring til Webex-mappen.

Webex til Cisco BroadWorks-brugerklargøring opdaterer Webex-mappen med opkaldsoplysninger for Webex for Cisco BroadWorks-brugere (primært telefonnummer, mobiltelefonnummer, lokalnummer), men udelader eksterne opkaldsposter. Men når adressebogssynkronisering er tændt, synkroniserer funktionen også følgende opkaldsposter til Webex-adresselisten.

• Opkaldsbrugere af BroadWorks-only (som ikke er onboardet til Webex)

• Opkaldsenheder, der ikke er brugere (f.eks. en Konferencerum telefon, faxmaskine, viderestillingsgruppe nummer)

• BroadWorks-telefonlisteposter

Følgende tabel opsummerer BroadWorks-opkaldsposter og viser, hvordan de føjes til Webex-adresselisten.

Betingelser for adressebogssynkronisering

• Partneradministratorer skal aktivere funktionen på partnerniveau. Partneradministratorer kan aktivere eller deaktivere funktionen for flere kundeorganisationer i en enkelt handling.

• Som standard sker den indledende synkronisering en uge efter aktivering af synkroniseringen (tidspunktet, der vælges til at starte synkroniseringen, er tilfældig). Kundeorganisationer kan dog bruge valgmuligheden Synk nu ti l at omgå ventetiden på en uge og udløse en øjeblikkelig synkronisering for en given kundeorganisation.

• Som standard kører adressebogssynkronisering ugentligt for hver kunde. Hver synkronisering finder sted én uge efter den sidste synkronisering, uanset om den sidste synkronisering blev planlagt eller udløst manuelt med Synkroniser nu.

• Det maksimale antal samtidige synkroniseringer pr. BroadWorks-klynge er to: én planlagt synkronisering og én on-demand synkronisering (via API eller Partner Hub GUI). Administratorer kan dog ikke køre to on-demand synkroniseringer på samme tid fra det samme BroadWorks. Denne begrænsning eksisterer, uanset om synkroniseringen blev startet via API'en eller via valgmuligheden Synkroniser nu i Partner Hub. Derudover vil Webex ikke planlægge to planlagte synkroniseringer, der skal køres på samme tid fra det samme BroadWorks.

• Hvis der opstår en synkroniseringsfejl, prøver Webex synkroniseringen automatisk hver 24. time indtil den næste planlagte synkronisering.

• Synkroniseringen ignorerer brugere, der ikke har et telefonnummer.

• I Partner Hub kan du se oplysninger om synkroniseringsstatus for en bestemt kunde. Derudover kan du eksportere detaljerede oplysninger om den sidste synkronisering til en CSV-post. CSV-posten indeholder flere oplysninger end visningen i Control Hub og kan hjælpe med fejlfinding, analyser og revision.

• Webex gemmer brugerkontakter i et krypteret format. Kun brugeren, der ejer kontakten, har adgang til dekrypteringsnøglen.

• For broadWorks-only-opkaldsbrugere og ikke-brugeropkaldsenheder synkroniserer denne funktion følgende telefonnummertyper fra BroadWorks:

  • Primært telefonnummer

  • Mobiltelefonnummer

  • Forlængelse

  Synkronisering udelukker dog BroadWorks-only-opkaldsbrugere og ikke-brugeropkaldsenheder fra synkroniseringen, hvis hverken et primært telefonnummer eller et primært lokalnummer er til stede.

  Indstillingen fordatabeskyttelsestjeneste på brugerniveau understøttes ikke som en del af adressebogssynkronisering.

BroadWorks-telefonliste og maksimale kontaktoplysninger

Adressebogssynkronisering synkroniserer også BroadWorks-telefonlisteposter til Webex-kontakter. Synkroniserede poster bliver føjet til en af følgende kontakttyper:

• Organisationskontakter – Webex gemmer disse kontakter mod en organisation. Hver bruger kan få adgang til organisationens kontakter for deres organisation. Maksimalt er op til 30000 kontakter.

• Brugerkontakter – Webex gemmer disse kontakter mod en bruger. Kun brugeren, som ejer kontakten, kan tilgå indtastningen. Det maksimale antal er op til 2000 kontakter (1500 synkroniserede kontakter + 500 manuelle indtastningskontaktpersoner).

Følgende tabel kortlægger Webex-kontakttyper mod kontaktkilden (synkroniseret fra en BroadWorks-telefonliste eller tilføjet manuelt):

Følgende forhold gælder for, hvordan adressebogssynkronisering håndterer kontakt maksimum:

• Hvis en organisation overskrider det maksimale antal tilladte kontakter for synkroniseringen (30000 organisationskontakter eller 30000 fælles kontakter pr. gruppe), udelukker adressebogssynkronisering poster over den maksimale tærskel. Der er ingen bestemt ordre anvendt til synkroniserede eller kontaktkontakter.

• Hvis en af dine kunder overskrider det maksimale tilladte antal kontakter i en af kategorierne, anbefaler vi, at du tager en sag op med Cisco for at få den pågældende organisation udelukket fra adressebogssynkronisering.

• Manuelle kontakter er kontakter, som en bruger tilføjer manuelt i Webex-appen. En bruger kan tilføje op til 500 manuelle kontakter. Manuelle kontakter falder inden for den større brugerkontaktkategori på Webex, men er ikke inkluderet i synkroniseringen.

• Den samlede samlede grænse for organisationskontakter (30000) og gruppekontakter (30000 pr. gruppe) er 200000.

Opdateringer

Følgende er, hvordan Webex-adresselisten håndterer opdateringer:

• Hvis kontaktnavnet ændres på BroadWorks, bliver den eksisterende kontakt slettet fra Webex-adresselisten, og en ny kontakt oprettes.

• Hvis kontaktnummeret ændres på BroadWorks, opdaterer Webex den eksisterende kontakt i Webex-adresselisten med det nye nummer.

Når en administrator har opdateret en kontakt på BroadWorks, beskrives følgende forhold, når opdateringen vises i en brugers Webex-app:

• Hvis opdateringen er til en bruger, der kun ringer til BroadWorks eller en enhed, der ikke er bruger, vises opdateringen i en brugers Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.

• Hvis opdateringen er til en post på BroadWorks-telefonlisten:

  • For brugerkontakter—Opdateringer vises i brugerens Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.

  • For gruppekontakter – opdateringer vises i brugernes Webex-app umiddelbart efter den efterfølgende adressebogssynkronisering.

  • For organisationskontakter—Webex-adressebogen opdateres ved den efterfølgende adressebogssynkronisering, men brugere kan ikke se ændringen i Webex-appen, før de genstarter Webex-appen, eller indtil den lokale 72-timers cachetimer udløber.

Vi anbefaler, at du bruger følgende indstillinger:

• Hastighedsbegrænsningsværdier – Indstil følgende OverloadControl-systemegenskaber (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit– Indstil til en nulværdi.

  • globalDirectoryTransactionLimit– Indstil til en nulværdi.

  Det anbefales, at du indstiller userDirectoryTransactionLimit og globalDirectoryTransactionLimit til en nulværdi. Men hvis du beslutter at tildele værdier, skal hver indstilles til mindst fem gange værdien af transaktionenLimitPeriodSeconds (som bør være 1).

• Transaktionsgrænser – Indstil følgende værdier (XSP_CLI/System/CommunicationUtilitet/Standardindstillinger):

  • userTransactionLimit–Indstil til mindst 100.

  • transactionLimitPeriodSecs– Indstil til 1.

• Paging-værdier – Indstil paging-systemegenskaber (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – Indstil til 50

  • availableUserMaxLimit – Indstil til 100

• CTI-grænseflade – Sørg for at overføre webex CA-certifikater til CTI-grænsefladetillidslageret og for at aktivere klientgodkendelse på CTI-grænsefladen.

Afhængigt af din BroadWorks-udgivelse anbefaler vi desuden, at du anvender følgende systemrettelser på BroadWorks-udrulningen, før du aktiverer denne funktion:

• For R22: AP.as.22.0.1123.ap368517

• For R23: AP.as.23.0.1075.ap368517

• For R24: ingen programrettelse er påkrævet

Partneradministratorer kan aktivere Adressebogssynkronisering for en kundeskabelon, mens den nye skabelon oprettes. Alle nye kundeorganisationer, der bliver tildelt denne skabelon, vil have adressebogssynkronisering aktiveret. Se "Konfigurer dine kundeskabeloner" i Konfigurer din partnerorganisation i Partner Hub i Løsningsvejledningen til Webex til Cisco BroadWorksfor detaljer.

Hvad er næste trin?

Sørg for, at dine brugere ved , at de skal klikke på fanen Kontakter på Webex-appen mindst én gang for at aktivere funktionen i Webex-appen. Dette skal kun udføres én gang.

Offentlige API'er er tilgængelige på developer.webex.com , der giver partneradministratorer mulighed for at opdatere adressebogssynkroniseringsindstillinger for de kundeorganisationer, de administrerer, for at udløse øjeblikkelig synkronisering eller opnå synkroniseringsstatusoplysninger. Adressebogssynkroniseringsmetoder grupperes under BroadWorks-virksomheder:

• Vis BroadWorks-virksomheder – brug denne API-metode til at få en liste over virksomheder under en given tjenesteudbyder og hver virksomheds id. Du skal indtaste spEnterpriseId som tildelt under klargøring.

• Opdater adressebogssynkronisering for en BroadWorks-virksomhed – indtast id'et for at opdatere adressebogssynkronisering for den pågældende virksomhed.

• Udløs adressebogssynkronisering for en virksomhed – brug denne API-metode, hvis du vil udløse en øjeblikkelig synkronisering for et givet virksomheds-id. For synkroniseringsstatus skal du indtaste kommandoen SYNKRONISER_NU .

• Hent status for adressebogssynkronisering for en virksomhed– Indtast virksomheden id og køre for at få en status og sporings-id af den seneste synkronisering. Du kan bruge sporings-id'et til at køre yderligere analyser via værktøjer såsom Kibana og Grafana.

Desuden kan administratorer bruge Trigger Directory Sync for en enkelt bruger API til at udløse en on-demand mappesynkronisering for en enkelt bruger.

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

Du skal logge ind for at læse API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Følgende fejlkoder gælder for adressebogssynkronisering.

Følgende tabel opsummerer opdateringer til denne artikel.