Trabalhando com a API de comunicações na nuvem no Microsoft Graph
A API de comunicações do Microsoft Graph adiciona uma nova dimensão à maneira como você ou sua organização podem interagir com outros usuários, habilitando os principais recursos e funções de comunicação de seus aplicativos e serviços. Você pode usar esta API para criar e receber chamadas, além de criar e recuperar coordenadas de reunião.
Você pode usar a API de comunicações para criar aplicativos de serviço (bots) que atuam como participantes de uma chamada e que criam e recuperam reuniões em nome dos usuários. Essa API fornece funcionalidade de chamada, bem como a capacidade de criar e recuperar reuniões online. Você pode usar aplicativos de serviço (bots) com esta API, onde o bot pode atuar como participante de suas chamadas de VoIP ou reuniões do Microsoft Teams, por exemplo.
Importante
NÃO pode utilizar as APIs de Comunicações na Cloud para registar ou manter conteúdos multimédia de chamadas ou reuniões a que a sua aplicação acede ou dados derivados desse conteúdo multimédia. Certifique-se de que você está em conformidade com as leis e regulamentações de sua área em relação à proteção de dados e à confidencialidade das comunicações. Confira os Termos de Uso e converse com sua assessoria jurídica para saber mais.
Autorização
É necessária uma das seguintes permissões para acessar a API de comunicações na nuvem. Essas permissões precisam ser concedidas pelo administrador.
| Cenário | Permissões |
|---|---|
| Registros de chamadas | CallRecords.Read.All |
| Chamando | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.Initiate.All, Calls.InitiateGroupCall.All, Calls.AccessMedia.All |
| Reuniões | OnlineMeetings.ReadWrite.All, OnlineMeetings.Read.All |
| Presenças | Presence.Read, Presence.Read.All |
Casos de uso comuns
A tabela a seguir lista alguns dos usos comuns para a API de comunicações na nuvem.
| Casos de uso | Recursos REST | Confira também |
|---|---|---|
| Criando e associando chamadas 1-1 e de grupo | chamada | Métodos para chamadas |
| Chamadas IVR | chamada | Métodos para IVR |
| Controles de chamada (participante) | Participante | |
| Reuniões | onlineMeeting | Métodos para reuniões |
| Recuperar registros de chamadas | callRecord | Assinaturas do Webhook |
| Presenças | presença |
Propriedades comuns
| Recurso | Propriedades |
|---|---|
| call | propriedades de chamada |
| participante | propriedades dos participantes |
| onlineMeeting | Propriedades onlineMeeting |
| callRecord | Propriedades do callRecord |
| presença | presença |