Compartilhar via

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

  • Artigo

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

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ça Presence.Read, Presence.Read.All
Evento virtual VirtualEvent.Read, VirtualEvent.ReadWrite

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
Presença presença Métodos para presença
Recuperar registros de chamadas callRecord Assinaturas do Webhook
Eventos virtuais virtualEvent Métodos para virtualEventTownhall, Métodos para virtualEventWebinar

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

Conteúdo relacionado