Uso de la API de comunicaciones en Microsoft Graph
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 |
|---|---|
| Registros de llamadas | CallRecords.Read.All |
| 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 |
| Evento virtual | VirtualEvent.Read, VirtualEvent.ReadWrite |
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 | call | Métodos de llamadas |
| Llamadas IVR | call | 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 |
| Eventos virtuales | virtualEvent | Métodos para virtualEventTownhall, métodos para virtualEventWebinar |
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 |