La sincronizzazione della directory garantisce che gli utenti di Webex per Cisco BroadWorks possano utilizzare la directory Webex dall'app Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Questa funzione sincronizza le informazioni sulle chiamate di BroadWorks che non facevano parte del provisioning degli utenti nella directory Webex.

Il provisioning degli utenti di Webex for Cisco BroadWorks aggiorna la rubrica Webex con i dettagli delle chiamate per gli utenti Webex for Cisco BroadWorks (numero di telefono principale, numero di cellulare, interno), ma omette i registri delle chiamate esterne. Tuttavia, quando la sincronizzazione della directory è attiva, la funzione sincronizza anche i seguenti record delle chiamate nella directory Webex.

• Utenti che chiamano solo Broadworks (che non sono collegati a Webex)

• Entità chiamanti non utenti (ad esempio, telefono di una sala conferenze, fax, numero del gruppo di ricerca)

• Voci della lista telefonica di BroadWorks

La tabella seguente riassume i record delle chiamate di BroadWorks e mostra come vengono aggiunti alla directory Webex.

Condizioni di sincronizzazione delle directory

• Gli amministratori dei partner devono abilitare la funzionalità a livello di partner. Gli amministratori partner possono attivare o disattivare la funzionalità per più organizzazioni clienti in un'unica operazione.

• Per impostazione predefinita, la sincronizzazione iniziale avviene una settimana dopo l'attivazione della sincronizzazione (l'ora scelta per avviare la sincronizzazione è casuale). Tuttavia, le organizzazioni clienti possono utilizzare l'opzione Sincronizza ora per aggirare il periodo di attesa di una settimana e attivare una sincronizzazione immediata per una determinata organizzazione cliente.

• Per impostazione predefinita, la sincronizzazione delle directory viene eseguita settimanalmente per ogni cliente. Ogni sincronizzazione avviene una settimana dopo l'ultima sincronizzazione, indipendentemente dal fatto che l'ultima sincronizzazione sia stata pianificata o attivata manualmente con Sync Now.

• Il numero massimo di sincronizzazioni simultanee per cluster BroadWorks è due: una sincronizzazione pianificata e una sincronizzazione su richiesta (tramite API o GUI di Partner Hub). Tuttavia, gli amministratori non possono eseguire due sincronizzazioni su richiesta contemporaneamente dalla stessa BroadWorks. Questa restrizione esiste indipendentemente dal fatto che la sincronizzazione sia stata avviata tramite l'API o tramite l'opzione Sincronizza ora in Partner Hub. Inoltre, Webex non programmerà l'esecuzione contemporanea di due sincronizzazioni pianificate dallo stesso BroadWorks.

• Se si verifica un errore di sincronizzazione, Webex ritenta la sincronizzazione automaticamente ogni 24 ore fino alla successiva sincronizzazione programmata.

• La sincronizzazione ignora gli utenti che non hanno un numero di telefono.

• In Partner Hub, può visualizzare le informazioni sullo stato della sincronizzazione per un determinato cliente. Inoltre, può esportare informazioni dettagliate sull'ultima sincronizzazione in un record CSV. Il record CSV fornisce più dettagli rispetto al display di Control Hub e può aiutare nella risoluzione dei problemi, nell'analisi e nel controllo.

• Webex memorizza i contatti degli utenti in un formato crittografato. Solo l'utente proprietario del contatto ha accesso alla chiave di decrittazione.

• Per gli utenti che chiamano solo BroadWorks e le entità chiamanti non utenti, questa funzione sincronizza i seguenti tipi di numeri di telefono di BroadWorks:

  • Numero di telefono principale

  • Numero di cellulare

  • Estensione

  Tuttavia, la sincronizzazione esclude dalla sincronizzazione gli utenti che chiamano solo Broadworks e le entità chiamanti non utente se non è presente né un numero di telefono principale né un interno.

  L'impostazione del servizio di privacy a livello utente di BroadWorks non è supportata come parte della sincronizzazione delle directory.

Elenco telefonico di BroadWorks e numero massimo di contatti

La sincronizzazione della rubrica sincronizza anche le voci dell'elenco telefonico di BroadWorks con Webex Contacts. Le voci sincronizzate vengono aggiunte a uno dei seguenti tipi di contatto:

• Contatti dell'organizzazione—Webex memorizza questi contatti con un'organizzazione. Ogni utente può accedere ai contatti dell'organizzazione della propria organizzazione. Il massimo è fino a 30000 contatti.

• Contatti utente: Webex memorizza questi contatti con un utente. Solo l'utente proprietario del contatto può accedere al contatto inserito. Il massimo è fino a 2000 contatti (1500 contatti sincronizzati + 500 contatti con immissione manuale).

La seguente tabella associa i tipi di contatto Webex alla fonte del contatto (sincronizzato da un elenco telefonico BroadWorks o aggiunto manualmente):

Le seguenti condizioni si applicano al modo in cui Directory Sync gestisce il numero massimo di contatti:

• Se un'organizzazione supera il numero massimo di contatti consentito per la sincronizzazione (30000 contatti dell'organizzazione o 30000 contatti comuni di gruppo per gruppo), la sincronizzazione delle directory esclude le voci al di sopra della soglia massima. Non c'è un ordine particolare applicato ai contatti sincronizzati o omessi.

• Se uno dei suoi clienti supera il numero massimo consentito di contatti in entrambe le categorie, Le consigliamo di sollevare un caso con Cisco per escludere quell'organizzazione dalla sincronizzazione delle directory.

• I contatti manuali sono contatti che un utente aggiunge manualmente nell'app Webex. Un utente può aggiungere fino a 500 contatti manuali. I contatti manuali rientrano nella più ampia categoria dei contatti utente su Webex, ma non sono inclusi nella sincronizzazione.

