Sincronizzazione rubriche in Webex per Cisco BroadWorks

La sincronizzazione della rubrica garantisce 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 facevano parte del provisioning utente nella rubrica Webex.

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

• Utenti di chiamata solo BroadWorks (che non dispongono dell'onboarding in Webex)

• Entità di chiamata non utenti (ad esempio, telefono sala conferenze, fax, numero di gruppo di risposta)

• Voci dell'elenco telefonico BroadWorks

La tabella seguente riassume i record di chiamata BroadWorks e mostra 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 di clienti in una singola 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 ora 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 rubriche viene eseguita settimanalmente per ciascun cliente. Ogni sincronizzazione si verifica una settimana dopo l'ultima sincronizzazione, indipendentemente dal fatto che l'ultima sincronizzazione sia 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 dallo stesso 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 pianificherà due sincronizzazioni pianificate da eseguire contemporaneamente dallo stesso BroadWorks.

• Se si verifica un errore di sincronizzazione, Webex tenta 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, puoi visualizzare le informazioni sullo stato della sincronizzazione per un determinato cliente. Inoltre, è possibile 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 nella verifica.

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

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

  • Numero di telefono principale

  • Numero di telefono cellulare

  • Estensione

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

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

Elenco telefonico BroadWorks e numeri massimi di contatto

La sincronizzazione rubrica 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 questi contatti rispetto a un'organizzazione. Ogni utente può accedere ai contatti dell'organizzazione per la propria organizzazione. Il numero massimo di contatti è fino a 30000.

• Contatti utente: Webex memorizza questi contatti nei confronti di un utente. Solo l'utente titolare del contatto può accedere alla voce di contatto. Il numero massimo è fino a 2000 contatti (1500 contatti sincronizzati + 500 contatti inseriti manualmente).

La tabella seguente associa i tipi di contatto Webex all'origine del contatto (sincronizzati da un elenco telefonico BroadWorks o aggiunti manualmente):

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

• 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 od omessi.

• Se uno dei tuoi clienti supera il numero massimo consentito di contatti in una delle due categorie, ti consigliamo di aprire un caso con Cisco per escludere tale organizzazione dalla sincronizzazione delle rubriche.

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

Aggiornamenti

Di seguito è riportata la modalità di gestione degli aggiornamenti della rubrica Webex:

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

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

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

• Se l'aggiornamento è a un utente chiamante solo BroadWorks o a un'entità chiamante non utente, l'aggiornamento viene visualizzato nell'app Webex di un utente immediatamente dopo la successiva sincronizzazione della rubrica.

• Se l'aggiornamento è a una voce dell'elenco telefonico BroadWorks:

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

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

  • Per contatti organizzazione: la rubrica Webex viene aggiornata alla successiva sincronizzazione della rubrica, ma gli utenti non visualizzano la modifica nell'app Webex fino a quando non riavviano l'app Webex o fino alla scadenza del timer della cache locale di 72 ore.

Si consiglia di utilizzare le seguenti impostazioni:

• Valori limitanti la velocità: impostare le seguenti proprietà del sistema OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit: impostare su un valore nullo.

  • globalDirectoryTransactionLimit: impostare un valore nullo.

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

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

  • userTransactionLimit: impostare almeno 100.

  • transactionLimitPeriodSecs: impostare su 1.

• Valori di cercapersone: impostare le proprietà del sistema di cercapersone (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize: impostare su 50

  • availableUserMaxLimit: impostare su 100

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

Inoltre, a seconda della release BroadWorks, 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: nessun cerotto richiesto

Gli amministratori dei partner possono abilitare la sincronizzazione delle rubriche per un modello cliente durante la creazione del nuovo modello. Tutte le nuove organizzazioni di clienti che vengono assegnate a tale modello avranno la sincronizzazione della rubrica 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 nell'app Webex. Questa operazione deve essere completata una sola volta.

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

• Elenco delle imprese BroadWorks: utilizzare questo metodo API per ottenere un elenco delle imprese di un determinato provider di servizi e di ciascuna impresa id. È necessario immettere il spEnterpriseId come assegnato nel provisioning.

• Aggiorna sincronizzazione rubrica per un'azienda BroadWorks: inserisci l'azienda id per aggiornare lo stato syc della rubrica per tale azienda, abilitando o disabilitando la sincronizzazione della rubrica.

• Attiva sincronizzazione rubrica per un'azienda: utilizza questo metodo API se desideri attivare una sincronizzazione immediata per una determinata azienda id. Per il syncStatus, immettere il SYNC_NOW comando.

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

Inoltre, gli amministratori possono utilizzare la sincronizzazione della rubrica di attivazione per una singola API utente per attivare una sincronizzazione della rubrica su richiesta per un singolo utente.

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

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

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

La tabella seguente riassume gli aggiornamenti a questo articolo.