Administrar números de teléfono para bots

En este artículo se describe cómo 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 será útil familiarizarse con los siguientes términos:

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

  • Instancia de aplicación: un 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 recurso. Esta es la única forma 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.

Imagen que muestra un número de teléfono con inquilinos con una o más instancias de aplicación

Requisito previo: registrar un bot

Para empezar, siga las instrucciones para registrar un bot de llamada. Necesitarás valores de configuración como id. de bot, id. de aplicación de Microsoft y contraseña de la aplicación 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 acerca de los permisos relacionados con llamadas, vea la referencia de permisos.

Asignar un número de teléfono al bot

Asignar un número de teléfono al bot implica tres pasos:

  1. Crear una instancia de aplicación.
  2. Asigne Microsoft 365 licencias 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 Skype Empresarial online para PowerShell. El administrador del espacio empresarial debe iniciar sesión con sus credenciales antes de ejecutar el cmdlet.

Para crear una nueva instancia de aplicación, el administrador del espacio empresarial ejecuta el siguiente cmdlet.

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

Cuando se cree la instancia de aplicación, use el cmdlet sync.

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

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

Asignar 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, Teléfono licencia de usuario virtual del sistema.

Asigne un plan de llamada a la instancia de la aplicación. Para obtener más información, vea Calling plans for 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 Getting phone numbers for your users.

Para asignar el número de teléfono a la instancia de la aplicación, el administrador de inquilinos:

  1. Inicia sesión en el Teams de administración como administrador de inquilinos.
  2. Va a Teams Centro de administración > De > voz Teléfono Números.
  3. Asigna un número de teléfono de servicio (formato +11D) con el siguiente cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <phone_number>

Cuando se asigne el número de teléfono de servicio, use el cmdlet de sincronización.

PS C:\> Sync-CsOnlineApplicationInstance -ObjectId <application_instance_id>

Para obtener más información, vea Set-CsOnlineVoiceApplicationInstance y Sync-CsOnlineApplicationInstance.

Unassign a bot phone number

Use el siguiente cmdlet para desasignación de un número de teléfono.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber $null

Nota: Actualmente, solo funciona con números en línea y no con números de enrutamiento directo (DR). Este es un problema conocido.

Actualizar un número de teléfono de bot

Después de desasignar el número, puede asignar un número diferente al bot mediante el siguiente cmdlet.

PS C:\> Set-CsOnlineVoiceApplicationInstance -Identity <user@contoso.com> -TelephoneNumber <new phone_number>

Vea también