Adressenlijstsynchronisatie in Webex voor Cisco Broadworks

Telefoonlijstsynchronisatie zorgt ervoor dat Webex voor Cisco BroadWorks-gebruikers de Webex-telefoonlijst vanuit de Webex-app kunnen gebruiken om een belentiteit te bellen vanaf de BroadWorks-server. Met deze functie wordt BroadWorks-gespreksinformatie die geen deel uitmaakt van de gebruikersinrichting gesynchroniseerd met de Webex-telefoonlijst.

Webex voor Cisco BroadWorks-gebruikersvoorzieningen werken de Webex-telefoonlijst bij met gespreksgegevens voor Webex voor Cisco BroadWorks-gebruikers (primair telefoonnummer, mobiel telefoonnummer, toestel), maar laten externe gespreksrecords weg. Wanneer adreslijstsynchronisatie is ingeschakeld, worden de volgende gespreksrecords echter ook gesynchroniseerd met de Webex-telefoonlijst.

• Gespreksgebruikers met alleen BroadWorks (die niet zijn geïntegreerd in Webex)

• Belentiteiten die geen gebruikers zijn (bijvoorbeeld een conferentieruimte, een faxapparaat, een nummer van de Hunt-groep)

• Vermeldingen in BroadWorks-telefoonlijst

De volgende tabel geeft een overzicht van BroadWorks-gespreksrecords en toont hoe deze worden toegevoegd aan de Webex-telefoonlijst.

Voorwaarden voor telefoonlijstsynchronisatie

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

• Standaard wordt de eerste synchronisatie één week na het inschakelen van de synchronisatie uitgevoerd (de tijd die is gekozen om de synchronisatie te starten, is willekeurig). Klantorganisaties kunnen de optie Nu synchroniseren echter gebruiken om de wachttijd van één week te omzeilen en een onmiddellijke synchronisatie voor een bepaalde klantorganisatie te activeren.

• Standaard wordt de telefoonlijstsynchronisatie wekelijks uitgevoerd voor elke klant. Elke synchronisatie vindt plaats een week na de laatste synchronisatie, ongeacht of de laatste synchronisatie is gepland of handmatig is geactiveerd met Nu synchroniseren.

• Het maximale aantal gelijktijdige syncs per BroadWorks-cluster is twee: één geplande synchronisatie en één on-demand synchronisatie (via API of Partner Hub GUI). Beheerders kunnen echter niet twee on-demandsyncs tegelijk 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. Daarnaast plant Webex niet dat twee geplande syncs tegelijk worden uitgevoerd vanuit dezelfde BroadWorks.

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

• De synchronisatie negeert gebruikers die geen telefoonnummer hebben.

• In Partnerhub kunt u synchronisatiestatusinformatie voor een bepaalde klant weergeven. Daarnaast kunt u gedetailleerde informatie over de laatste synchronisatie naar een CSV-record exporteren. De CSV-record biedt meer details dan de Control Hub-weergave en kan helpen bij het oplossen van problemen, analyses en audits.

• Webex slaat gebruikerscontactpersonen op in een gecodeerde indeling. Alleen de gebruiker die eigenaar is van de contactpersoon heeft toegang tot de decoderingssleutel.

• Voor BroadWorks-alleen bellende gebruikers en niet-gebruikers-belentiteiten synchroniseert deze functie de volgende typen telefoonnummers vanuit BroadWorks:

  • Primair telefoonnummer

  • Mobiel telefoonnummer

  • Extensie

  Synchronisatie sluit echter gespreksgebruikers die alleen BroadWorks bellen en belentiteiten die geen gebruiker zijn uit van de synchronisatie als er geen primair telefoonnummer of toestel aanwezig is.

  De instelling Privacyservice op gebruikersniveau van BroadWorks wordt niet ondersteund als onderdeel van adreslijstsynchronisatie.

BroadWorks-telefoonlijst en maximums voor contactpersonen

Met adreslijstsynchronisatie worden ook BroadWorks-telefoonlijstvermeldingen gesynchroniseerd met Webex-contactpersonen. Gesynchroniseerde vermeldingen worden toegevoegd aan een van de volgende contacttypen:

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

• Gebruikerscontactpersonen: Webex slaat deze contactpersonen op tegen een gebruiker. Alleen de gebruiker die eigenaar is van de contactpersoon, heeft toegang tot de contactpersoon. Het maximum is 2000 contacten (1500 gesynchroniseerde contacten + 500 handmatige invoercontacten).

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

De volgende voorwaarden zijn van toepassing op de manier waarop Directory Sync contactmaximums verwerkt:

• Als een organisatie het maximaal toegestane aantal contactpersonen voor de synchronisatie overschrijdt (30000 contactpersonen van de organisatie of 30000 gemeenschappelijke contactpersonen per groep), worden vermeldingen boven de maximale drempelwaarde uitgesloten van de adreslijstsynchronisatie. Er is 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 casus in te dienen bij Cisco zodat die organisatie wordt uitgesloten van adreslijstsynchronisatie.

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

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

