Overzicht telefoonlijstsynchronisatie

Directorysynchronisatie zorgt ervoor dat webex voor Cisco BroadWorks-gebruikers de Webex-directory kan gebruiken om elke belentiteit vanaf de BroadWorks-server te bellen. Als deze functie is ingeschakeld, wordt de volledige adressenlijst voor bellen vanaf de BroadWorks-server gesynchroniseerd met de Webex-map. Gebruikers kunnen de directory vanuit de Webex-app openen en een oproep plaatsen naar elke belentiteit vanaf de BroadWorks-server.

Telefoonlijstsynchronisatie omvat het synchroniseren van telefoonlijstinformatie van gebruikers en telefoonlijsten. Records met gesynchroniseerde telefoonlijst worden geschreven naar één van de twee typen contactpersonen in de Webex-directory:

  • Organisatiecontacten: deze contactpersonen worden tegen een organisatie opgeslagen en zijn beschikbaar voor elke gebruiker in de organisatie.

  • Contactpersonen gebruiker: deze contactpersonen worden opgeslagen tegen een gebruiker en zijn alleen beschikbaar voor de gebruiker die de eigenaar van de contactpersoon is.


De provisioning van Webex voor Cisco BroadWorks omvat een standaardsynchronisatie van gebruikers van berichten en de bijbehorende belgegevens van de BroadWorks-server naar de Webex-directory. Bij de standaard provisioningsynchronisatie worden gebruikers die geen berichten verzenden en niet-gebruikers (bijvoorbeeld een telefoon conferentieruimte telefoon, faxapparaat of nummer Hunt-groep weglaten). Door telefoonlijstsynchronisatie in te voegen, worden alle belbedrijven toegevoegd aan de Webex-directory.

Voorwaarden telefoonlijstsynchronisatie

  • Partnerbeheerders moeten de functie in turnen op partnerniveau. 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). Klantenorganisaties kunnen echter de optie Nu synchroniseren gebruiken om de wachtperiode van een week over te gaan en een directe synchronisatie voor een bepaalde klantorganisatie te voltooien.

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

  • Als er een synchronisatiefout optreedt, wordt de synchronisatie automatisch elke 24 uur opnieuw gepland 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 is gedetailleerder dan de weergave van Control Hub en kan helpen bij het oplossen van problemen, analyses en controles.

  • Contactpersonen van gebruikers worden in een gecodeerde indeling opgeslagen, met alleen de gebruiker die eigenaar is van de contactpersoon die toegang heeft tot de decoderingssleutel.

  • Deze functie synchroniseert de volgende telefoonlijsttypen van de BroadWorks-server:

    • Enterprise algemene telefoonlijsten

    • Groeps algemene telefoonlijsten

    • Lijsten met persoonlijke telefoons

Adreslijstsynchronisatie en contact max.

Voor elk Webex-contacttype kan het volgende het maximale aantal contactpersonen worden gesynchroniseerd:

  • 500 contactpersonen voor de organisatie

  • 500 contactpersonen voor gebruikers: voor een gebruiker bevat het maximum gesynchroniseerde gebruikerscontacten en handmatige contactpersonen (contactpersonen die de gebruiker handmatig toevoegt via de Webex-app)

De volgende voorwaarden zijn van toepassing:

  • Als een organisatie meer dan 500 contactpersonen in een van deze categorieën heeft, sluit de synchronisatie geen vermeldingen boven de drempel van 500 contactpersonen uit. Er is geen specifieke volgorde toegepast op gesynchroniseerde of uitgezonden contactpersonen.

  • Als een gebruiker contactpersonen handmatig toevoegt aan de Webex-app, wordt het maximale aantal contactpersonen voor Gebruiker bepaald door de handmatige contactpersonen af te trekken van gesynchroniseerde gebruikerscontacten. Als een gebruiker bijvoorbeeld handmatig 100 contactpersonen aan de Webex-app toevoegt, kunnen met directorysynchronisatie maximaal 400 contactpersonen worden gesynchroniseerd met BroadWorks voor die gebruiker.

  • We raden aan dat als een van uw klantenorganisatie meer dan 500 contactpersonen in een van beide categorieën heeft, een case bij Cisco op te leggen zodat die organisatie niet kan worden uitgesloten van de telefoonlijstsynchronisatie.

De volgende tabel voegt de Typen Webex-contactpersonen toe aan de BroadWorks-telefoonlijst van waaruit de records worden gesynchroniseerd:

Tabel 1. Contacttypen telefoonlijstsynchronisatie en synchronisatiebron

Webex-contacttype

Gesynchroniseerd via BroadWorks...

API gebruikt voor synchronisatie

Contactpersonen binnen de organisatie

Enterprise algemene telefoonlijsten

/directories/enterprisecommon

Groepslijst algemene telefoon (in serviceprovider modus)**

/directories/groupcommon

Contactpersonen gebruiker

Groeps algemene telefoonlijsten (terwijl ze in de Enterprise-modus zijn)**

