Administrar números de teléfono para bots

En este artículo se describe cómo usar la API de comunicaciones en la nube en Microsoft Graph para crear un bot al que se pueda acceder a través de un número de teléfono. A medida que cree el bot, le resultará útil familiarizarse con los siguientes términos:

• Aplicación: Una aplicación hospedada en Azure, también denominada bot.

• Instancia de la aplicación: Objeto de usuario deshabilitado que se puede asignar a un número de teléfono que puede usar un bot. Esto también se conoce como una cuenta de recursos. Esta es la única manera en que se puede asignar un número de teléfono a un bot.

Una aplicación puede tener varias instancias de aplicación y cada inquilino puede tener varias instancias de aplicación, como se muestra en la siguiente imagen.

Requisito previo: registro de un bot

Para empezar, siga las instrucciones para registrar un bot de llamadas. Necesitará valores de configuración como el identificador del bot, el identificador de aplicación de Microsoft y la contraseña de la aplicación de Microsoft para usarlos en el código.

Agregue los siguientes permisos al bot. Un administrador de inquilinos también debe dar su consentimiento a estos permisos:

• Calls.AccessMedia.All
• Calls.Initiate.All
• Calls.JoinGroupCall.All
• Calls.JoinGroupCallAsGuest.All

Para obtener más información sobre los permisos relacionados con llamadas, consulte la referencia de permisos.

Asignación de un número de teléfono al bot

La asignación de un número de teléfono al bot implica tres pasos:

1. Cree una instancia de aplicación.
2. Asigne licencias de Microsoft 365 a la instancia de la aplicación.
3. Asigne un número de teléfono a la instancia de la aplicación (solo administrador de inquilinos).

Crear una instancia de aplicación

Si aún no se ha instalado, un administrador de inquilinos debe instalar el módulo de Teams para PowerShell. El administrador de inquilinos debe iniciar sesión con sus credenciales antes de ejecutar el cmdlet.

Para crear una nueva instancia de aplicación, el administrador de inquilinos ejecuta el siguiente cmdlet:

PS C:\> New-CsOnlineApplicationInstance -UserPrincipalName <user@contoso.com> -ApplicationId <app_id> -DisplayName <bot_display_name>

Para obtener más información, vea New-CsOnlineApplicationInstance

Asignación de licencias de Microsoft 365 a la instancia de la aplicación

Asigne una licencia de usuario virtual a la instancia de la aplicación. Para obtener más información, consulte Licencia de usuario virtual del sistema telefónico.

Asigne un plan de llamada a la instancia de la aplicación. Para obtener más información, consulte Planes de llamadas para Microsoft 365.

Asignar un número de teléfono a la instancia de la aplicación (solo administrador de inquilinos)

Antes de que los usuarios de su organización puedan realizar y recibir llamadas de teléfono, debe obtener números de teléfono para ellos. Para obtener más información, consulte Obtención de números de teléfono para los usuarios.

Para asignar el número de teléfono a la instancia de aplicación, el administrador de inquilinos asigna un número de teléfono de servicio (formato +11D) mediante el siguiente cmdlet:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Para obtener más información, vea Set-CsPhoneNumberAssignment.

Anulación de la asignación de un número de teléfono del bot

Use el siguiente cmdlet para anular la asignación de un número de teléfono:

PS C:\> Remove-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Actualización de un número de teléfono del bot

Después de anular la asignación del número, puede asignar un número diferente al bot mediante el siguiente cmdlet:

PS C:\> Set-CsPhoneNumberAssignment -Identity <user@contoso.com> -PhoneNumber <phone_number> -PhoneNumberType <type>

Contenido relacionado

• Introducción a la API de Teams
• Ejemplo de bot de incidente
• Implementación del ejemplo