Directory-synchronisatie zorgt ervoor dat gebruikers van Webex voor Cisco BroadWorks de Webex-adreslijst van de Webex-app kunnen gebruiken om elke oproepende entiteit vanaf de BroadWorks-server te bellen. Deze functie synchroniseert BroadWorks-oproepinformatie die geen deel uitmaakte van de gebruikerstoewijzing naar het Webex-adresboek.

Met de gebruikersinrichting van Webex for Cisco BroadWorks wordt het Webex-adresboek bijgewerkt met belgegevens voor Webex for Cisco BroadWorks-gebruikers (primair telefoonnummer, mobiele telefoonnummer, extensie), maar worden externe gespreksgegevens weggelaten. Als de adreslijstsynchronisatie echter is ingeschakeld, worden met deze functie ook de volgende oproeprecords gesynchroniseerd met het Webex-adresboek.

• Gebruikers die alleen naar Broadworks bellen (die niet bij Webex zijn aangesloten)

• entiteiten die niet door gebruikers worden gebeld (bijvoorbeeld een telefoon in een vergaderruimte, een faxapparaat, een Hunt-groepsnummer)

• Vermeldingen op de telefoonlijst van BroadWorks

De volgende tabel geeft een overzicht van de oproeprecords van BroadWorks en laat zien hoe ze aan het Webex-adresboek worden toegevoegd.

Voorwaarden voor het synchroniseren van adresboeken

• Partnerbeheerders moeten de functie op partnerniveau inschakelen. Partnerbeheerders kunnen de functie in één keer voor meerdere klantorganisaties in- of uitschakelen.

• De eerste synchronisatie vindt standaard een week na het inschakelen van de synchronisatie plaats (de gekozen tijd om de synchronisatie te starten is willekeurig). Klantorganisaties kunnen echter de optie Nu synchroniseren gebruiken om de wachttijd van een week te omzeilen en een onmiddellijke synchronisatie voor een bepaalde klantorganisatie te activeren.

• Directory Sync wordt standaard wekelijks uitgevoerd voor elke klant. Elke synchronisatie vindt plaats een week na de laatste synchronisatie, ongeacht of de laatste synchronisatie was gepland of handmatig werd geactiveerd met Nu synchroniseren.

• Het maximale aantal gelijktijdige synchronisaties per BroadWorks-cluster is twee: één geplande synchronisatie en één synchronisatie op aanvraag (via API of Partner Hub-GUI). Beheerders kunnen echter niet tegelijkertijd twee synchronisaties op aanvraag uitvoeren vanuit dezelfde BroadWorks. Deze beperking bestaat ongeacht of de synchronisatie is gestart via de API of via de optie Nu synchroniseren in Partner Hub. Bovendien plant Webex niet dat twee geplande synchronisaties tegelijkertijd vanuit dezelfde BroadWorks worden uitgevoerd.

• Als er een synchronisatiefout optreedt, probeert Webex automatisch elke 24 uur opnieuw te synchroniseren tot de volgende geplande synchronisatie.

• De synchronisatie negeert gebruikers die geen telefoonnummer hebben.

• In Partner Hub kunt u de synchronisatiestatusinformatie voor een bepaalde klant bekijken. Bovendien kunt u gedetailleerde informatie over de laatste synchronisatie exporteren naar een CSV-record. Het CSV-record bevat meer details dan op het scherm van de Control Hub en kan helpen bij het oplossen van problemen, analyses en audits.

• Webex slaat contactpersonen van gebruikers op in een gecodeerd formaat. Alleen de gebruiker die eigenaar is van de contactpersoon heeft toegang tot de decoderingssleutel.

• Voor gebruikers die alleen naar Broadworks bellen en entiteiten die niet door gebruikers bellen, worden met deze functie de volgende typen telefoonnummers van BroadWorks gesynchroniseerd:

  • Primair telefoonnummer

  • Mobiel telefoonnummer

  • Uitbreiding

  Synchronisatie sluit gebruikers die alleen naar Broadworks bellen en entiteiten die niet naar de gebruiker bellen echter uit van de synchronisatie als er geen primair telefoonnummer of telefoonnummer aanwezig is.

  De instelling van de BroadWorks-privacyservice op gebruikersniveau wordt niet ondersteund als onderdeel van de adreslijstsynchronisatie.

