Uso de la API de comunicaciones en Microsoft Graph
La API de comunicaciones en la nube de Microsoft Graph aporta una nueva dimensión a la manera en que su usuario u organización interactúan 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, así como para crear y recuperar coordenadas de reuniones.
Puede usar la API de comunicaciones en la nube para crear aplicaciones de servicio (robots) que participen en una llamada, y que creen y recuperen reuniones para los usuarios. 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 |
| Presencias | Presence.Read, Presence.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 | 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 |
| Recuperar registros de llamadas | callRecord | Suscripciones de webhook |
| Presencias | presencia |
Propiedades comunes
| Recurso | Propiedades |
|---|---|
| llamada | propiedades de la llamada |
| participante | propiedades del participante |
| onlineMeeting | propiedades de onlineMeeting |
| callRecord | propiedades de callRecord |
| presencia | presencia |