/directories/groupcommon

Lijsten met persoonlijke telefoons

/directories/personal


**Lijsten met algemene groepstelefoons worden verschillend gesynchroniseerd, afhankelijk van of BroadWorks in de Enterprise-modus of serviceprovider werkt. De waarde van de isBroadWorksEnterprise parameter (waar of onwaar) bepaalt hoe de lijst wordt gesynchroniseerd:

  • Waar: synchroniseren als contactpersoon van de organisatie

  • False: synchroniseren als contactpersoon

Updates

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

  • Updates voor contactpersonen binnen de organisatie worden weergegeven in de Webex-app nadat de gebruiker de app opnieuw heeft gestart of nadat de lokale cachetimer van de 72 uur van de app is verlopen.

  • Updates voor gebruikerscontact worden onmiddellijk weergegeven in de Webex-app voor die gebruiker.

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 contactnummer wordt gewijzigd in BroadWorks, wordt de bestaande contactpersoon in de Webex-adressenlijst bijgewerkt met het nieuwe nummer.

Vereisten voor directorysynchronisatie

Vereisten voor in-/uitschakelen

De volgende functie-opties bestaan voor deze functie. Neem contact op met uw Cisco BroadWorks-vertegenwoordiger van Webex om deze in te stellen.

Functie in-/uitschakelen

Toegepast op...

Beschrijving

webex-for-broadworks-phone-list-sync

Partner

Verplichte schakelaar. Hiermee worden telefoonlijstsynchronisatie voor alle klantorganisaties onder deze partner mogelijk.

Moet zijningeschakeld.

webex-for-broadworks-phone-list-sync-disable

Klantorganisatie

Optionele schakelaar. Schakelt telefoonlijstsynchronisatie uit voor een bepaalde organisatie, zelfs als de functie is ingeschakeld op partnerniveau en in de klantsjabloon.

Pas deze schakelaar alleen toe als u telefoonlijstsynchronisatie wilt uitschakelen voor een specifieke klantorganisatie. Anders kunt u dit uitgeschakeld laten.


 
U kunt deze schakelaar bijvoorbeeld toepassen op organisaties waarvoor meer dan 500 contactpersonen vereist zijn.

hidden-personal-contacts-enabled-ga

Gebruiker

Optionele schakelaar. Hiermee worden persoonlijke contactpersonen verborgen in directory-zoekopdrachten die zijn voltooid door deze gebruiker.

hidden-org-contacts-enabled-ga

Gebruiker

Optionele schakelaar. Hiermee worden de contactpersonen van de organisatie verborgen voor directory-zoekopdrachten die zijn voltooid door deze gebruiker.

Vereisten voor vooraf configureren

We raden u aan de volgende instellingen te gebruiken:


In de onderstaande voorbeelden wordt aangenomen dat u een XSP-server gebruikt. Vervang (XSP CLI) voor ADP-servers_door (ADP_CLI).
  • 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:


Zie BroadWorks-softwarevereisten in de Oplossingshandleiding voor Webex voor Cisco BroadWorks voor de volledige lijst met patchvereisten die de minimale vereiste vormen voor Webex voor Cisco BroadWorks.

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

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)

Partnerbeheerders kunnen de volgende stappen uitvoeren om Telefoonlijstsynchronisatie in een bestaande klantsjabloon in teschakelen, zodat de functie wordt ingeschakeld voor de klantorganisaties die de sjabloon gebruiken.

1

Meld u aan bij Partner Hub en kies Instellingen.

2

Blader naar Bellen via BroadWorks en klik op Weergeven sjablonen.

3

Selecteer de geschikte klantsjabloon en blader naar BroadWorks-telefoonlijstsynchronisatie.

4

U kunt als volgende de adreslijstsynchronisatie standaard inschakelen voor nieuwe klantinstellingen die deze sjabloon gebruiken:

  1. Stel broadWorks-directory en telefoonlijstsynchronisatie inschakelen in voor alle nieuwe klantorganisaties inschakelen op .

  2. Klik op Opslaan.

5

Adreslijstsynchronisatie inschakelen voor bestaande klantorganisaties die deze sjabloon gebruiken:

  1. Klik op Lijst met synchronisatiestatus van klantenweergeven.

  2. Schakel de selectievakjes naast elkaar in voor elke organisatie waarvoor u de functie wilt in turnen.

  3. Klik op Synchronisatie inschakelen.


 

Als u directorysynchronisatie wilt uitschakelen, volgt u de bovenstaande procedure en:

  • Stel in stap 4a telefoonlijstsynchronisatie inschakelen voor alle nieuwe klantorganisaties in op Uitschakelen om directorysynchronisatie standaard uit te schakelen voor nieuwe klantorganisaties die deze sjabloon gebruiken.

  • Klik in stap 5c op Synchronisatie uitschakelen om de functie uit te schakelen voor bestaande organisaties.

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 voltooien

