Operator Connect mediante reenvío de Teams

Para qué sirve

Con Operator Connect, el número de teléfono público permanece en el operador, que lo entrega directamente en Microsoft Teams, no en el SBC de EasyUC. Para que una llamada a un número de este tipo llegue igualmente a un script de EasyUC, EasyUC ofrece la entrada de llamadas Operator Connect through Teams forwarding.

La vía: el llamante marca el número de Operator Connect. Este está asignado a una cuenta de servicio de Teams que reenvía de inmediato cada llamada a un número piloto de Direct Routing. El número piloto figura en la ruta de voz de EasyUC, de modo que la llamada llega al SBC a través del trunk. El SBC lee en el History-Info de la llamada qué número se marcó originalmente y asigna la llamada al script correcto.

El script puede ser un script ACD o la cola de una consola de operador. No interviene ningún Auto Attendant de Microsoft Teams. EasyUC puede comprobar los ajustes necesarios en la cuenta de servicio y definirlos por sí mismo mediante Teams PowerShell.

Requisitos previos

• Módulo de licencia teams. Sin este módulo no aparece el espacio de trabajo EasyUC Teams.
• Rol EasyUC Teams con los subpermisos SCRIPTS (ROLE_APP_TEAMS_SCRIPTS) y SCRIPTS bearbeiten (ROLE_APP_TEAMS_SCRIPTS_EDIT).
• Direct Routing con el SBC de EasyUC está en funcionamiento para este tenant y al menos un script es accesible desde Teams.
• EasyUC ha iniciado sesión en Teams PowerShell o hay un registro de aplicación almacenado.
• Un número de Operator Connect que se pueda asignar a un usuario. Un número de servicio para cuentas de recurso no es adecuado.
• Para cada número de Operator Connect, una cuenta de servicio de Teams específica con licencia de Teams Phone y Enterprise Voice, a la que se asigna el número.
• La política de llamadas de la cuenta de servicio permite el reenvío a números de teléfono. EasyUC no comprueba este punto; verifíquelo en Teams.
• Un número libre de Direct Routing como número piloto. No está asignado a ningún usuario ni recurso y no está sujeto a ninguna regla para números sin asignar.
• La política global de enrutamiento de voz del tenant no contiene el uso de PSTN de EasyUC.

Paso a paso: configurar un script con números de Operator Connect

1. Abra el script en el formulario de scripts o créelo con Create IVR.
2. Marque Reachable via MS Teams y seleccione el Teams tenant.
3. En Call entry, seleccione la tarjeta Operator Connect through Teams forwarding. Lleva la indicación not documented by Microsoft.
4. En Operator Connect numbers, elija un número de la lista Add a number from the inventory y haga clic en el icono más. Si no figura en el inventario, haga clic en Add a number by hand e introduzca el OC number.
5. Para cada número, compruebe el campo Teams service account (UPN). EasyUC toma la cuenta del inventario; puede modificarla manualmente.
6. Repita este paso para los demás números. Se permiten como máximo 10 números por script.
7. En Pilot number (Direct Routing), introduzca el número piloto o haga clic en una de las Suggestions. Las sugerencias llevan las etiquetas free, shared o used by this script so far.
8. Haga clic en Save. EasyUC añade el número piloto a la ruta de voz, nunca los números de Operator Connect.

Paso a paso: comprobar y configurar el reenvío

1. Abra la página del tenant y compruebe que Routes in Teams muestra Up to date. En caso contrario, haga clic en Update routes. Solo entonces el número piloto está en el patrón de la ruta de voz.
2. Abra de nuevo el script y haga clic en Check now. Mediante el servicio PowerShell, EasyUC lee si coinciden usuario, número, política, reenvío y número piloto. No se modifica nada.
3. Lea los elementos de comprobación en Pilot number and trunk y, por cada número, mediante el icono Check items. El estado por número es OK, Note, Error o not checked.
4. En la fila de un número, haga clic en Set up forwarding.
5. Deje marcados Assign the policy (EasyUC voice routing policy) y Set forwarding (immediately to the pilot number).
6. Si aparece Replace the existing forwarding, la cuenta ya reenvía a otro destino. Márquelo solo si ese reenvío puede sobrescribirse.
7. Haga clic en Preview y lea Planned steps. Si un paso está marcado como blocked, no se ejecuta nada.
8. Haga clic en Run y confirme el aviso “EasyUC now changes the settings of … in Microsoft Teams. Continue?”.
9. Espere el mensaje “The setup is complete.” Anote el cuadro State before con el reenvío y la política anteriores para una posible reversión posterior.
10. Haga clic de nuevo en Check now. Todos los elementos de comprobación deberían mostrar OK.
11. Llame al número de Operator Connect desde la red móvil. En el historial de llamadas, From muestra su número móvil y To muestra el número de Operator Connect con la adición “via pilot …”.

Paso a paso: configurar el reenvío manualmente o revertirlo

1. En el script, haga clic en Manual setup guide. EasyUC muestra los siete pasos con los valores de este script.
2. En el centro de administración de Teams, asigne a la cuenta de servicio una política de enrutamiento de voz con el uso de EasyUC. No modifique nunca la política Global.
3. En el cliente de Teams de la cuenta de servicio o en el centro de administración de Teams, configure el reenvío inmediato al número piloto.
4. Verifique con Check now.
5. Para revertir, restablezca el reenvío de la cuenta de servicio al estado indicado en State before y asigne de nuevo la política anterior.
6. Cambie el script a otra entrada de llamadas o elimínelo. Con un número piloto compartido, no basta con desactivarlo.
7. En la página del tenant, haga clic en Update routes para que un número piloto que ya no se utiliza desaparezca de la ruta de voz.

Campos y opciones

Comprobar el resultado y acotar errores

• Éxito: Check now muestra todos los elementos de comprobación como OK y la llamada de prueba al número de Operator Connect llega al script. En el historial de llamadas, To muestra el número de Operator Connect con “via pilot …”.
• “Please save the script first. Checks and setup use the saved state.” Guarde el script antes de realizar la comprobación.
• “The EasyUC gateway in Teams sends no History-Info (ForwardCallHistory is off). Without it the SBC cannot match a forwarded Operator Connect number.” Haga clic en Update routes en la página del tenant o active ForwardCallHistory en el gateway PSTN de Teams.
• “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.” Utilice otra cuenta.
• “The Operator Connect number and the pilot number must differ so that no call loop arises.” Elija otro número piloto.
• “The number … is already used in this tenant (script …).” El número pertenece a otro script.
• “At least one step is blocked. Nothing is run.” Lea el motivo en el paso, normalmente una política ajena o un reenvío existente.
• “The PowerShell service for Microsoft Teams is not reachable.” Compruebe el servicio y el inicio de sesión en la página del tenant.
• Elemento de comprobación Global policy without the EasyUC usage como nota: el uso de PSTN de EasyUC está asociado a la política Global. Esto no se recomienda para esta vía.
• El usuario o un administrador puede modificar el reenvío en cualquier momento. Repita Check now con regularidad. La lista de comprobación de la consola de operador valora como nota una comprobación con más de 7 días de antigüedad.
• Límites: cada número de Operator Connect necesita una cuenta de servicio con licencia. No se ha probado cuántas llamadas pueden circular simultáneamente por el número de un usuario.