Telefoonlijst en contactpersonen van BroadWorks

Met adreslijstsynchronisatie worden ook items uit de BroadWorks-telefoonlijst gesynchroniseerd met Webex Contacts. Gesynchroniseerde gegevens worden toegevoegd aan een van de volgende contacttypes:

• Contactpersonen van de organisatie — Webex slaat deze contactpersonen op tegen een organisatie. Elke gebruiker heeft toegang tot de contactpersonen van de organisatie voor zijn organisatie. Het maximum is maximaal 30000 contacten.

• Contactpersonen van gebruikers — Webex slaat deze contactpersonen op tegen een gebruiker. Alleen de gebruiker die eigenaar is van de contactpersoon heeft toegang tot de contactvermelding. Het maximum is maximaal 2000 contacten (1500 gesynchroniseerde contacten + 500 contacten voor handmatige invoer).

In de volgende tabel worden Webex-contacttypen vergeleken met de contactbron (gesynchroniseerd vanuit een BroadWorks-telefoonlijst of handmatig toegevoegd):

De volgende voorwaarden zijn van toepassing op de manier waarop Directory Sync omgaat met contactmaxima:

• Als een organisatie het maximaal toegestane aantal contactpersonen voor de synchronisatie overschrijdt (30000 contactpersonen van de organisatie of 30000 gemeenschappelijke contactpersonen van groepen per groep), sluit adreslijstsynchronisatie items boven de maximumdrempel uit. Er wordt geen specifieke volgorde toegepast op gesynchroniseerde of weggelaten contactpersonen.

• Als een van uw klanten het maximaal toegestane aantal contactpersonen in een van beide categorieën overschrijdt, raden we u aan een zaak aan te kaarten bij Cisco om die organisatie uit te sluiten van adreslijstsynchronisatie.

• Handmatige contactpersonen zijn contactpersonen die een gebruiker handmatig toevoegt in de Webex-app. Een gebruiker kan tot 500 handmatige contacten toevoegen. Handmatige contactpersonen vallen binnen de grotere categorie Gebruikerscontactpersonen op Webex, maar zijn niet opgenomen in de synchronisatie.

• De totale gecombineerde limiet voor contacten met organisaties (30000) en groepscontacten (30000 per groep) is 200000.

Updates

In het Webex-adresboek wordt als volgt omgegaan met updates:

• Als de naam van de contactpersoon op BroadWorks verandert, wordt de bestaande contactpersoon verwijderd uit het Webex-adresboek en wordt er een nieuwe contactpersoon aangemaakt.

• Als het contactnummer op BroadWorks verandert, werkt Webex de bestaande contactpersoon in het Webex-adresboek bij met het nieuwe nummer.

Nadat een beheerder een contactpersoon op BroadWorks heeft bijgewerkt, worden de volgende voorwaarden beschreven wanneer de update wordt weergegeven in de Webex-app van een gebruiker:

• Als de update bestemd is voor een gebruiker die alleen naar Broadworks belt of naar een entiteit die niet door de gebruiker belt, wordt de update onmiddellijk na de daaropvolgende adreslijstsynchronisatie weergegeven in de Webex-app van een gebruiker.

• Als de update betrekking heeft op een vermelding in de telefoonlijst van BroadWorks:

  • Voor contactpersonen van gebruikers: updates worden onmiddellijk na de daaropvolgende adreslijstsynchronisatie in de Webex-app van de gebruiker weergegeven.

  • Voor groepscontacten: updates worden onmiddellijk na de daaropvolgende adreslijstsynchronisatie in de Webex-app van de gebruiker weergegeven.

  • Voor contactpersonen van organisaties: de Webex-adreslijst wordt bijgewerkt bij de volgende adreslijstsynchronisatie, maar gebruikers zien de wijziging pas in de Webex-app als ze de Webex-app opnieuw starten of totdat de lokale cachetimer van 72 uur is verstreken.

We raden u aan de volgende instellingen te gebruiken:

