Adressenlijstsynchronisatie in Webex voor Cisco Broadworks

Directorysynchronisatie zorgt ervoor dat gebruikers van Webex voor Cisco BroadWorks de Webex-directory vanuit de Webex-app kunnen gebruiken om elke belentiteit vanaf de BroadWorks-server te bellen. Met deze functie wordt belinformatie van BroadWorks gesynchroniseerd die geen deel uitmaakte van de gebruikersvoorzieningen op de Webex-directory.

Webex voor Cisco BroadWorks-gebruikersvoorzieningen werken de Webex-adressenlijst bij met gespreksgegevens voor Webex voor Cisco BroadWorks-gebruikers (primair telefoonnummer, mobiel telefoonnummer, toestelnummer), maar laat externe gespreksrecords weg. Wanneer de telefoonlijstsynchronisatie is in gebruik, worden de volgende belrecords ook met de Webex-directory gesynchroniseerd.

• Gebruikers die alleen bellen via BroadWorks (die niet zijn geïntegreerde op Webex)

• Entiteiten die niet door gebruikers bellen (zoals een telefoon conferentieruimte faxapparaat, Hunt-groep nummer)

• BroadWorks-telefoonlijst vermeldingen

De volgende tabel vat BroadWorks-oproeprecords samen en laat zien hoe ze aan de Webex-map worden toegevoegd.

Voorwaarden telefoonlijstsynchronisatie

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