Updates

Hieronder ziet u hoe de Webex-directory met updates omgaat:

• Als de naam van de contactpersoon in BroadWorks verandert, wordt de bestaande contactpersoon verwijderd uit de Webex-directory en wordt er een nieuwe contactpersoon gemaakt.

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

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

• Als de update naar een bellende gebruiker met alleen BroadWorks of een belentiteit zonder gebruiker gaat, wordt de update direct na de volgende directorysynchronisatie weergegeven in de Webex-app van een gebruiker.

• Als de update naar een BroadWorks-telefoonlijstvermelding gaat:

  • Voor gebruikerscontactpersonen: updates worden direct na de volgende directorysynchronisatie weergegeven in de Webex-app van de gebruiker.

  • Voor groepscontactpersonen: updates worden direct na de volgende directorysynchronisatie weergegeven in de Webex-app van de gebruiker.

  • Voor contactpersonen binnen de organisatie: de Webex-directory wordt bijgewerkt bij de volgende directorysynchronisatie, maar gebruikers zien de wijziging niet in de Webex-app totdat ze de Webex-app opnieuw starten of totdat de lokale cachetimer van 72 uur verloopt.

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: stel in op een nulwaarde.

  • globalDirectoryTransactionLimit: stel in op een nulwaarde.

  Het wordt aanbevolen om userDirectoryTransactionLimit en globalDirectoryTransactionLimit in te stellen op een nulwaarde. Als u echter besluit om waarden toe te wijzen, moet elke waarde worden ingesteld op ten minste vijf keer de waarde transactionLimitPeriodSeconds (wat 1 moet zijn).

• Transactielimieten: stel de volgende waarden in (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit: stel in op ten minste 100.

  • transactionLimitPeriodSecs: stel in op 1.

• Pagingwaarden: stel de eigenschappen van het pagingsysteem in (XSP_CLI/toepassingen/Xsi-acties/paging):

  • defaultPageSize: ingesteld op 50

  • availableUserMaxLimit: ingesteld op 100

• CTI-interface: zorg ervoor dat u de Webex CA-certificaten uploadt naar de vertrouwde CTI-interface en dat u clientverificatie inschakelt op de CTI-interface.

Daarnaast raden we u aan, 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 pleister nodig

Partnerbeheerders kunnen adreslijstsynchronisatie inschakelen voor een klantsjabloon tijdens het maken van de nieuwe sjabloon. Voor nieuwe klantorganisaties die aan die sjabloon worden toegewezen, is adreslijstsynchronisatie ingeschakeld. Zie 'Uw klantsjablonen configureren' in Uw partnerorganisatie configureren in Partner Hub in de oplossingshandleiding voor Webex voor Cisco BroadWorks voor meer informatie.

De volgende stappen

Zorg ervoor dat uw gebruikers weten dat ze ten minste één keer op het tabblad Contactpersonen in de Webex-app moeten klikken om de functie in de Webex-app in te schakelen. Dit moet slechts één keer worden ingevuld.

Openbare API's zijn beschikbaar op developer.webex.com waarmee partnerbeheerders instellingen voor adreslijstsynchronisatie kunnen bijwerken voor de klantorganisaties die ze beheren, direct synchroniseren kunnen activeren of synchronisatiestatusinformatie kunnen verkrijgen. De methoden voor telefoonlijstsynchronisatie zijn gegroepeerd onder BroadWorks Enterprises:

• Lijst met BroadWorks-ondernemingen: gebruik deze API-methode om een lijst met ondernemingen onder een bepaalde serviceprovider en de van elke onderneming te verkrijgen id. U moet de spEnterpriseId zoals toegewezen in inrichting.

• Adreslijstsynchronisatie voor een BroadWorks-onderneming bijwerken: voer de onderneming in id om de status van de adreslijstsyc voor die onderneming bij te werken, waarbij adreslijstsynchronisatie wordt in- of uitgeschakeld.

• Adreslijstsynchronisatie voor een Enterprise activeren: gebruik deze API-methode als u een directe synchronisatie voor een bepaalde onderneming wilt activeren id. Voor de syncStatus, voer de SYNC_NOW opdracht.

• Synchronisatiestatus van adreslijst ophalen voor een onderneming: voer de onderneming in id en uitvoeren om een status te krijgen en trackingId van de nieuwste synchronisatie. U kunt de trackingID om bijkomende analyses uit te voeren via tools zoals Kibana en Grafana.

Daarnaast kunnen beheerders de Trigger Directory Sync for a Single User API gebruiken om een on-demand directorysynchronisatie 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 op https://developer.webex.com/docs/api/v1/broadworks-subscribers te lezen.

De volgende foutcodes zijn van toepassing op adreslijstsynchronisatie.

De volgende tabel geeft een overzicht van de updates van dit artikel.