Configurazione di sequenze DTMF in Cisco Meeting Server Spaces

Introduzione

In questo documento viene descritta la procedura per configurare le sequenze DTMF in modo da consentire agli utenti di eseguire azioni negli spazi Cisco Meeting Server (CMS).

Prerequisiti

Requisiti

Cisco raccomanda la conoscenza dei seguenti argomenti:

• Cisco Meeting Server
• DTMF

Componenti usati

Le informazioni fornite in questo documento si basano sulle seguenti versioni software e hardware:

• Cisco Meeting Server con software versione 3.8

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse

È possibile definire sequenze DTMF personalizzate in CMS per consentire ai partecipanti dello spazio di richiamare azioni che influiscono sullo spazio e sui relativi partecipanti. Ad esempio, una sequenza DTMF può essere utilizzata da un partecipante per disattivare l'audio, avviare o interrompere lo streaming della riunione o terminare la riunione.

Un dtmfProfile definisce le sequenze DTMF da utilizzare per richiamare ogni azione specifica disponibile. Assegnando un dtmfProfile a system/profiles tramite l'API CMS, le sequenze DTMF diventano disponibili a livello globale. Le restrizioni per le azioni DTMF possono essere ottimizzate creando callLegProfiles con autorizzazioni diverse per ognuna delle azioni e applicandole a diversi livelli dell'API.

Configurazione

1. Creare un oggetto dtmfProfile e applicarlo globalmente

Per creare l'oggetto dtmfProfile:

1. Accedere alla pagina CMS web admin.

2. Passare a Configurazione > API.

3. Passare alla sezione /api/v1/dtmfProfiles e espandilo.

4. Fare clic su Crea nuovo.

5. Definire le sequenze DTMF da utilizzare per eseguire le azioni richieste. Nell'esempio, le sequenze DTMF vengono definite per le azioni toggleMuteSelfAudio e endCall.

6. Fare clic su Crea.

Per applicare globalmente dtmfProfile:

1. Passare a Configurazione > API.

2. Passare alla sezione /api/v1/system/profiles ed espanderla.

3. Fare clic su Visualizza o su Modifica.

4. Nell'impostazione dtmfProfile, fare clic su Choose e selezionare l'oggetto creato in precedenza.

5. Fare clic su Modifica.

2. Ottimizzare le autorizzazioni per eseguire le azioni DTMF

Il controllo granulare delle autorizzazioni per eseguire l'azione DTMF può essere ottenuto configurando callLegProfiles, che può essere applicato a diversi livelli nell'API. In questo diagramma vengono illustrati tutti i livelli possibili:

Il livello a cui callLegProfile viene applicato ne determina l'ambito. I profili assegnati ai livelli inferiori sostituiscono quelli impostati in precedenza. Questi esempi illustrano come questo principio può essere utilizzato per consentire di richiamare azioni DTMF solo a determinati spazi o utenti.

Consenti solo azioni in uno spazio specifico

È possibile creare e applicare a livello di /sistema/profili le autorizzazioni di negazione di callLegProfile per l'esecuzione delle azioni DTMF. È quindi possibile creare e applicare a livello di coSpace un altro callLegProfile che consente di creare e applicare le azioni, limitando quindi l'ambito delle autorizzazioni a uno specifico coSpace (o a un set di coSpaces, se applicato a più di un oggetto).

1. Passare a Configurazione > API.

2. Passare alla sezione /api/v1/callLegProfiles ed espanderla.

3. Fare clic su Crea nuovo.

4. Passare alle azioni che devono essere disabilitate e impostarle su false.

5. Fare clic su Crea.

In questo esempio è stato creato callLegProfile per impedire la fine della riunione impostando endCallAllowed su false:

6. Assegnarlo a sistema/profilo per impedire globalmente l'azione:

7. Creare un nuovo callLegProfile, questa volta per consentire l'azione. In questo esempio è stato creato callLegProfile con endCallAllowed impostato su true:

8. Passare a Configurazione > API > /api/v1/coSpaces ed espanderlo.

9. Individuare il coSpace a cui si desidera assegnarlo e in callLegProfile scegliere quello creato per consentire le azioni.

Poiché callLegProfile viene applicato a un livello API inferiore, esegue l'override di callLegProfile precedentemente applicato a /system/profiles, in modo che le azioni DTMF possano essere richiamate solo da questo particolare coSpace.

Consenti solo agli utenti con password di eseguire le azioni

L'ambito delle autorizzazioni può essere ristretto a un gruppo di utenti che necessitano di diritti speciali, come gli operatori video. È possibile creare un accessMethod, con il proprio numero di directory, per accedere a un coSpace con un callLegProfile specifico attivo che consente le azioni DTMF.

1. Passare a Configurazione > API > /api/v1/coSpaces ed espanderlo.

2. Dall'elenco, scegliere il coSpace per il quale si desidera creare il metodo di accesso.

3. dall'elenco Oggetti correlati, fare clic sul collegamento /api/v1/coSpaces/<IDcoSpace>/accessMethods:

4. Nel campo uri, immettere un numero per consentire agli utenti con privilegi di accedere a questo spazio.

5. Creare un passcode. Quando gli utenti con privilegi compongono il numero accessMethod, devono immettere questo codice seguito dal simbolo # per poter accedere alla riunione.

6. In callLegProfile, scegliere quello che consente di terminare la chiamata.

7. È possibile inserire un nome per il metodo di accesso per renderlo facilmente riconoscibile da Esplora API.

In questo esempio viene creato un accessMethod con il numero 3001 per gli operatori video da utilizzare quando si accede a coSpace (il numero di directory 3000 è stato assegnato a coSpace, gli utenti normali compongono questo numero per partecipare alle riunioni su questo spazio). È protetto da una password e il callLegProfile che consente di terminare la chiamata viene assegnato esclusivamente ad esso.

8. Applicare il callLegProfile che non consente le azioni è globalmente assegnandolo a sistema/profili.

In questo esempio, non è necessario assegnare un callLegProfile al coSpace stesso. Eredita il profilo applicato globalmente, pertanto gli utenti che partecipano alla riunione componendo il numero coSpace (3000) non dispongono dell'autorizzazione per terminare la chiamata tramite DTMF.

Grazie a questa configurazione, gli operatori video possono partecipare alla riunione componendo il numero accessMethod (3001) anziché il numero coSpace (3000). I componenti di chiamata utilizzano il callLegProfile che consente di applicare l'azione, pertanto solo i componenti di chiamata possono utilizzare la sequenza DTMF definita per terminare la chiamata.

Informazioni correlate

Guida di riferimento per l'API CMS 3.8