- Start
- /
- Artikel
Adressenlijstsynchronisatie in Webex voor Cisco Broadworks
Dit artikel beschrijft hoe u directorysynchronisatie in Webex voor Cisco BroadWorks implementeert. Het artikel is bestemd voor serviceprovider bij partnerorganisaties.
Overzicht telefoonlijstsynchronisatie
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.
BroadWorks-belrecords |
Beschrijving |
Toegevoegd aan webex-directory via... |
---|---|---|
Webex voor gebruikers van Cisco BroadWorks |
Gebruikers zijn ingeschakeld voor Webex for Cisco BroadWorks |
Gebruikers provisioning (bijv. flowthrough provisioning) |
Gebruikers die alleen bellen via BroadWorks |
Bellende gebruikers die niet zijn verbonden met Webex |
Directorysynchronisatie |
Entiteiten die niet bellen via een gebruiker |
Bijvoorbeeld een telefoon conferentieruimte faxapparaat, Hunt-groepsnummer |
Directorysynchronisatie |
BroadWorks-telefoonlijsten |
BroadWorks-telefoonlijst vermeldingen:
|
Directorysynchronisatie (telefoonlijstsynchronisatie) |
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 synchronisere n 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 contacten.
-
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):
Webex-contacttype |
Contact bron |
Maximum |
Gesynchroniseerd via BroadWorks... |
API gebruikt voor synchronisatie |
---|---|---|---|---|
Contactpersonen van organisatie |
Directorysynchronisatie |
30000 contacten |
Enterprise algemene telefoonlijsten |
|
Groepstelefoonlijsten (voor serviceprovider groep)** |
| |||
Contactpersonen gebruiker |
Directorysynchronisatie |
1500 contactpersonen |
Lijsten met persoonlijke telefoons | /telefoonlijsten/persoonlijk |
Handmatig toegevoegd door gebruiker |
500 contactpersonen |
N.v.t. |
N.v.t. | |
Contactpersonen groeperen |
Synchroniseren met Directory |
30000 contacten per groep |
Groeps algemene telefoonlijsten (voor een Enterprise-groep)** | /mappen/groupcommon |
**De lijsten met algemene groepstelefoonlijsten worden verschillend gesynchroniseerd, afhankelijk van of BroadWorks in de Enterprise-modus of serviceprovider modus is. De waarde van de parameter isBroadWorksEnterprise
(waar of onwaar) bepaalt hoe de lijst wordt gesynchroniseerd:
-
Waar: synchroniseren als groepscontactpersoon
-
False: synchroniseren als contactpersoon van de organisatie
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.
-
Vereisten voor directorysynchronisatie
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
Directorysynchronisatie inschakelen (nieuwe sjabloon)
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.
Directorysynchronisatie inschakelen (bestaande sjabloon)
1 |
Meld u aan bij Partner Hub en kies Instellingen. |
2 |
Blader naar Bellen via BroadWorks en klik op sjablonen weergeven. |
3 |
Selecteer de geschikte klantsjabloon en blader naar BroadWorks-adreslijstsynchronisatie. |
4 |
U kunt als volgende de adreslijstsynchronisatie standaard inschakelen voor nieuwe klantinstellingen die deze sjabloon gebruiken: |
5 |
Adreslijstsynchronisatie inschakelen voor bestaande klantorganisaties die deze sjabloon gebruiken: Als u directorysynchronisatie wilt uitschakelen, volgt u de bovenstaande procedure en:
|
De volgende stap
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.
Directe synchronisatie activeren
1 |
Meld u aan bij Partnerhub ( http://admin.webex.com) en kies Instellingen. |
2 |
Blader naar Bellen via BroadWorks en klik op sjablonen weergeven. |
3 |
Selecteer de geschikte klantsjabloon en blader naar BroadWorks-adreslijstsynchronisatie. |
4 |
Klik op Lijst met synchronisatiestatussen van klanten weergeven. |
5 |
Voor de klantorganisatie die u wilt synchroniseren, klikt u op de drie stippen aan de rechterkant en selecteert u Nu synchroniseren. |
6 |
Klik op Vernieuwen om de synchronisatieresultaten te bekijken. |
Synchronisatierecords exporteren naar CSV
1 |
Meld u aan bij Partnerhub ( http://admin.webex.com) en kies Instellingen. |
2 |
Blader naar Bellen via BroadWorks en klik op sjablonen weergeven. |
3 |
Selecteer de geschikte klantsjabloon en blader naar BroadWorks-adreslijstsynchronisatie. |
4 |
Klik op Lijst met synchronisatiestatussen van klanten weergeven. |
5 |
Vink de selectievakjes aan voor elke organisatie die u bij het exporteren wilt opnemen. |
6 |
Klik op Resultaten exporteren. |
Openbare API's voor telefoonlijstsynchronisatie
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:
-
BroadWorks-ondernemingen weergeven: gebruik deze API-methode om een lijst met ondernemingen te verkrijgen onder een bepaalde serviceprovider en de
id
van elke onderneming. U moet despEnterpriseId
invoeren zoals toegewezen in de inrichting. -
Adreslijstsynchronisatie bijwerken voor een BroadWorks Enterprise: voer de enterprise-
id
in om de status van de adreslijstsynchronisatie voor die onderneming bij te werken. -
Adreslijstsynchronisatie voor een Enterprise activeren: gebruik deze API-methode als u een directe synchronisatie voor een bepaalde Enterprise-
id
wilt activeren. Voer voor desyncStatus
de opdrachtSYNC_NOW
in. -
Status van adressenlijstsynchronisatie voor een onderneming ophalen: voer de enterprise-
id
in en voer het uit om een status entracking-id
van de laatste synchronisatie op te halen. U kunt detrackingID
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.
Meerdere ondernemingen synchroniseren met API
-
Met Directorysynchronisatie kunt u slechts één onderneming uit een Broadworks-cluster tegelijk synchroniseren via een on-demand synchronisatie. Als u probeert meer dan één onderneming te synchroniseren, krijgt u een 429-foutmelding
-
De tijd die nodig is om een synchronisatie voor één onderneming te starten, hangt af van de grootte van de onderneming.
1 |
Voer de List BroadWorks Enterprises API uit om een lijst met ondernemingen te genereren die u wilt synchroniseren. |
2 |
Voer de Trigger Directory Sync voor een Enterprise API uit op de eerste enterprise in de lijst. |
3 |
Wacht enkele seconden en voer vervolgens de API 'Synchronisatiestatus van telefoonlijst' uit om de synchronisatiestatus te krijgen. |
4 |
Als de synchronisatie is voltooid, voltooit u stap 2 tot en met 4 op de volgende onderneming in de lijst. Herhaal deze stappen tot u de hele lijst hebt gesynchroniseerd. |
Foutcodes voor telefoonlijstsynchronisatie
De volgende foutcodes zijn van toepassing op adreslijstsynchronisatie.
Foutcode |
Foutbericht |
---|---|
600000 |
Onverwachte fout in BroadWorks-gebruikerssynchronisatie van externe adressenlijst. |
600001 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is mislukt. |
600002 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst moest vóór voltooiing worden beëindigd. |
600003 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is slechts gedeeltelijk voltooid. Het synchroniseren van enkele klantorganisaties is mislukt. |
600004 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is niet ingeschakeld voor de ConfigSet. |
600005 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst wordt uitgevoerd voor de ConfigSet. |
600006 |
Threads van BroadWorks-gebruikerssynchronisatie van externe adressenlijst zijn bezet of worden gesloten en accepteren daarom geen nieuwe synchronisatieverzoeken. Probeer het later opnieuw. |
600007 |
De identiteitsorganisatie van de CustomerConfig is niet gevonden. |
600008 |
De CustomerConfig is niet gevonden in de partnerorganisatie. |
600009 |
Broadworks External Directory User Sync kan niet worden uitgevoerd omdat het Broadworks-cluster dat is gekoppeld aan CustomerConfig bezet is. |
600010 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan niet worden uitgevoerd omdat er geen BroadWorks-cluster is gekoppeld aan de CustomerConfig. |
600011 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is niet ingeschakeld voor de CustomerConfig. |
600012 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan niet worden uitgevoerd omdat synchronisatie van hybride adressenlijst al is ingeschakeld voor de CustomerConfig. |
600013 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst kan geen gebruikers- en machineaccounts toevoegen aan de identiteitsopslag. |
600014 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst is mislukt tijdens het maken van verbinding met het BroadWorks-cluster. Fout van Broadworks - %s. |
600015 |
BroadWorks-gebruikerssynchronisatie van externe adressenlijst heeft geen overeenkomende gebruiker gevonden in de identiteitsopslag. |
600017 |
Het synchroniseren van broadWorks-telefoonlijstsynchronisatie is mislukt voor het synchroniseren van alle contactpersonen voor gebruikers en ondernemingen/organisaties. |
600018 |
BroadWorks-telefoonlijstsynchronisatie is mislukt voor gebruikers in de onderneming/organisatie. |
600019 |
BroadWorks Phone List Sync is mislukt voor het synchroniseren van zakelijke/organisatiecontacten. |
600020 |
BroadWorks External Directory User Sync kan niet worden uitgeschakeld omdat de CustomerConfig-synchronisatie bezig is. |
600022 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat de onderneming geen gebruikers heeft ingericht. |
600023 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat de gebruiker al bestaat in deze organisatie. |
600024 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat er geen overeenkomende gebruiker is gevonden in BroadWorks. |
600025 |
BroadWorks External Directory-gebruikerssynchronisatie kan de instellingen gebruikersaccount CI niet bijwerken. |
600026 |
BroadWorks External Directory-gebruikerssynchronisatie is mislukt voor het bijwerken van het machine-account in CI. |
600027 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat meerdere gebruikers in BroadWorks zijn gevonden. |
600028 |
BroadWorks External Directory Single User Sync is niet mogelijk omdat ten minste één Enterprise-directorysynchronisatie moet zijn voltooid. |
600029 |
BroadWorks External Directory-gebruikerssynchronisatie is mislukt omdat de organisatie geen gebruikers heeft ingericht. |
Wijzigingsgeschiedenis
In de volgende tabel worden de updates van dit artikel samengevat.
Datum |
Revisie |
---|---|
14 februari 2023 |
Het gedeelte Maximums en bron voor telefoonlijstsynchronisati e is bijgewerkt. |
10 december 2022 |
De term Complete Immediate Syn c is bijgewerkt naar Trigger Directory Sync |
19 juli 2022 |
Toelichtingen en correcties voor overzichtsinformatie:
|
9 mei 2022 |
|
7 april 2022 |
|
28 maart 2022 |
|
24 maart 2022 |
Lijst van gesynchroniseerde telefoonnummertypen toegevoegd aan de voorwaarden voor telefoonlijstsynchronisatie. De synchronisatie omvat nu mobiele telefoonnummers. |
16 maart 2022 |
|
17 december 2021 |
|
16 december 2021 |
|
8 december 2021 |
|