Hacer accesibles los scripts mediante Microsoft Teams

Para qué sirve

Un script puede contestar llamadas que se marcan en Microsoft Teams o que llegan desde la red telefónica a través de Teams. La llamada llega entonces a EasyUC a través del Session Border Controller integrado y recorre el mismo flujo de llamada que una llamada de CUCM.

Hay tres entradas. Con Direct Routing, EasyUC gestiona por sí mismo la ruta de voz hacia su propio SBC. Con Operator Connect through Teams forwarding, una cuenta de servicio de Teams lleva el número de Operator Connect y desvía de inmediato a un número piloto de Direct Routing; el SBC asigna la llamada al script mediante el History-Info. Con Operator Connect over a public destination, el número permanece con el operador y se desvía por la red telefónica a un número de destino independiente; EasyUC no configura para ello una ruta de runtime propia.

Microsoft no documenta la ruta a través del desvío de Teams. Por ello, la interfaz de usuario la identifica con not documented by Microsoft.

Requisitos previos

• Módulo de licencia teams. Para scripts con un número CUCM, además cucm.
• Permiso para scripts: ROLE_APP_ACD_WORKSPACE con ROLE_APP_ACD_SCRIPTS y ROLE_APP_ACD_SCRIPTS_EDIT; sin el módulo ACD, ROLE_APP_TEAMS_WORKSPACE con ROLE_APP_TEAMS_SCRIPTS y ROLE_APP_TEAMS_SCRIPTS_EDIT. Los administradores con ROLE_APP_ADMIN, ROLE_OWNER, ROLE_ADMIN o ROLE_SUPER_ADMIN tienen todos los permisos del área.
• Un tenant de Teams conectado y activo, con SBC y trunk configurados (capítulos «Configurar el SBC de Teams» y «Tenant de Teams y conexión Graph»). Sin tenant, el formulario muestra: No Teams tenant is connected yet. Add one under Session Border Controller first.
• Para definir la ruta de voz automáticamente: un registro de aplicación en el tenant. Sin él, la ruta solo se define mientras un administrador de Teams tiene la sesión iniciada en la página del tenant.
• Para Operator Connect mediante desvío de Teams: por cada número entrante, una cuenta de servicio de Teams independiente con licencia Teams Phone y Enterprise Voice, a la que se asigna el número de Operator Connect, y un número libre de Direct Routing como piloto. ForwardCallHistory debe estar activado en el gateway de EasyUC en Teams.

Paso a paso: Direct Routing

1. Abra Calling Features → Calls → Calling Features y haga clic en Edit en el script.
2. Active Reachable via MS Teams. Para un script sin número CUCM, seleccione en su lugar Microsoft Teams only en Reachable via, en la parte superior.
3. Seleccione el tenant en Teams tenant.
4. Seleccione el mosaico Direct Routing en Call entry.
5. Introduzca el número en formato internacional en Number dialled in Teams, por ejemplo +49 40 1234567.
6. Haga clic en Save. EasyUC define la ruta de voz para este número en Teams.
7. Espere el mensaje Route in Teams set. Mientras tanto se muestra allí Updating the route in Teams …; esto puede tardar hasta dos minutos. Puede abandonar la página; el resultado también aparece en la lista de scripts.

Paso a paso: Operator Connect mediante desvío de Teams

1. Abra el script con Edit, active Reachable via MS Teams y seleccione el Teams tenant.
2. Seleccione el mosaico Operator Connect through Teams forwarding en Call entry.
3. Añada los números entrantes en Operator Connect numbers: con Add a number from the inventory o Add a number by hand. Por script son posibles como máximo 10 números.
4. En cada fila, introduzca el OC number y la Teams service account (UPN) a la que está asignado el número.
5. En Pilot number (Direct Routing), introduzca un número de Direct Routing que no esté asignado a ningún usuario ni recurso. En Suggestions, EasyUC ofrece números piloto libres y números piloto que ya se comparten.
6. Haga clic en Save. Siempre se comprueba y configura el estado guardado.
7. Haga clic en Check now. EasyUC lee mediante el servicio PowerShell si coinciden usuario, número, política, desvío y piloto. No se modifica nada en el proceso.
8. En una fila con error o aviso, haga clic en Set up forwarding.
9. Deje marcadas Assign the policy (EasyUC voice routing policy) y Set forwarding (immediately to the pilot number). Si el usuario ya desvía a otro destino, marque además Replace the existing forwarding.
10. Haga clic en Preview, revise los Planned steps y haga clic en Run. Confirme el mensaje.
11. Haga clic de nuevo en Check now y llame desde fuera al número de Operator Connect.

Paso a paso: Operator Connect a través de un destino público

1. Abra el script con Edit, active Reachable via MS Teams y seleccione el Teams tenant.
2. Seleccione el mosaico Operator Connect over a public destination en Call entry.
3. Seleccione el número entrante público en Operator Connect number. Utilice Search para acotar la lista.
4. En Public EasyUC destination, introduzca un número público independiente que ya llegue a este servidor EasyUC a través de CUCM, de un proveedor SIP o de otra conexión PSTN.
5. Haga clic en Save.
6. Configure el desvío del número de Operator Connect al destino de EasyUC en el operador o en su entrada PBX/SIP. EasyUC solo almacena la asignación al script y no crea ninguna ruta de Direct Routing para el número de Operator Connect.

Campos y opciones

Comprobar el resultado y acotar errores

• En la lista de scripts, el número de Teams con la entrada se muestra debajo del número. Con el desvío de Teams, además via pilot con el número piloto y el estado de la comprobación.
• The route in Teams was not updated o Updating the route in Teams failed, cada uno con un motivo: abra el tenant con Open the tenant page y revise el registro de aplicación o el inicio de sesión del administrador de Teams.
• Die Teams-Nummer muss im internationalen Format mit führendem + angegeben werden, zum Beispiel +49 40 1234567. (El número de Teams debe indicarse en formato internacional con un + inicial, por ejemplo +49 40 1234567.)
• Bitte den Teams-Tenant auswählen, über den das Script erreichbar sein soll. (Seleccione el tenant de Teams a través del cual debe ser accesible el script.)
• The Operator Connect number and the pilot number must differ so that no call loop arises.
• The number … is the Teams device of an attendant console. A transfer to it would run back into EasyUC through the forwarding (call loop). Please use a dedicated service account.
• The number … is already used in this tenant (script "…"). Por tenant, un número lleva exactamente a un script.
• Das EasyUC-Gateway in Teams sendet keine History-Info (ForwardCallHistory ist aus). (El gateway de EasyUC en Teams no envía History-Info; ForwardCallHistory está desactivado.) Sin él, el SBC no puede asignar un número de Operator Connect desviado. Active ForwardCallHistory en el gateway.
• The PowerShell service for Microsoft Teams is not reachable. La comprobación y la configuración no son entonces posibles; utilice la guía de configuración manual.
• Límites del desvío de Teams según la interfaz de usuario: cada número entrante necesita una cuenta de servicio con licencia Teams Phone. No se ha probado cuántas llamadas pueden circular simultáneamente por el número de un usuario. El usuario puede modificar el desvío por su cuenta, por lo que debe revisar el estado con regularidad.