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

Você não pode usar as APIs de Comunicação na Nuvem para registrar ou de outra forma persistir o conteúdo da mídia de chamadas ou reuniões que seu aplicativo acessa ou dados derivados desse conteúdo de mí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 Call Métodos para chamadas
Chamadas IVR 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