Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
Saiba como utilizar as APIs de delegação de chamadas para simplificar os fluxos de trabalho de comunicação em aplicações personalizadas. Estas APIs permitem consultar e gerir delegados e delegadores para melhorar cenários de chamadas colaborativas, como aspetos de linha partilhados e chamadas de proxy.
Pré-requisitos
Para aceder a estas APIs, são necessárias as seguintes configurações:
Permissões: atribua âmbitos delegados à sua aplicação para acesso. Utilize o seguinte URL para iniciar sessão com uma conta de administrador e atribuir permissões:
https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id={Client-App-ID}&response_type=code&scope=https://graph.microsoft.com/CallDelegation.ReadPolíticas: atribua a
AllowDelegationpolítica no Microsoft Teams com o PowerShell:Set-CsTeamsCallingPolicy -AllowDelegation $true
Introdução à delegação do Teams
A delegação do Microsoft Teams permite que os utilizadores partilhem responsabilidades de chamadas ao atribuir delegados. Os delegados podem efetuar ações como receber chamadas, fazer chamadas em nome de outras pessoas e gerir as definições de chamadas. Esta funcionalidade é útil em cenários em que um assistente ou membro da equipa processa comunicações para outro utilizador.
O Microsoft Graph permite aos programadores gerir programaticamente delegados e delegados. Os cenários comuns incluem:
- Configurar aspetos de linha partilhados.
- Gerir permissões para efetuar e receber chamadas.
- Simplificar fluxos de trabalho de comunicação dentro das equipas.
Quem é um delegador?
Um delegador é um utilizador que concede a outro utilizador (delegado) a capacidade de realizar determinadas ações em seu nome. Estas ações podem incluir efetuar e receber chamadas, gerir definições de chamadas ou associar chamadas ativas. Normalmente, os delegadores são utilizadores que precisam de assistência para lidar com as respetivas responsabilidades de comunicação.
Quem é um delegado?
Um delegado é um utilizador a quem são atribuídas responsabilidades por um delegante. Os delegados podem efetuar ações específicas, como atender chamadas, iniciar chamadas e gerir definições de chamadas em nome do delegante. Esta função é frequentemente utilizada por assistentes ou membros da equipa para facilitar fluxos de trabalho de comunicação totalmente integrados.
Casos de uso comuns
| Operação | Tipo de retorno | Descrição |
|---|---|---|
| Listar todos os delegados | delegationSettings collection (coleção delegationSettings ) | Obtenha uma lista de todos os delegados de um utilizador. |
| Obter delegado por ID | delegationSettings | Obtenha detalhes sobre um delegado específico. |
| Listar todos os delegadores | delegationSettings collection (coleção delegationSettings ) | Obtenha uma lista de todos os delegadores de um utilizador. |
| Obter delegador por ID | delegationSettings | Obtenha detalhes sobre um delegador específico. |
Próximas etapas
Utilize a API de delegação de chamadas no Microsoft Graph para consultar e gerir delegados e delegadores no Teams. Para saber mais:
- Explore os recursos e os métodos mais úteis para seu cenário.
- Experimente a API no Explorador do Graph.