Consola de operadora en Microsoft Teams

Para qué sirve

La consola de operadora puede integrarse en Microsoft Teams como aplicación personal. La operadora la abre en la barra de aplicaciones de Teams e inicia sesión con la cuenta de Teams activa. La contraseña no se transmite a EasyUC. Teams carga la página de la consola de operadora desde su propio servidor EasyUC.

La aplicación es interna del tenant. Cada operador gestiona su propio registro de aplicación de Entra y carga su propio paquete de aplicación en Teams. No existe publicación en la Teams Store pública.

Es independiente de lo anterior el dispositivo con el que la operadora habla. Como dispositivos están disponibles la aplicación Microsoft Teams y un teléfono de sobremesa Teams. En ambos casos, la operadora contesta la llamada en Teams.

Requisitos previos

Módulos de licencia acd y teams.
Un nombre DNS completo (FQDN) para EasyUC y HTTPS en el puerto 443 con una cadena de certificados en la que confíen Teams y los navegadores. Las direcciones IP simples y los certificados autofirmados no son adecuados para una pestaña de Teams.
Páginas con una política de privacidad y condiciones de uso accesibles por HTTPS.
En Microsoft Entra: permiso para crear un registro de aplicación. En el Teams admin center: permiso para cargar y aprobar una aplicación personalizada.
Un tenant de Teams conectado en EasyUC. Las operadoras se asignan a la consola con su Teams account (UPN) o con un dispositivo Teams.
El paquete de aplicación se genera con una herramienta que se suministra con el producto. Para ello, póngase en contacto con el fabricante o con su administrador de sistemas.

Paso a paso: registrar la aplicación de Entra

En el Microsoft Entra admin center, abra Identity → Applications → App registrations → New registration.
Introduzca un nombre, por ejemplo EasyUC Attendant, y seleccione Accounts in this organizational directory only. No introduzca un URI de redirección.
Anote Directory (tenant) ID y Application (client) ID.
En el manifiesto de la aplicación, establezca el valor requestedAccessTokenVersion bajo api en 2.
En Expose an API, cree el Application ID URI api://<fqdn>/<client-id>.
Cree el ámbito delegado access_as_user (consentimiento de administradores y usuarios, activado).
En Authorized client applications, introduzca los dos clientes de Teams de Microsoft (Teams de escritorio/móvil y Teams web) y autorice el ámbito para ellos.

Paso a paso: cargar y aprobar el paquete de aplicación

Haga que se genere el paquete de aplicación para su nombre de host y su ID de cliente. Contiene exactamente manifest.json, color.png y outline.png, y no contiene contraseñas ni secretos de cliente.
Abra el Teams admin center y allí Teams apps → Manage apps.
Haga clic en Actions → Upload new app y cargue el archivo ZIP.
Apruebe la aplicación para el grupo de operadoras. Aparece en Built for your org.
Si es necesario, utilice una directiva de configuración para instalar la aplicación automáticamente y anclarla en la barra de aplicaciones.

Paso a paso: iniciar sesión en Teams y contestar llamadas

En Teams, abra la aplicación EasyUC Attendant. La página muestra Attendant console in Microsoft Teams.
Haga clic en Sign in with Teams. EasyUC utiliza su inicio de sesión activo de Teams.
Seleccione su dispositivo, por ejemplo Microsoft Teams (softphone), y haga clic en Start.
Cuando aparezca una llamada, contéstela en Microsoft Teams. Para ello, la consola muestra Please answer in Microsoft Teams..

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Application ID URI	`api://<fqdn>/<client-id>`. Debe coincidir exactamente con el valor del paquete de aplicación.
Scope	`access_as_user`. El inicio de sesión en el servidor EasyUC no requiere ningún permiso de Microsoft Graph ni secreto de cliente.
App package	Ámbito de instalación personal, manifiesto según el esquema 1.22 de Teams. Para una actualización, utilice el mismo ID de cliente y aumente el número de versión.
Sign in with Microsoft	En el navegador fuera de Teams: inicio de sesión mediante una ventana de Microsoft o un código de inicio de sesión. Con varias organizaciones, seleccione la suya en Microsoft organization.
Device Microsoft Teams app	Contestar en Microsoft Teams. Teams hace sonar al usuario: todos los dispositivos Teams de esta cuenta suenan al mismo tiempo.
Device Microsoft Teams desk phone	Contestar en el teléfono Teams. Teléfono de sobremesa certificado para Teams, con la sesión iniciada con la cuenta de la operadora.
Paths	La vista general y la lista de comprobación muestran, por cada ruta, qué llamadas llegan a un dispositivo Teams. Tras contestar una llamada de Teams, la operadora controla la retención, el cuelgue y la transferencia en el cliente de Teams.

Comprobar el resultado y acotar errores

La aplicación abre la consola de operadora dentro de Teams y, tras Sign in with Teams, aparece la selección de dispositivo.
The attendant console could not be initialized in Microsoft Teams. Please reopen it in Teams. La página no se cargó desde Teams o la incrustación está bloqueada. Compruebe el nombre de host y el certificado.
Sign-in with your Microsoft Teams account failed. Please try again. Compruebe el Application ID URI, el ámbito y las aplicaciones cliente autorizadas.
This Microsoft account is not enabled for the attendant console. La cuenta no está asignada a ninguna operadora. Introduzca la cuenta de Teams en la operadora.
Microsoft sign-in has not been fully configured yet. Please contact your administrator. o No organization has been configured for Microsoft sign-in yet.
The Microsoft sign-in window was blocked. Allow pop-ups for EasyUC and try again.
La página permanece vacía en Teams: el servidor web no debe prohibir la incrustación por parte de Teams. EasyUC la permite únicamente para la página de entrada de la consola de operadora; un proxy intermedio no debe sobrescribir la cabecera.
Las llamadas no se entregan aunque la operadora esté lista: desactive el buzón de voz y el desvío por no respuesta para el usuario de Teams y compruebe en la lista de comprobación la ruta hacia dispositivos Teams.