• De eerste synchronisatie vindt standaard één week plaats nadat de synchronisatie is ingeschakeld (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 directorysynchronisatie voor elke klant wekelijks uitgevoerd. Elke synchronisatie vindt één week plaats na de laatste synchronisatie, ongeacht of de laatste synchronisatie handmatig is gepland of geactiveerd met Nu synchroniseren.

• Het maximale aantal gelijktijdige synchronisaties 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-demand synchronisaties tegelijk uitvoeren vanuit hetzelfde BroadWorks. Deze beperking bestaat ongeacht of de synchronisatie is gestart via de API of via de optie Nu synchroniseren in Partnerhub. Daarnaast heeft Webex niet de planning twee geplande synchronisaties die tegelijkertijd moeten worden uitgevoerd vanuit hetzelfde BroadWorks.

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

• De synchronisatie negeert gebruikers die geen telefoonnummer hebben.

• In Partner hub kunt u de gegevens van de synchronisatiestatus van een bepaalde klant weergeven. Daarnaast kunt u gedetailleerde informatie over de laatste synchronisatie naar een CSV-record exporteren. Het CSV-record bevat meer details dan de weergave van Control Hub en kan helpen bij het oplossen van problemen, analyses en controles.

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

• Voor gebruikers die alleen bellen via BroadWorks en entiteiten die niet van gebruikers bellen, worden met deze functie de volgende telefoonnummertypen van BroadWorks gesynchroniseerd:

  • Primair telefoonnummer

  • Mobiel telefoonnummer

  • Extensie

  Sync sluit echter uit dat gebruikers die alleen bellen via BroadWorks en niet-gebruikers bellen, niet bij de synchronisatie vallen 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 maximaal contactpersonen

Directorysynchronisatie synchroniseert ook broadWorks-telefoonlijst vermeldingen met Webex-contactpersonen. Gesynchroniseerde vermeldingen worden toegevoegd aan een van de volgende typen contactpersonen:

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

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

In de volgende tabel worden de Webex-contacttypen weergegeven aan de hand van de contactbron (gesynchroniseerd via een broadWorks-telefoonlijst of handmatig toegevoegd):

De volgende voorwaarden zijn van toepassing rond de manier waarop adreslijstsynchronisatie contact maximums 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 uitgezonden contactpersonen.

• Als een van uw klanten het maximaal toegestane aantal contactpersonen in een van beide categorieën overschrijdt, raden we u aan een case bij Cisco op te stellen zodat die organisatie niet kan worden uitgesloten van de telefoonlijstsynchronisatie.

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

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

Updates

De volgende manier waarop de Webex-directory omgaat met updates:

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

• Als het telefoonnummer van de contactpersoon wordt gewijzigd in BroadWorks, werkt Webex de bestaande contactpersoon in de Webex-directory bij met het nieuwe nummer.

Nadat een beheerder een contactpersoon bijwerkt op BroadWorks, geven de volgende voorwaarden aan wanneer de update wordt weergegeven in de Webex-app van een gebruiker:

• Als de update alleen voor een bellende gebruiker van BroadWorks of een bellende entiteit die niet van gebruikers is, wordt de update weergegeven in de Webex-app van een gebruiker onmiddellijk na de volgende directorysynchronisatie.

• Als de update geldt voor een telefoonlijst uit BroadWorks:

  • Contactpersonen van gebruiker: updates worden onmiddellijk 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 van de organisatie: de Webex-directory wordt bijgewerkt bij de volgende directorysynchronisatie, maar gebruikers zien deze wijziging niet in de Webex-app totdat ze de Webex-app opnieuw opstarten of totdat de lokale cachetimer van 72 uur verloopt.

We raden u aan de volgende instellingen te gebruiken:

• Waarden voor het beperken van waarden: stel de volgende eigenschappen van OverbelastingControlesysteem in (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit: instellen op een null-waarde.

  • globalDirectoryTransactionLimit: instellen op een null-waarde.

  Het wordt aanbevolen dat u userDirectoryTransactionLimit en globalDirectoryTransactionLimit in stellen op een null-waarde. Als u echter besluit waarden toe te wijzen, moet elke waarde ten minste vijf keer worden ingesteld op de waarde van transactieLimitPeriod Milliseconden (dat 1 moet zijn).

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

  • userTransactionLimit: ingesteld op ten minste 100.

  • transactieLimitPeriodSecs: stel in op 1.

• Pagingwaarden: stel de eigenschappen van het pagingsysteem in (XSP_CLI/Toepassingen/Xsi-Acties/Paging):

  • defaultPageSize: instellen op 50

  • availableUserMaxLimit - Instellen op 100

• CTI-interface: zorg ervoor dat u de Webex CA-certificaten uploadt naar de trust store van de CTI-interface en dat de clientverificatie wordt ingeschakeld via de CTI-interface.

Afhankelijk van uw BroadWorks-release raden we u ook aan de volgende systeempatches toe te passen op de BroadWorks-implementatie voordat u deze functie inschakelen:

• Voor R22: AP.as.22.0.1123.ap368517

• Voor R23: AP.as.23.0.1075.ap368517

• Voor R24: geen patch vereist

Partnerbeheerders kunnen Telefoonlijstsynchronisatie inschakelen voor een klantsjabloon terwijl ze de nieuwe sjabloon maken. Voor nieuwe klantorganisaties die aan die sjabloon zijn toegewezen, is telefoonlijstsynchronisatie 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 ten minste één keer op het tabblad Contactpersonen in de Webex-app moeten klikken om de functie in de Webex-app in te stellen. Dit hoeft maar één keer te worden voltooid.

Openbare API's zijn beschikbaar op developer.webex.com waarmee partnerbeheerders de instellingen voor telefoonlijstsynchronisatie kunnen bijwerken voor de klantenorganisaties die zij beheren, om een directe synchronisatie te activeren of synchronisatiestatusgegevens te verkrijgen. De methoden voor het synchroniseren van adressenlijst worden gegroepeerd onder BroadWorks-ondernemingen:

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

• Adreslijstsynchronisatie voor een BroadWorks Enterprise bijwerken: voer de Enterprise-id in om de status van de adreslijstsyc voor die onderneming bij te werken, door adreslijstsynchronisatie in of uit te schakelen.

• Adreslijstsynchronisatie activeren voor een Enterprise: gebruik deze API-methode als u een onmiddellijke synchronisatie wilt activeren voor een bepaalde Enterprise-id. Voor de syncStatus voert u de opdracht SYNC_NOW in.

• Get Directory Sync Status for an Enterprise: voer de Enterprise id in en voer deze uit om een status en trackingId van de nieuwste synchronisatie op te halen. U kunt de trackingID gebruiken om aanvullende analyses uit te voeren via tools zoals Kibana en Grafana.

Daarnaast kunnen beheerders de Directorysynchronisatie triggeren voor een API voor enkele gebruiker gebruiken om een on-demand directorysynchronisatie voor één gebruiker te activeren.

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

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 adreslijstsynchronisatie.

In de volgende tabel worden de updates van dit artikel samengevat.