Configuración de secuencias DTMF en Cisco Meeting Server Spaces

Introducción

Este documento describe los pasos para configurar secuencias DTMF para permitir que los usuarios realicen acciones en espacios de Cisco Meeting Server (CMS).

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Cisco Meeting Server
• DTMF

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• Cisco Meeting Server con software versión 3.8

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Antecedentes

Es posible definir secuencias de DTMF personalizadas en CMS para que los participantes del espacio las utilicen para invocar acciones que afecten al espacio y a sus participantes. Por ejemplo, un participante puede utilizar una secuencia DTMF para activar o desactivar su propio silencio de audio, para iniciar o detener la transmisión de la reunión o para finalizar la reunión.

Un dtmfProfile define las secuencias DTMF que se utilizarán para invocar cada acción específica disponible. Al asignar un dtmfProfile a system/profiles a través de la API de CMS, las secuencias DTMF se vuelven disponibles globalmente. Las restricciones para las acciones DTMF se pueden ajustar creando callLegProfiles con diferentes permisos para cada una de las acciones y aplicándolas en diferentes niveles de la API.

Configurar

1. Cree un objeto dtmfProfile y aplíquelo globalmente

Para crear el objeto dtmfProfile:

1. Inicie sesión en la página de administración web de CMS.

2. Navegue hasta Configuración > API.

3. Navegue hasta la sección /api/v1/dtmfProfiles y expandirlo.

4. Haga clic en Crear nuevo.

5. Defina las secuencias de DTMF que se utilizarán para realizar las acciones necesarias. En este ejemplo, las secuencias DTMF se definen para las acciones toggleMuteSelfAudio y endCall.

6. Haga clic en Crear.

Para aplicar dtmfProfile globalmente:

1. Navegue hasta Configuración > API.

2. Navegue hasta la sección /api/v1/system/profiles y amplíela.

3. Haga clic en Ver o editar.

4. En el parámetro dtmfProfile, haga clic en Choose y seleccione el objeto creado anteriormente.

5. Haga clic en Modificar.

2. Ajuste los permisos para realizar las acciones de DTMF

Se puede lograr un control granular de los permisos para ejecutar la acción DTMF mediante la configuración de callLegProfiles, que se puede aplicar en diferentes niveles en la API. Este diagrama ilustra todos los niveles posibles:

El nivel en el que se aplica callLegProfile determina su alcance. Los perfiles asignados en niveles inferiores reemplazan a los establecidos anteriormente. Estos ejemplos ilustran cómo este principio se puede utilizar para permitir invocar acciones DTMF sólo a ciertos espacios o usuarios.

Permitir acciones sólo en un espacio específico

Se puede crear y aplicar un callLegProfile que niega los permisos para ejecutar las acciones DTMF en el nivel /system/profiles. A continuación, se puede crear y aplicar otro callLegProfile que permita las acciones en el nivel coSpace, por lo que se limita el alcance de los permisos a un coSpace específico (o a un conjunto de coSpaces, si se aplica a varios).

1. Navegue hasta Configuración > API.

2. Navegue hasta la sección /api/v1/callLegProfiles y amplíela.

3. Haga clic en Crear nuevo.

4. Acceda a las acciones que deben no permitirse y establézcalas en false.

5. Haga clic en Crear.

En este ejemplo, se ha creado un callLegProfile para no permitir la finalización de la reunión estableciendo endCallAllowed en false:

6. Asígnelo al sistema/perfil para no permitir globalmente la acción:

7. Cree un nuevo callLegProfile, esta vez para permitir la acción. En este ejemplo, se ha creado un callLegProfile con endCallAllowed establecido en true:

8. Navegue hasta Configuración > API > /api/v1/coSpaces y amplíelo.

9. Busque el coSpace al que desea asignarlo y, en callLegProfile, seleccione el que ha creado para permitir las acciones.

Dado que este callLegProfile se aplica en un nivel de API inferior, reemplaza el callLegProfile aplicado anteriormente a /system/profiles, lo que hace que las acciones DTMF sean invocables desde este coSpace en particular solamente.

Permitir que sólo los usuarios con contraseña realicen las acciones

El alcance de los permisos se puede reducir a un grupo de usuarios que requieren derechos especiales, como los operadores de vídeo. Se puede crear un accessMethod, con su propio número de directorio, para acceder a un coSpace con un callLegProfile específico que permita las acciones de DTMF.

1. Navegue hasta Configuración > API > /api/v1/coSpaces y amplíelo.

2. En la lista, seleccione el espacio compartido para el que desea crear el accessMethod.

3. En la lista Objetos relacionados, haga clic en el enlace /api/v1/coSpaces/<coSpace ID>/accessMethods:

4. En el campo uri, introduzca un número para que los usuarios con privilegios marquen a este espacio.

5. Cree un código de acceso. Cuando los usuarios con privilegios marcan el número accessMethod, deben introducir este código seguido del signo # para que se les permita entrar en la reunión.

6. En callLegProfile, elija el que permite finalizar la llamada.

7. Si lo desea, introduzca un nombre para accessMethod para que sea fácilmente reconocible desde el explorador de la API.

En este ejemplo, se crea un accessMethod con el número 3001 para que los operadores de vídeo lo utilicen al unirse a coSpace (el número de directorio 3000 se ha asignado al coSpace, los usuarios normales marcan este número para unirse a las reuniones en este espacio). Está protegida por una contraseña y el callLegProfile que permite finalizar la llamada se le asigna de forma exclusiva.

8. Aplique el callLegProfile que rechaza las acciones de forma global asignándolo a system/profiles.

En este ejemplo, no hay necesidad de asignar un callLegProfile al coSpace. Hereda el perfil aplicado globalmente y, por tanto, los usuarios que se unen a la reunión marcando el número de coSpace (3000) no tienen permiso para finalizar la llamada a través de DTMF.

Como resultado de esta configuración, los operadores de vídeo pueden unirse a la reunión marcando el número accessMethod (3001) en lugar del número coSpace (3000). Sus tramos de llamada utilizan el callLegProfile que permite aplicar la acción, por lo tanto, sólo ellos pueden utilizar la secuencia DTMF definida para finalizar la llamada.

Información Relacionada

Guía de referencia de la API CMS 3.8