• Snelheidsbeperkende waarden — Stel de volgende eigenschappen van het OverloadControl-systeem in (XSP_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimit — ingesteld op een waarde van nul.

  • GlobalDirectory TransactionLimit — ingesteld op een waarde van nul.

  Het wordt aanbevolen om UserDirectoryTransactionLimit en GlobalDirectoryTransactionLimit op een nulwaarde in te stellen. Als u echter besluit waarden toe te wijzen, moet elke waarde worden ingesteld op minstens vijf keer de waarde van TransactionLimitPeriodSeconds (wat 1 moet zijn).

• Transactielimieten — Stel de volgende waarden in (xsp_cli/System/CommunicationUtility/DefaultSettings):

  • Transactielimiet voor gebruikers: ingesteld op minstens 100.

  • TransactionLimitPeriodSecs — ingesteld op 1.

• Pagingwaarden — Stel de eigenschappen van het oproepsysteem in (xsp_cli/applications/xsi-actions/paging):

  • Standaardpaginaformaat — ingesteld op 50

  • Maximale gebruikslimiet voor gebruikers: ingesteld op 100

• CTI-interface — Zorg ervoor dat u die Webex CA-certificaten uploadt naar de CTI Interface Trust Store en dat client-authenticatie op de CTI-interface is ingeschakeld.

Bovendien raden we u aan om, afhankelijk van uw BroadWorks-release, de volgende systeempatches toe te passen op de BroadWorks-implementatie voordat u deze functie inschakelt:

• Voor R22: ap.AS.22.0.1123.AP368517

• Voor R23: ap.AS.23.0.1075.AP368517

• Voor R24: geen patch nodig

Partnerbeheerders kunnen Directory Sync inschakelen voor een klantensjabloon terwijl ze de nieuwe sjabloon aanmaken. Alle nieuwe klantenorganisaties die aan dat sjabloon worden toegewezen, hebben adreslijstsynchronisatie ingeschakeld. Zie „Uw onboarding-sjablonen configureren” in Configureer uw partnerorganisatie in Partner Hub in de Solution Guide for Webex for Cisco BroadWorks voor meer informatie.

Wat nu te doen

Zorg ervoor dat uw gebruikers weten dat ze minstens één keer op het tabblad Contactpersonen in de Webex-app moeten klikken om de functie in de Webex-app in te schakelen. Dit hoeft maar één keer te worden voltooid.

Openbare API's zijn beschikbaar op developer.webex.com waarmee partnerbeheerders de Directory Sync-instellingen kunnen bijwerken voor de klantorganisaties die zij beheren, om een onmiddellijke synchronisatie te activeren of informatie over de synchronisatiestatus te verkrijgen. De methoden voor het synchroniseren van mappen zijn gegroepeerd onder BroadWorks Enterprises:

• Lijst BroadWorks Enterprises — Gebruik deze API-methode om een lijst op te vragen van ondernemingen onder een bepaalde serviceprovider en de ID van elke onderneming. U moet de SPEnterpriseID invoeren zoals die bij de provisioning is toegewezen.

• Directory Sync bijwerken voor een BroadWorks Enterprise — Voer de ondernemings-id in om de status van de adreslijstsynchronisatie voor die onderneming bij te werken, door adreslijstsynchronisatie in of uit te schakelen.

• Directory-synchronisatie activeren voor een onderneming — Gebruik deze API-methode als u een onmiddellijke synchronisatie wilt activeren voor een bepaalde bedrijfs-id. Voer voor de SyncStatus de opdracht SYNC_NOW in.

• Directory Sync Status voor een onderneming opvragen — Voer de bedrijfs-id in en voer deze uit om een status en tracking-ID van de laatste synchronisatie te krijgen. U kunt de TrackingID gebruiken om aanvullende analyses uit te voeren via tools zoals Kibana en Grafana.

Bovendien kunnen beheerders de Trigger Directory Sync for a Single User API gebruiken om een adreslijstsynchronisatie op aanvraag voor één gebruiker te activeren.

Zie https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide voor gedetailleerde API-documentatie.

U moet zich aanmelden om de API-specificatie te lezen op https://developer.webex.com/docs/api/v1/broadworks-subscribers.

De volgende foutcodes zijn van toepassing op Directory Sync.

De volgende tabel bevat een samenvatting van de updates van dit artikel.