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 |
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de