• Il limite complessivo combinato per i contatti dell'organizzazione (30000) e i contatti di gruppo (30000 per gruppo) è di 200000.

Aggiornamenti

Di seguito è riportato il modo in cui la directory Webex gestisce gli aggiornamenti:

• Se il nome del contatto cambia su BroadWorks, il contatto esistente viene eliminato dalla rubrica Webex e viene creato un nuovo contatto.

• Se il numero di contatto cambia su BroadWorks, Webex aggiorna il contatto esistente nella rubrica Webex con il nuovo numero.

Dopo che un amministratore ha aggiornato un contatto su BroadWorks, le seguenti condizioni delineano quando l'aggiornamento viene visualizzato nell'app Webex di un utente:

• Se l'aggiornamento riguarda un utente chiamante solo Broadworks o un'entità chiamante non utente, l'aggiornamento viene visualizzato nell'app Webex di un utente immediatamente dopo la successiva sincronizzazione della directory.

• Se l'aggiornamento riguarda una voce dell'elenco telefonico di BroadWorks:

  • Per i contatti utente: gli aggiornamenti vengono visualizzati nell'app Webex dell'utente subito dopo la successiva sincronizzazione della directory.

  • Per i contatti di gruppo - Gli aggiornamenti vengono visualizzati nell'app Webex dell'utente subito dopo la successiva sincronizzazione della directory.

  • Per i contatti dell'organizzazione: la directory Webex viene aggiornata alla successiva sincronizzazione della directory, ma gli utenti non vedranno la modifica nell'app Webex finché non riavviano l'app Webex o fino alla scadenza del timer della cache locale di 72 ore.

Le consigliamo di utilizzare le seguenti impostazioni:

• Valori limite di velocità: imposta le seguenti proprietà del sistema OverloadControl (xsp_CLI/Applications/XSI-Actions/OverloadControl):

  • UserDirectoryTransactionLimit: impostato su un valore nullo.

  • GlobalDirectoryTransactionLimit: impostato su un valore nullo.

  Si consiglia di impostare UserDirectoryTransactionLimit e GlobalDirectoryTransactionLimit su un valore nullo. Tuttavia, se decide di assegnare valori, ognuno deve essere impostato su almeno cinque volte il valore di TransactionLimitPeriodSeconds (che dovrebbe essere 1).

• Limiti delle transazioni: imposta i seguenti valori (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • UserTransactionLimit: impostato su almeno 100.

  • Periodi limite di transazione SEC — impostato su 1.

• Valori di paging: imposta le proprietà del sistema di paging (XSP_CLI/Applications/XSI-Actions/Paging):

  • Dimensione pagina predefinita: impostata su 50

  • Limite massimo utente disponibile: impostato su 100

• Interfaccia CTI: si assicuri di caricare i certificati Webex CA nel trust store dell'interfaccia CTI e di abilitare l'autenticazione del client sull'interfaccia CTI.

Inoltre, a seconda della versione di BroadWorks, le consigliamo di applicare le seguenti patch di sistema alla distribuzione di BroadWorks prima di abilitare questa funzione:

• Per R22: Ap.as.22.0.1123.AP368517

• Per R23: Ap.as.23.0.1075.AP368517

• Per R24: nessuna patch richiesta

Gli amministratori partner possono abilitare Directory Sync per un modello di cliente durante la creazione del nuovo modello. Tutte le nuove organizzazioni clienti che vengono assegnate a quel modello avranno la sincronizzazione delle directory abilitata. Per i dettagli, vedere «Configura i suoi modelli di onboarding» in Configura la sua organizzazione partner in Partner Hub nella Guida alla soluzione per Webex per Cisco BroadWorks.

Cosa fare dopo

Si assicuri che i suoi utenti sappiano che devono fare clic sulla scheda Contatti sull'app Webex almeno una volta per attivare la funzione sull'app Webex. Questo deve essere completato una sola volta.

Le API pubbliche sono disponibili su developer.webex.com che consentono agli amministratori partner di aggiornare le impostazioni di Directory Sync per le organizzazioni clienti che gestiscono, attivare una sincronizzazione immediata o ottenere informazioni sullo stato della sincronizzazione. I metodi di sincronizzazione delle directory sono raggruppati in BroadWorks Enterprises:

• Elenca BroadWorks Enterprises: utilizza questo metodo API per ottenere un elenco di aziende con un determinato fornitore di servizi e l'ID di ciascuna azienda. Deve inserire lo SPEnterpriseID assegnato nel provisioning.

• Aggiorna Directory Sync for a BroadWorks Enterprise: inserire l'ID aziendale per aggiornare lo stato di sincronizzazione delle directory per quell'azienda, abilitando o disabilitando la sincronizzazione delle directory.

• Trigger Directory Sync for an Enterprise: utilizzi questo metodo API se desidera attivare una sincronizzazione immediata per un determinato ID aziendale. Per SyncStatus, inserisca il comando SYNC_NOW.

• Ottieni lo stato di sincronizzazione della directory per un'azienda: inserisca l'ID aziendale ed esegua per ottenere lo stato e il trackingID dell'ultima sincronizzazione. Può utilizzare TrackingID per eseguire analisi aggiuntive tramite strumenti come Kibana e Grafana.

Inoltre, gli amministratori possono utilizzare l'API Trigger Directory Sync for a Single User per attivare una sincronizzazione delle directory su richiesta per un singolo utente.

Per una documentazione dettagliata sull'API, vedere https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Deve accedere per leggere le specifiche dell'API all'indirizzo https://developer.webex.com/docs/api/v1/broadworks-subscribers.

I seguenti codici di errore si applicano a Directory Sync.

La tabella seguente riassume gli aggiornamenti a questo articolo.