Uso de la API de comunicaciones en Microsoft Graph

  • Artículo

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.

La API de comunicaciones de Microsoft Graph agrega una nueva dimensión a la manera en que su usuario o su organización pueden interactuar con otros usuarios mediante la habilitación de características y funcionalidades de comunicación básicas en sus aplicaciones y servicios. Puede usar esta API para hacer y recibir llamadas, para crear y recuperar coordinadas de reuniones, y comprobar la presencia de los usuarios.

Puede usar la API de comunicaciones en la nube para crear aplicaciones de servicio (robots) que actúen como participantes en una llamada, y que generen y recuperen reuniones en nombre de los usuarios y comprueben su disponibilidad y actividad de presencia. Esta API ofrece funciones de llamada, así como la capacidad de crear y recuperar reuniones en línea. Puede usar las aplicaciones de servicio (robots) con esta API. A modo de ejemplo, el bot puede actuar como un participante en las llamadas de VoIP o en las reuniones de Microsoft Teams.

Importante

NO puede usar las API de comunicaciones en la nube para registrar o conservar contenido multimedia de las llamadas o reuniones a las que accede la aplicación o los datos derivados de ese contenido multimedia. Asegúrese de que cumple la legislación y la reglamentación de su área respecto a la protección de datos y la confidencialidad de las comunicaciones. Consulte las Condiciones de uso y consulte con su asesor legal para obtener más información.

Autorización

Se requiere uno de los siguientes permisos para acceder a la API de comunicaciones en la nube. Es el administrador quien debe otorgar estos permisos.

Escenario Permisos
Llamando Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All
Reuniones OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All
Presencia Presence.Read, Presence.Read.All
Registros de llamadas CallRecords.Read.All

Casos de uso comunes

En la tabla siguiente se enumeran algunos de los usos comunes de la API de comunicaciones en la nube.

Casos de uso Recursos de REST Vea también
Crear y unirse a llamadas individuales y en grupo Llamar Métodos de llamadas
Llamadas IVR Métodos de llamadas IVR
Controles de llamada (participante) Participante
Reuniones onlineMeeting Métodos para las reuniones
Presencia presencia Métodos de presencia
Recuperar registros de llamadas callRecord Suscripciones de webhook

Propiedades comunes

Recurso Propiedades
llamada propiedades de la llamada
participante propiedades del participante
onlineMeeting propiedades de onlineMeeting
presencia propiedades de presencia
callRecord propiedades de callRecord

Contenido relacionado