Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 usar as APIs de delegação de chamadas para simplificar os fluxos de trabalho de comunicação em aplicativos personalizados. Essas APIs permitem consultar e gerenciar representantes e delegadores para aprimorar cenários de chamadas colaborativas, como aparências de linha compartilhada e chamadas proxy.
Pré-requisitos
Para acessar essas APIs, as seguintes configurações são necessárias:
Permissões: atribua escopos delegados ao seu aplicativo para acesso. Use a seguinte URL para entrar 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 política no Microsoft Teams usando o
AllowDelegationPowerShell:Set-CsTeamsCallingPolicy -AllowDelegation $true
Introdução à delegação do Teams
A delegação do Microsoft Teams permite que os usuários compartilhem as responsabilidades da chamada atribuindo representantes. Os representantes podem executar ações como receber chamadas, fazer chamadas em nome de outras pessoas e gerenciar configurações de chamada. Esse recurso é útil em cenários em que um assistente ou membro da equipe lida com as comunicações de outro usuário.
O Microsoft Graph permite que os desenvolvedores gerenciem programaticamente delegadores e representantes. Os cenários comuns incluem:
- Configurando aparências de linha compartilhadas.
- Gerenciamento de permissões para fazer e receber chamadas.
- Simplificando os fluxos de trabalho de comunicação dentro das equipes.
Quem é um delegante?
Um delegante é um usuário que concede a outro usuário (delegado) a capacidade de realizar determinadas ações em seu nome. Essas ações podem incluir fazer e receber chamadas, gerenciar configurações de chamada ou ingressar em chamadas ativas. Os delegantes geralmente são usuários que precisam de ajuda para lidar com suas responsabilidades de comunicação.
Quem é um representante?
Um representante é um usuário a quem são atribuídas responsabilidades por um delegante. Os representantes podem executar ações específicas, como atender chamadas, iniciar chamadas e gerenciar configurações de chamada em nome do delegante. Essa função é comumente usada por assistentes ou membros da equipe para facilitar fluxos de trabalho de comunicação contínuos.
Casos de uso comuns
| Operação | Tipo de retorno | Descrição |
|---|---|---|
| Listar todos os delegados | Coleção delegationSettings | Obtenha uma lista de todos os representantes de um usuário. |
| Obter representante por ID | delegationSettings | Obtenha detalhes sobre um representante específico. |
| Listar todos os delegantes | Coleção delegationSettings | Obtenha uma lista de todos os delegantes para um usuário. |
| Obter delegante por ID | delegationSettings | Obtenha detalhes sobre um delegante específico. |
Próximas etapas
Use a API de delegação de chamada no Microsoft Graph para consultar e gerenciar representantes e delegantes 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.