Configurar el trunk y las rutas de voz en Teams

Para qué sirve

Para que Teams envíe llamadas al SBC de EasyUC, el tenant de Teams necesita cuatro objetos: un gateway PSTN con el nombre de host y el puerto del SBC, un uso de PSTN, una ruta de voz con un patrón de números y una política de enrutamiento de voz. EasyUC crea estos objetos por sí mismo mediante Teams PowerShell y los mantiene actualizados.

EasyUC construye el patrón de números de la ruta de voz a partir de los números de los scripts para los que Reachable via MS Teams está activado con este tenant. Por ello, Teams envía por el trunk únicamente las llamadas a estos números de script. El SBC rechaza cualquier otro número. Sin número de script, EasyUC no crea ninguna ruta de voz.

EasyUC modifica únicamente sus propios objetos. Por defecto se denominan EasyUC- seguido de la primera etiqueta del nombre de host del SBC. El gateway se crea explícitamente como habilitado, con SIP OPTIONS, sin media bypass y con reenvío de History-Info y P-Asserted-Identity. EasyUC no asigna aquí la política a usuarios individuales.

Requisitos previos

Módulo de licencia teams. Sin este módulo no aparece el espacio de trabajo EasyUC Teams.
Rol EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) con los subpermisos TENANTS (ROLE_APP_TEAMS_TENANTS) para leer y TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT) para modificar.
El certificado del tenant está emitido, el servicio SBC está en ejecución y el firewall está abierto.
El dominio del nombre de host del SBC está verificado en el tenant de Microsoft 365.
EasyUC ha iniciado sesión en Teams PowerShell o hay un registro de aplicación almacenado (capítulo “Acceso a Graph e inicio de sesión del administrador de Teams”).
Al menos un script es accesible a través de este tenant y tiene un número (capítulo “Hacer accesible un script a través de Microsoft Teams”). De lo contrario, solo se crea el gateway, sin ruta de voz.
Los usuarios de Teams que vayan a llamar a los números de script tienen licencia de Teams Phone y Enterprise Voice.

Paso a paso: configurar el trunk por primera vez

Abra Teams Tenants, haga clic en el tenant y, en la sección Settings, vaya al cuadro Set up the trunk in Teams.
Compruebe que se muestran PowerShell service reachable y Signed in o Signs in automatically.
En Scripts over this trunk, compruebe que sus scripts figuran con el estado Reachable.
Decida sobre Enable for all users (global policy). Sin la marca, solo utilizan las rutas de voz los usuarios a los que usted asigne la política de EasyUC. En caso de duda, déjela sin marcar.
Haga clic en Show what would happen. La vista previa solo lee y no modifica nada en el tenant.
Lea The preview covers these numbers y These steps would run. Cada paso lleva una etiqueta: will be created, will be changed, will be removed o already in place.
Haga clic en Set up the trunk now.
Lea el aviso de confirmación. Indica el nombre de host, el puerto y el número de números de script. Confirme con OK.
Espere a Steps and their result. Cada paso muestra executed, already in place, failed o not run (aborted).
Compruebe la línea Set up in Microsoft. Muestra yes con nombre de host, puerto, enabled y sends SIP OPTIONS.
Espere unos minutos y haga clic en el icono de actualizar, arriba a la derecha. Reached from Microsoft muestra entonces “Microsoft answers our OPTIONS” y OPTIONS from Microsoft muestra una hora actual.

Paso a paso: asignar la política de enrutamiento de voz a los usuarios

Sin la opción global, usted debe asignar la política de EasyUC a los usuarios. EasyUC no lo hace durante la configuración del trunk.
Abra el Teams admin center del cliente y vaya a las políticas de enrutamiento de voz.
Seleccione la política cuyo nombre empieza por EasyUC-. La vista previa de EasyUC muestra el nombre exacto.
Asigne la política a los usuarios que vayan a llamar a números de script desde Teams.
Tenga en cuenta que Teams aplica la asignación solo transcurrido un tiempo.

Paso a paso: sincronizar las rutas de voz tras un cambio

Al guardar un script, EasyUC sincroniza por sí mismo la ruta en Teams. El formulario del script muestra “Updating the route in Teams …” y después “Route in Teams set” con los números.
Sin registro de aplicación, esta sincronización solo se ejecuta mientras un administrador de Teams tenga la sesión iniciada en la página del tenant.
Para una sincronización manual, abra el cuadro Voice routes for the script numbers y haga clic en Synchronise now. Puede tardar hasta dos minutos.
Lea el resultado: “Route in Teams set: …” o “Teams updated: no script number is reachable over this tenant any more, so no EasyUC route is left there.”
Si también debe ajustarse el gateway o la política global, haga clic en su lugar en Update routes y confirme el aviso. Synchronise now nunca modifica el gateway PSTN ni la política global.

