Katalogsynkronisering i Webex för Cisco BroadWorks

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 alla samtalsenheter från BroadWorks-servern. Den här funktionen synkroniserar samtalsinformation som inte var en del av användaretableringen till Webex-katalogen.

Webex för Cisco BroadWorks-användaretablering uppdaterar Webex-katalogen med samtalsinformation för Webex för Cisco BroadWorks-användare (primärt telefonnummer, mobiltelefonnummer, anknytning), men utelämnar externa samtalsposter. När katalogsynkronisering är aktiverad synkroniserar dock funktionen även följande samtalsposter till Webex-katalogen.

• Samtalsanvändare som endast arbetar (som inte är registrerade i Webex)

• Samtalsenheter som inte är användare (t.ex. en konferensrumstelefon, faxmaskin, svarsgruppnummer)

• BroadWorks telefonlista poster

Följande tabell sammanfattar samtalsposter i BroadWorks 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 aktivera eller inaktivera funktionen för flera kundorganisationer i en och samma åtgärd.

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

• Katalogsynkronisering körs som standard varje vecka för varje kund. Varje synkronisering inträffar en vecka efter den sista synkroniseringen, oavsett om den senaste synkroniseringen schemalades eller utlöstes manuellt med Synkronisera nu.

• Maximalt antal samtidiga synkroniseringar per BroadWorks-kluster är två: en schemalagd synkronisering och en on-demand-synkronisering (via API eller Partner Hub GUI). Administratörer kan dock inte köra två synkroniseringar på begäran samtidigt från samma Broadverk. Denna begränsning gäller oavsett om synkroniseringen initierades via API eller via alternativet Synkronisera nu i Partner Hub. Dessutom schemalägger Webex inte två schemalagda synkroniseringar som körs samtidigt från samma BroadWorks.

• Om ett synkroniseringsfel inträffar försöker Webex synkroniseringen automatiskt var 24:e timme tills nästa schemalagda synkronisering.

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

• I Partner Hub kan du visa synkroniseringsstatusinformation 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 Control Hub-skärmen och kan hjälpa till med felsökning, analys och revision.

• Webex lagrar användarkontakter i ett krypterat format. Endast den användare som äger kontakten har åtkomst till avkrypteringsnyckeln.

• För BroadWorks-användare och samtalsenheter som inte är användare synkroniserar den här funktionen följande telefonnummertyper från BroadWorks:

  • Primärt telefonnummer

  • Mobiltelefonnummer

  • Anknytning

  Synkronisering utesluter dock endast Broad Works-användare och samtalsenheter som inte är användare från synkroniseringen om inget primärt telefonnummer eller anknytning finns.

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

BredWorks telefonlista och kontaktmaximums

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

• Organisationskontakter – Webex lagrar dessa kontakter mot en organisation. Varje användare kan komma åt organisationskontakter för sin organisation. Maximalt är upp till 30000 kontakter.

• Användarkontakter – Webex lagrar dessa kontakter mot en användare. Endast den användare som äger kontakten kan komma åt kontaktposten. Maximalt är upp till 2 000 kontakter (1 500 synkroniserade kontakter + 500 manuella inmatningskontakter).

Följande tabell mappar Webex-kontakttyper mot kontaktkällan (synkroniserad från en telefonlista för BroadWorks eller tillagd manuellt):

Följande villkor gäller för hur katalogsynkronisering hanterar kontaktmaximivärden:

• 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 beställning som tillämpas på synkroniserade eller uteblivna kontakter.

• Om en av dina kunder överskrider det maximala tillåtna antalet kontakter i någon av kategorierna rekommenderar vi att du tar upp ett ärende med Cisco för att den organisationen ska uteslutas 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 hör till den större kategorin användarkontakt i Webex, men ingår inte 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 Broadfungerar uppdaterar Webex den befintliga kontakten i Webex-katalogen med det nya numret.

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

• Om uppdateringen gäller en samtalsanvändare med endast Broad Works eller en samtalsenhet som inte är användare visas uppdateringen i en användares Webex-app omedelbart efter efterföljande katalogsynkronisering.

• Om uppdateringen är till en telefonlista i BroadWorks:

  • För användarkontakter – uppdateringar visas i användarens Webex-app omedelbart efter 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ändare ser inte ändringen i Webex-appen förrän de startar om Webex-appen eller tills den lokala 72-timmars cachetimern upphör.

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

• Hastighetsbegränsande värden – ange följande systemegenskaper för överbelastningskontroll (XSP_CLI/Applications/Xsi-Actions/Överbelastningskontroll):

  • Användarkatalogtransaktionsgräns – Ställ in på ett nollvärde.

  • globalDirectoryTransactionLimit – Ställ in till ett nollvärde.

  Vi rekommenderar att du ställer in användarkatalogtransaktionsgräns och globalkatalogtransaktionsgräns till ett nollvärde. Men om du bestämmer dig för att tilldela värden måste var och en vara inställd till minst fem gånger värdet av transaktionensLimitPeriodSeconds (vilket bör vara 1).

• Transaktionsgränser – Ställ in följande värden (XSP_CLI/System/CommunicationUtility/Standardinställningar):

  • användartransaktionsgräns – Ställ in på minst 100.

  • TransaktionsLimitperiod Secs – Ställ in på 1.

• Personsökningsvärden – Ange egenskaperna för personsökningssystemet (XSP_CLI/Applications/Xsi-Actions/Sökning):

  • standardstorlek på sidan – Ställ in på 50

  • tillgängligAnvändarmaxgräns – Ställ in på 100

• CTI-gränssnitt – Se till att ladda upp att Webex CA-certifikat till CTI-gränssnittets förtroendearkiv och att aktivera klientautentisering i CTI-gränssnittet.

Beroende på din version av BroadWorks rekommenderar vi dessutom att du använder följande systemkorrigeringar för distribution av BroadWorks innan du aktiverar den här funktionen:

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

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

• För R24: ingen plåster krävs

Partneradministratörer kan aktivera katalogsynkronisering för en kundmall när de skapar den nya mallen. Alla nya kundorganisationer som tilldelas den mallen kommer att ha katalogsynkronisering aktiverad. Mer information finns i ”Konfigurera dina kundmallar” i Konfigurera din partnerorganisation i Partner Hub i lösningsguiden för Webex för Cisco Broad.

Vad du ska göra Nästa

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

Offentliga API:er finns tillgängliga på developer.webex.com som gör det möjligt för partneradministratörer att uppdatera inställningarna för katalogsynkronisering för de kundorganisationer som de hanterar, för att utlösa en omedelbar synkronisering eller få synkroniseringsstatusinformation. Metoderna för katalogsynkronisering grupperas under Broad Works Enterprises:

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

• Uppdatera katalogsynkronisering för ett brett företag – ange företaget id för att uppdatera status för katalogsyc för företaget genom att aktivera eller inaktivera katalogsynkronisering.

• Utlösarkatalogsynkronisering 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öretag id. För syncStatus, ange SYNC_NOW kommando.

• Hämta katalogsynkroniseringsstatus för ett företag – ange företaget id och kör för att få en 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 Trigger Directory Sync för en enskild användare API för att utlösa en katalogsynkronisering på begäran 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.