Met de optie Nu synchroniseren kan de partnerbeheerder een on-demand synchronisatie voltooien voor een bepaalde klantorganisatie. Deze optie kan alleen worden geselecteerd voor individuele klantenorganisaties: er is geen bulkoptie voor Nu synchroniseren.

1

Meld u aan bij Partner hub (http://admin.webex.com) en kies Instellingen.

2

Blader naar Bellen via BroadWorks en klik op Weergeven sjablonen.

3

Selecteer de geschikte klantsjabloon en blader naar BroadWorks-telefoonlijstsynchronisatie.

4

Klik op Lijst met synchronisatiestatus van klantenweergeven.

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

Partnerbeheerders kunnen gedetailleerde informatie over de laatste synchronisatie naar een CSV-bestand exporteren. Het CSV-bestand bevat een gedetailleerdere weergave van de synchronisatierecord dan de Control Hub-GUI en kan helpen bij het oplossen van problemen en analyses.

1

Meld u aan bij Partner hub (http://admin.webex.com) en kies Instellingen.

2

Blader naar Bellen via BroadWorks en klik op Weergeven sjablonen.

3

Selecteer de geschikte klantsjabloon en blader naar BroadWorks-telefoonlijstsynchronisatie.

4

Klik op Lijst met synchronisatiestatus van klantenweergeven.

5

Vink de selectievakjes aan voor elke organisatie die u bij het exporteren wilt opnemen.

6

Klik op Exportresultaten.

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 Enterprises. Er zijn vier API's:

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

  • Directorysynchronisatie voor een BroadWorks Enterprise bijwerken: voer het bedrijf in id om de syc-status van de telefoonlijst voor die onderneming in of uit te werken.

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

  • Status van telefoonlijstsynchronisatie voor een Enterprise weergeven: voer de onderneming in id en uitvoeren om een status en trackingId van de nieuwste synchronisatie. U kunt de trackingID om aanvullende analyses uit te voeren via tools zoals Kibana en Erana.

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

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

Voltooi deze procedure om de openbare API's te gebruiken om het synchroniseren van de telefoonlijst voor meerdere ondernemingen te voltooien.

  • Met Directorysynchronisatie kunt u slechts één onderneming tegelijk synchroniseren. Als u probeert meer dan één onderneming te synchroniseren, krijgt u een 429-foutmelding.

  • De tijd die het duurt om een synchronisatie voor een enkele onderneming te voltooien, varieert afhankelijk 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.

  1. Start Instellen met de beginreeks van de id van de ondernemings- of serviceprovider.

  2. Klik op Uitvoeren.

2

Voer de Trigger Directory Sync voor een Enterprise API uit op de eerste enterprise in de lijst.

  1. Voer de bedrijfs-idin.

  2. SyncStatus instellen op SYNC_NOW

  3. Klik op Uitvoeren.

    Een directe synchronisatie wordt geactiveerd voor het bedrijf. Deze synchronisatie telt mee voor de limiet van één synchronisatie per exemplaar.
3

Wacht enkele seconden en voer vervolgens de API 'Synchronisatiestatus van telefoonlijst' uit om de synchronisatiestatus te krijgen.

  1. Voer de bedrijfs-id in

  2. Klik op Uitvoeren.

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

Broadworks External Directory User Sync onverwachte fout.

600001

Broadworks External Directory-gebruikerssynchronisatie is mislukt.

600002

Broadworks External Directory-gebruikerssynchronisatie moet worden beëindigd voordat deze is voltooid.

600003

Broadworks External Directory User Sync is slechts gedeeltelijk geslaagd. Sommige klantorganisaties synchroniseren is mislukt.

600004

Broadworks External Directory-gebruikerssynchronisatie is niet ingeschakeld voor de configuratieset.

600005

Broadworks External Directory User Sync is bezig voor de configSet.

600006

Broadworks External Directory Sync-threads voor gebruikers zijn bezet of worden afgesloten. Daarom worden geen synchronisatieverzoeken meer geaccepteerd. Probeer het later opnieuw.

600007

De identiteits organisatie van de CustomerConfig is niet gevonden.

600008

De CustomerConfig is niet gevonden in de partner organisatie.

600009

Broadworks External Directory User Sync kan niet worden uitgevoerd omdat het Broadworks-cluster dat is gekoppeld aan CustomerConfig bezet is.

600010

Broadworks External Directory User Sync kan niet worden uitgevoerd omdat er geen broadworks-cluster is gekoppeld aan de CustomerConfig.

600011

Broadworks External Directory User Sync is niet ingeschakeld voor de CustomerConfig.

600012

Broadworks External Directory User Sync kan niet worden uitgevoerd omdat de hybride directorysynchronisatie al is ingeschakeld voor de CustomerConfig.

600013

Broadworks External Directory User Sync kan geen gebruikers- en machineaccounts toevoegen aan de identiteitsopslag.

600014

Broadworks External Directory User Sync is mislukt tijdens het verbinden met de Broadworks-cluster. Fout van Broadworks - %s.

600015

Broadworks External Directory-gebruikerssynchronisatie 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.