Paso a paso: configurar el trunk manualmente o quitarlo de nuevo

Sin el servicio PowerShell, haga clic en Set it up by hand instead. EasyUC muestra qué debe crearse en el tenant de Teams, incluido el comando completo New-CsOnlinePSTNGateway con el nombre de host y el puerto de este tenant.
A continuación, cree en Teams una ruta de voz para los números de script y asigne una política de enrutamiento de voz a los usuarios.
Para quitarlo, haga clic en Remove the trunk y confirme el aviso. EasyUC elimina sus objetos en orden inverso. Después no circula ninguna llamada por el trunk.
Si el uso de PSTN está asociado a la política global, EasyUC elimina de ella únicamente su propia entrada. El aviso lo indica.

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Set up in Microsoft	Estado de la configuración en Microsoft: not checked yet, not yet, yes o exists, but does not match these settings. A continuación: nombre de host, puerto, enabled/disabled y sends SIP OPTIONS/no SIP OPTIONS.
Reached from Microsoft	Medido en su propio SBC: si Microsoft responde a los OPTIONS del SBC y cuándo llegaron por última vez OPTIONS de Microsoft. Microsoft no expone este estado a través de ninguna interfaz.
Routes in Teams	Estado de la última sincronización: Up to date, Outdated o Never synchronised, con una marca de tiempo.
Synchronise now	Reconstruye las rutas de voz a partir de los números de script actuales. Modifica únicamente la ruta de voz, el uso de PSTN y la política de EasyUC.
Enable for all users (global policy)	Asocia el uso de PSTN de este trunk a la política Global. Esto modifica la política predeterminada de todos los usuarios con Enterprise Voice de este tenant. Se aplica únicamente a Update routes. No se recomienda con scripts que utilicen Operator Connect mediante reenvío de Teams.
Show what would happen	Vista previa de solo lectura con los números cubiertos, los pasos y las notas. Indica “Nothing to do: the trunk in Microsoft already matches these settings.” cuando todo coincide.
Set up the trunk now / Update routes	Ejecuta los pasos de la vista previa. La etiqueta cambia en cuanto el gateway existe en Microsoft.
Remove the trunk	Elimina del tenant de Teams el gateway, la ruta de voz, el uso de PSTN y la política de EasyUC.
Set it up by hand instead	Despliega la guía para configurar sin el servicio PowerShell.
These commands ran	Lista de los comandos ejecutados como líneas legibles, para la documentación.

Comprobar el resultado y acotar errores

Éxito: Set up in Microsoft muestra yes, Reached from Microsoft muestra “Microsoft answers our OPTIONS”, Routes in Teams muestra Up to date y la lista de tenants muestra el trunk como active.
Microsoft envía OPTIONS solo después de que hayan llegado los OPTIONS del SBC. Si el trunk sigue down o unknown tras unos minutos, compruebe el certificado, el nombre de host, el puerto TLS y el firewall.
„Microsoft kennt die Domain dieses SBC-Namens in diesem Tenant nicht. …“ Añada el dominio en el Microsoft 365 admin center, en Settings → Domains, y verifíquelo con un registro TXT. Para un nombre con dos niveles de subdominio, debe estar registrado exactamente el dominio que sigue a la primera etiqueta.
„Die Anmeldung steht, aber dem Konto fehlen die Rechte. Der App-Registrierung muss die Verzeichnisrolle „Teams-Administrator“ zugewiesen sein.“ Asigne el rol en Microsoft Entra.
„Dem Tenant fehlt eine Voraussetzung an Lizenzen. Für Direct Routing brauchen die Benutzer eine Teams-Phone-Lizenz und Enterprise Voice.“ Compruebe las licencias en el tenant.
„Erst mit einem Teams-Administrator anmelden oder unter Microsoft Graph eine App-Registrierung hinterlegen, dann meldet sich EasyUC selbst an.“ Los botones están bloqueados hasta que exista un inicio de sesión.
„Die Antwort des Abgleichs kam nicht rechtzeitig zurück. Er kann dennoch durchgelaufen sein; der Stand oben wird gleich nachgezogen.“ Espere y recargue la página antes de volver a sincronizar.
“The gateway sends no History-Info (ForwardCallHistory off). Operator Connect through Teams forwarding needs it.” Afecta únicamente a scripts con reenvío de Teams. Haga clic en Update routes para que EasyUC alinee el gateway con sus ajustes.
Una llamada al número del script falla aunque todo esté en verde: compruebe si la política de EasyUC está asignada al usuario que llama y espere a que Teams la aplique.