Compartir a través de


Trabajar 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.

Obtenga información sobre cómo 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 delegados para mejorar los escenarios de llamada colaborativa, como las apariencias de línea compartida y las llamadas de proxy.

Requisitos previos

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

  • Permisos: asigne ámbitos delegados a la aplicación para el 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 mediante 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 miembro del equipo controla las comunicaciones de otro usuario.

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

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

¿Quién es un delegado?

Un delegado es un usuario que concede a otro usuario (delegado) la capacidad de realizar determinadas acciones en su nombre. Estas acciones pueden incluir la realización y recepción de llamadas, la administración de la configuración de llamadas o la unión a llamadas activas. Los delegados suelen ser usuarios que necesitan ayuda para controlar sus responsabilidades de comunicación.

¿Quién es un delegado?

Un delegado es un usuario al que un delegado asigna responsabilidades. Los delegados pueden realizar acciones específicas, como responder llamadas, iniciar llamadas y administrar la configuración de llamadas en nombre del delegado. Los asistentes o los miembros del equipo suelen usar este rol 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.
Obtención del delegado por identificador delegationSettings Obtenga detalles sobre un delegado específico.
Enumerar todos los delegados colección delegationSettings Obtenga una lista de todos los delegados de un usuario.
Obtención del delegado por identificador delegationSettings Obtenga detalles sobre un delegado específico.

Pasos siguientes

Use la API de delegación de llamadas en Microsoft Graph para consultar y administrar delegados y delegados 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.