Trabajo con las API de delegación de llamadas en Microsoft Graph (versión preliminar)

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Aprenda a usar las API de delegación de llamadas para simplificar los flujos de trabajo de comunicación en aplicaciones personalizadas. Estas API permiten consultar y administrar delegados y delegadores para mejorar los escenarios de llamadas colaborativas, como las apariencias de líneas compartidas y las llamadas proxy.

Requisitos previos

Para acceder a estas API, se requieren las siguientes configuraciones:

  • Permisos: asigne ámbitos delegados a la aplicación para obtener acceso. Use la siguiente dirección URL para iniciar sesión con una cuenta de administrador y asignar permisos:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.Read
    
  • Directivas: asigne la AllowDelegation directiva en Microsoft Teams con PowerShell:

    Set-CsTeamsCallingPolicy -AllowDelegation $true
    

Introducción a la delegación de Teams

La delegación de Microsoft Teams permite a los usuarios compartir responsabilidades de llamadas mediante la asignación de delegados. Los delegados pueden realizar acciones como recibir llamadas, realizar llamadas en nombre de otros usuarios y administrar la configuración de llamadas. Esta característica es útil en escenarios en los que un asistente o un miembro del equipo controla las comunicaciones de otro usuario.

Microsoft Graph permite a los desarrolladores administrar mediante programación delegadores y delegados. Los escenarios comunes incluyen:

  • Configuración de apariencias de línea compartida.
  • Administrar permisos para realizar y recibir llamadas.
  • Optimización de los flujos de trabajo de comunicación dentro de los equipos.

¿Quién es un delegador?

Un delegador es un usuario que concede a otro usuario (delegado) la capacidad de realizar determinadas acciones en su nombre. Estas acciones pueden incluir realizar y recibir llamadas, administrar la configuración de llamadas o unirse a llamadas activas. Los delegadores suelen ser usuarios que necesitan ayuda para manejar sus responsabilidades de comunicación.

¿Quién es un delegado?

Un delegado es un usuario al que un delegador asigna responsabilidades. Los delegados pueden realizar acciones específicas, como responder llamadas, iniciar llamadas y administrar la configuración de llamadas en nombre del delegador. Este rol es comúnmente utilizado por asistentes o miembros del equipo para facilitar flujos de trabajo de comunicación sin problemas.

Casos de uso comunes

Operación Tipo devuelto Descripción
Enumerar todos los delegados colección delegationSettings Obtenga una lista de todos los delegados de un usuario.
Obtener delegado por id. delegaciónConfiguración Obtenga detalles sobre un delegado específico.
Enumerar todos los delegadores colección delegationSettings Obtenga una lista de todos los delegadores para un usuario.
Obtener delegador por id. delegaciónConfiguración Obtenga detalles sobre un delegador específico.

Pasos siguientes

Use la API de delegación de llamadas en Microsoft Graph para consultar y administrar delegados y delegadores en Teams. Para obtener más información:

  • Explore los recursos y los métodos que son más útiles para su escenario.
  • Pruebe la API en el Probador de Graph.