Trabalhando com a API de comunicações na nuvem no Microsoft Graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

A API de comunicações na nuvem 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, criar e recuperar coordenadas da reunião e verificar a presença dos usuários.

Você pode usar a API de comunicações na nuvem para criar aplicativos de serviço (bots) que atuam como participantes de uma chamada, criam e recuperam reuniões em nome dos usuários e verificam a disponibilidade e a atividade de presença. 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
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ça Presence.Read, Presence.Read.All
Registros de chamadas CallRecords.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
Presença presença Métodos para presença
Recuperar registros de chamadas callRecord Assinaturas do Webhook

Propriedades comuns

Recurso Propriedades
call propriedades de chamada
participante propriedades dos participantes
onlineMeeting Propriedades onlineMeeting
presença Propriedades de presença
callRecord Propriedades do callRecord