La sincronizzazione delle directory assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex dall'App Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Questa funzione sincronizza le informazioni di chiamata BroadWorks che non fanno parte del provisioning degli utenti con la rubrica Webex.

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

• Utenti che chiamano solo BroadWorks (che non sono presenti in Webex)

• Entità di chiamata non utente (ad esempio, un sala conferenze telefono, un fax o gruppo di risposta diverso)

• Voci dell'elenco di telefoni BroadWorks

La tabella seguente riporta un riepilogo dei record delle chiamate BroadWorks e indica come vengono aggiunti alla rubrica Webex.

Condizioni di sincronizzazione rubrica

• Gli amministratori dei partner devono abilitare la funzione a livello di partner. Gli amministratori dei partner possono attivare o disattivare la funzione per più organizzazioni clienti con una sola operazione.

• Per impostazione predefinita, la sincronizzazione iniziale viene eseguita una settimana dopo l'abilitazione della sincronizzazione (il tempo scelto per avviare la sincronizzazione è casuale). Tuttavia, le organizzazioni dei clienti possono utilizzare l'opzione Sincronizza or a per ignorare 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 ciascun cliente. Ciascuna sincronizzazione viene eseguita una settimana dopo l'ultima sincronizzazione, indipendentemente se l'ultima sincronizzazione è stata pianificata o attivata manualmente con Sincronizza ora.

• Il numero massimo di sincronizzazioni simultanee per cluster BroadWorks è due: una sincronizzazione pianificata e una sincronizzazione su richiesta (tramite API o GUI partner Hub). Tuttavia, gli amministratori non possono eseguire due sincronizzazioni su richiesta contemporaneamente dalla stessa BroadWorks. Questa limitazione 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 pianifica due sincronizzazioni pianificate per l'esecuzione contemporaneamente dalla stessa BroadWorks.

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

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

• In Partner Hub, è possibile visualizzare le informazioni sullo stato della sincronizzazione per un determinato cliente. Inoltre, è possibile esportare informazioni dettagliate sull'ultima sincronizzazione con un record CSV. Il record CSV fornisce più dettagli rispetto alla visualizzazione di Control Hub e consente di risolvere problemi, analisi e audit.

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

• Per gli utenti che chiamano solo BroadWorks e gli enti di chiamata non utente, questa funzione sincronizza i seguenti tipi di numeri di telefono da BroadWorks:

  • Numero di telefono principale

  • Numero telefono cellulare

  • Estensione

  Tuttavia, la sincronizzazione esclude gli utenti che chiamano solo BroadWorks e le entità che chiamano non utenti dalla sincronizzazione se non è presente un numero di telefono o un'estensione principale.

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

Elenco telefonici BroadWorks e valori massimi di contatti

La sincronizzazione delle directory sincronizza anche le voci dell'elenco telefonico BroadWorks con i contatti Webex. Le voci sincronizzate vengono aggiunte a uno dei seguenti tipi di contatto:

• Contatti organizzazione: Webex memorizza tali contatti in un'organizzazione. Ciascun utente può accedere ai contatti dell'organizzazione per la relativa organizzazione. Il numero massimo di contatti è fino a 30000.

• Contatti utente: Webex memorizza tali contatti in base a un utente. Solo l'utente proprietario del contatto può accedere alla voce del contatto. Il massimo è di 2000 contatti (1500 contatti sincronizzati + 500 contatti di inserimento manuale).

La tabella seguente associa i tipi di contatto Webex verso l'origine dei contatti (sincronizzata da un elenco di telefoni BroadWorks o aggiunta manualmente):

Le seguenti condizioni si applicano in base al modo in cui la sincronizzazione rubrica gestisce i valori massimi di contatto:

• Se un'organizzazione supera il numero massimo di contatti consentiti per la sincronizzazione (30000 contatti organizzazione o 30000 contatti comuni gruppo per gruppo), la sincronizzazione delle rubriche esclude le voci sopra la soglia massima. Nessun ordine particolare applicato ai contatti sincronizzati o omessi.

• Se uno dei clienti supera il numero massimo consentito di contatti in una delle due categorie, si consiglia di generare un caso con Cisco per fare in modo che tale organizzazione sia esclusa dalla sincronizzazione delle rubrica.

• I contatti manuali sono contatti che un utente aggiunge manualmente all'app Webex. Un utente può aggiungere fino a 500 contatti manuali. I contatti manuali rientrano nella categoria dei contatti utente più grandi in 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) è 200000.

Aggiornamenti

