Katalogsynkronisering säkerställer att Webex för Cisco BroadWorks-användare kan använda Webex-katalogen från Webex-appen för att ringa upp alla samtalsenhet från BroadWorks-servern. Den här funktionen synkroniserar BroadWorks-samtalsinformation som inte ingick i användareablering till Webex-katalogen.

Webex för Cisco BroadWorks-användares etablering uppdaterar Webex-katalogen med samtalsinformation för Webex för Cisco BroadWorks-användare (primärt telefonnummer, mobiltelefonnummer, anknytning), men utelämnar externa samtalsregister. Men när katalogsynkronisering är på synkroniseras även följande samtalsposter med Webex-katalogen.

• BroadWorks-only calling users (who are not onboarded to Webex)

• Enheter som inte använder uppringning (t.ex. en konferensrum telefon, fax, sökgrupp nummer)

• BroadWorks telefonlista

Följande tabell sammanfattar BroadWorks-samtalsposter och visar hur de läggs till i Webex-katalogen.

Villkor för katalogsynkronisering

• Partneradministratörer måste aktivera funktionen på partnernivå. Partneradministratörer kan slå på eller av funktionen för flera kundorganisationer i en enda åtgärd.

• Som standard sker den första synkroniseringen en vecka efter aktiveringen av synkroniseringen (den tid som väljs för att starta synkroniseringen är slumpmässig). Kundorganisationer kan dock använda alternativet Synkronisering n u för att kringgå vänteperioden på en vecka och utlösa en omedelbar synkronisering för en viss kundorganisation.

• Som standard körs katalogsynkronisering varje vecka för varje kund. Varje synkronisering sker en vecka efter den senaste synkroniseringen, oavsett om den senaste synkroniseringen schemalades eller utlöstes manuellt med Synkronisera nu.

• Max antal samtidiga synkroniseringar per BroadWorks-kluster är två: ett schemalagt synkroniserings- och ett on-demand-synkronisering (via API eller partnerhubb-GUI). Administratörer kan dock inte köra två synkroniserade on-demand samtidigt från samma BroadWorks. Den här begränsningen finns oavsett om synkroniseringen initierades via API:en eller via alternativet Synkronisera nu i partnerhubben. Dessutom kommer Webex inte schemalägga två schemalagda synkroniseringar som ska köras samtidigt från samma BroadWorks.

• Om ett synkroniseringsfel uppstår försöker Webex automatiskt att synkronisera var 24:e timme till och med nästa schemalagda synkronisering.

• Synkroniseringen ignorerar användare som inte har ett telefonnummer.

• I partnerhubben kan du visa information om synkroniseringsstatus för en viss kund. Dessutom kan du exportera detaljerad information om den senaste synkroniseringen till en CSV-post. CSV-posten ger mer information än visningen av Control Hub och kan hjälpa dig med felsökning, analyser och granskning.

• Webex sparar användarkontakter i ett krypterat format. Endast användaren som äger kontakten har åtkomst till dekrypteringsnyckeln.

• För broadWorks-uppringande användare och enheter som inte använder användare synkar denna funktion följande telefonnummertyper från BroadWorks:

  • Primärt telefonnummer

  • Telefonnummer (mobil)

  • Anknytning

  Men synkroniseringen exkluderar BroadWorks-endast-uppringande användare och enheter som inte använder användare från synkroniseringen om varken ett primärt telefonnummer eller tillägg finns.

  Inställningen för personlig skyddstjänst på användarnivå för Broad Works stöds inte som en del av katalogsynkronisering.

Max för BroadWorks-telefonlista och kontakt

Katalogsynkronisering synkar även BroadWorks telefonlistposter till Webex-kontakter. Synkroniserade poster läggs till i en av följande kontakttyper:

• Organisationskontakter – Webex sparar dessa kontakter mot en organisation. Varje användare kan få åtkomst till organisationens kontakter för sin organisation. Maximalt är upp till 30000 kontakter.

• Användarkontakter—I Webex lagras dessa kontakter mot en användare. Endast användaren som äger kontakten kan komma åt kontaktposten. Max antal är upp till 2 000 kontakter (1 500 synkroniserade kontakter + 500 manuella kontaktkontakter).

Följande tabell över mappar Webex-kontakttyper mot kontaktkällan (synkroniseras från en BroadWorks-telefonlista eller läggs till manuellt):

Följande villkor gäller för hur Directory Sync hanterar kontakt maximum:

• Om en organisation överskrider de maximala tillåtna kontakterna för synkroniseringen (30000 organisationskontakter eller 30000 gruppkontakter per grupp) utesluter katalogsynkronisering poster över det maximala tröskelvärdet. Det finns ingen särskild ordning tillämpad på synkroniserade eller utelämnade kontakter.

• Om en av dina kunder överskrider det maximalt tillåtna antalet kontakter i någon av kategorin rekommenderar vi att du tar upp ett ärende med Cisco för att utesluta denna organisation från katalogsynkronisering.