Di seguito viene descritto come la rubrica Webex gestisce gli aggiornamenti:

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

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

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

• Se l'aggiornamento è per un utente che chiama solo BroadWorks o un'entità che chiama non utente, l'aggiornamento viene visualizzato nell'app Webex di un utente immediatamente dopo la sincronizzazione delle directory successiva.

• Se l'aggiornamento è per una voce dell'elenco di telefoni BroadWorks:

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

  • Per i contatti di gruppo: gli aggiornamenti vengono visualizzati nell'app Webex degli utenti immediatamente dopo la successiva sincronizzazione della rubrica.

  • Per i contatti dell'organizzazione: la rubrica Webex viene aggiornata alla successiva sincronizzazione delle directory, ma gli utenti non visualizzano la modifica nell'app Webex fino a quando non riavviano l'app Webex o finché non scade il timer della cache di 72 ore locale.

Si consiglia di utilizzare le seguenti impostazioni:

• Valori limite velocità—Impostare le seguenti proprietà di sistema OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryLimit: impostare su un valore nullo.

  • globalDirectoryLimit: impostata su un valore nullo.

  Si consiglia di impostare userDirectoryLimit e globalDirectoryLimit su un valore nullo. Tuttavia, se si decide di assegnare i valori, ciascuno deve essere impostato su almeno cinque volte il valore di transactionLimitPeriodSeconds (che deve essere 1).

• Limiti transazione: impostare i seguenti valori (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userLimit: impostare almeno 100.

  • transactionLimitPeriodSecs: impostata su 1.

• Valori di cercapersone— Impostare le proprietà del sistema di cercapersone (XSP_CLI/Applicazioni/Xsi-Azioni/Cercapersone):

  • defaultPageSize—Imposta su 50

  • availableUserMaxLimit: impostato su 100

• Interfaccia CTI: accertarsi di caricare i certificati CA Webex nell'archivio di attendibilità dell'interfaccia CTI e abilitare l'autenticazione del client sull'interfaccia CTI.

Inoltre, in base alla release BroadWorks in uso, si consiglia di applicare le seguenti patch di sistema alla distribuzione 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 dei partner possono abilitare la sincronizzazione delle directory per un modello del cliente durante la creazione del nuovo modello. Per tutte le nuove organizzazioni clienti assegnate a tale modello, la sincronizzazione delle directory sarà abilitata. Per informazioni dettagliate, vedere "Configurazione dei modelli cliente" in Configurazione dell'organizzazione partner in Partner Hub all'interno della Guida alla soluzione per Webex per Cisco BroadWorks.

Operazioni successive

Accertarsi che gli utenti sappiano che devono fare clic sulla scheda Contatti nell'app Webex almeno una volta per attivare la funzione sull'app Webex. Questa operazione deve essere completata una sola volta.

Api pubbliche sono disponibili sul developer.webex.com che consentono agli amministratori dei partner di aggiornare le impostazioni di sincronizzazione delle directory per le organizzazioni dei clienti gestite, attivare una sincronizzazione immediata o ottenere informazioni sullo stato della sincronizzazione. I metodi di sincronizzazione delle directory sono raggruppati sotto Aziende BroadWorks:

• Elenca aziende BroadWorks: utilizzare questo metodo API per ottenere un elenco delle aziende con un determinato provider di servizi e l'ID di ciascuna azienda. È necessario inserire il spEnterpriseId come assegnato nel provisioning.

• Aggiornamento sincronizzazione rubriche per un'azienda BroadWorks: inserisci l'id aziendale per aggiornare lo stato del syc di rubrica per tale azienda abilitando o disabilitando la sincronizzazione delle rubriche.

• Attiva sincronizzazione rubriche per un'azienda: utilizza questo metodo API se desideri attivare una sincronizzazione immediata per un determinato id aziendale. Per syncStatus, inserire il comando SYNC_NOW .

• Ottieni stato sincronizzazione rubrica per un'azienda: inserisci l'ID aziendale ed esegui per ottenere uno stato e un trackingId dell'ultima sincronizzazione. È possibile utilizzare il trackingID per eseguire ulteriori analisi tramite strumenti come Kibana e Grafana.

Inoltre, gli amministratori possono utilizzare l'API Attiva sincronizzazione directory per un singolo utente per attivare una sincronizzazione delle directory su richiesta per un singolo utente.

Per informazioni dettagliate sulla documentazione API, vedere https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.

I seguenti codici di errore si applicano alla sincronizzazione delle rubrica.

La tabella seguente riepiloga gli aggiornamenti a questo articolo.