• Manuella kontakter är kontakter som en användare lägger till manuellt i Webex-appen. En användare kan lägga till upp till 500 manuella kontakter. Manuella kontakter tillhör den större användarkontaktkategorin på Webex, men är inte inkluderade i synkroniseringen.

• Den totala kombinerade gränsen för organisationskontakter (3 0000) och gruppkontakter (3 0000 per grupp) är 200 000.

Uppdateringar

Följande är hur Webex-katalogen hanterar uppdateringar:

• Om kontaktnamnet ändras i BroadWorks tas den befintliga kontakten bort från Webex-katalogen och en ny kontakt skapas.

• Om kontaktnumret ändras i BroadWorks uppdaterar Webex den befintliga kontakten i Webex-katalogen med det nya numret.

När en administratör har uppdaterat en kontakt på BroadWorks beskrivs följande villkor när uppdateringen visas i en användares Webex-app:

• Om uppdateringen gäller en BroadWorks-uppringande användare eller en enhet som inte använder användare visas uppdateringen i en användares Webex-app omedelbart efter den efterföljande katalogsynkronisering.

• Om uppdateringen gäller en BroadWorks-telefonlista:

  • För användarkontakter – uppdateringar visas i användarens Webex-app omedelbart efter den efterföljande katalogsynkronisering.

  • För gruppkontakter – uppdateringar visas i användarnas Webex-appen omedelbart efter efterföljande katalogsynkronisering.

  • För organisationskontakter – Webex-katalogen uppdateras vid efterföljande katalogsynkronisering, men användarna kommer inte att se ändringen i Webex-appen förrän de startar om Webex-appen eller tills den lokala cachetimeren på 72 timmar går ut.

Vi rekommenderar att du använder följande inställningar:

• Hastighetsbegränsningsvärden – ställ in följande överbelastningskontrollsystemegenskaper (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit – Ange som null-värde.

  • globalDirectoryTransactionLimit – Ange som null-värde.

  Du rekommenderas att ange userDirectoryTransactionLimit och globalDirectoryTransactionLimit till ett null-värde. Om du däremot bestämmer dig för att tilldela värden måste varje anges till minst fem gånger värdet på transaktionenLimitPeriodSeconds (vilket ska vara 1).

• Transaktionsgränser – Ange följande värden (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit – Ställ in till minst 100.

  • transactionLimitPeriodSecs – Ställ in till 1.

• Ansökningsvärden – ange egenskaper för personsökningssystemet (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – Ställ in till 50

  • tillgängligUserMaxLimit – ställ in på 100

• CTI-gränssnitt – Se till att överföra att Webex CA-certifikat till den betrodda lagringen av CTI-gränssnittet och att aktivera klientautentisering i CTI-gränssnittet.

Beroende på din BroadWorks-version rekommenderar vi dessutom att du tillämpar följande systemfixar för BroadWorks-distribution innan du aktiverar denna funktion:

• För R22: AP.as.22.0.1123.ap368517

• För R23: AP.as.23.0.1075.ap368517

• För R24: ingen programfix krävs

Partneradministratörer kan aktivera Katalogsynkronisering för en kundmall medan de skapar den nya mallen. Alla nya kundorganisationer som tilldelas den mallen kommer att ha katalogsynkronisering aktiverat. Mer information finns i "Konfigurera kundmallar" i Konfigurera din partnerorganisation i partnerhubben i Lösningsguiden för Webex för Cisco BroadWorks.

Nästa steg

Se till att användarna vet att de måste klicka på fliken Kontakter på Webex-appen minst en gång för att kunna aktivera funktionen i Webex-appen. Detta behöver bara slutföras en gång.

Offentliga API:er finns tillgängliga developer.webex.com gör det möjligt för partneradministratörer att uppdatera katalogsynkroniseringsinställningar för kundorganisationer som de hanterar, att utlöse en omedelbar synkronisering eller hämta synkroniseringsstatusinformation. Katalogsynkroniseringsmetoderna är grupperade under BroadWorks-företag:

• Lista BroadWorks-företag – använd den här API-metoden för att hämta en lista över företag under en viss tjänsteleverantör och varje företags ID. Du måste ange spEnterpriseId som tilldelat i etableringen.

• Uppdatera katalogsynkronisering för ett BroadWorks Enterprise – ange företags-ID för att uppdatera katalogsyc-status för företaget och aktivera eller inaktivera katalogsynkronisering.

• Utlös katalogsynkronisering för ett företag – använd den här API-metoden om du vill utlösa en omedelbar synkronisering för ett visst företags-ID. För syncStatus anger du kommandot SYNC_NOW .

• Hämta status för katalogsynkronisering för ett företag – ange företags-ID och kör för att få status och trackingId för den senaste synkroniseringen. Du kan använda trackingID för att köra ytterligare analyser via verktyg som Kibana och Grafana.

Dessutom kan administratörer använda Utlösa katalogsynkronisering för en enskild användares API för att utlösa en katalogsynkronisering on-demand för en enskild användare.

Detaljerad API-dokumentation finns i https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Du måste logga in för att läsa API-specifikationen på https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Följande felkoder gäller för katalogsynkronisering.

Följande tabell sammanfattar uppdateringar av den här artikeln.