Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você 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.
O Microsoft Teams é um espaço de trabalho baseado em chat no Microsoft 365 que fornece acesso interno a calendários, arquivos, anotações do OneNote, planos do Planner e muito mais. Você pode usar a API do Graph para integração com os recursos do Microsoft Teams.
Casos de uso comuns
A tabela a seguir lista casos de uso comuns para APIs do Microsoft Teams no Microsoft Graph.
| Casos de uso | Recursos REST | Confira também |
|---|---|---|
| Criar e gerenciar equipes, grupos e canais | equipe, canal, grupo | Criar equipe, listar equipes, criar um canal |
| Adicionar guias, gerenciar ou instalar aplicativos no catálogo de aplicativos do Microsoft Teams | teamsTab, teamsAppInstallation | criar teamsTab, listar teamsTab, listar installedApps |
| Criar canais e chats para enviar e receber mensagens de chat | canal, chat, chatMessage | criar canal, listar canal, enviar chatMessage em um canal |
| Use marcas para classificar usuários ou grupos com base em atributos comuns em uma equipe | teamworkTag, teamworkTagMember | listar teamworkTag, criar teamworkTag |
| Criar e receber chamadas, registros de chamadas ou recuperar coordenadas de reuniões | call, callRecords | Responder, convidar participantes |
| Conecte bots a chamadas e implemente uma resposta de voz interativa (IVR) | chamada | Cenários IVR |
| Criar e recuperar reuniões online ou marcar a presença e a atividade dos usuários | onlineMeeting, presença | criar onlineMeeting, meetingAttendanceReport |
| Crie e gerencie a integração da força de trabalho com turnos, agendas, cartões de ponto ou folgas em sua organização | workforceIntegration, agendar, turno, timeOff, timeOffReason | criar força de trabalhoIntegração, criar agenda,criar turno, criar folga |
| Usar a API de aprendizado dos funcionários para integração com o Viva Learning | aprendizagem do funcionário, learningProvider, learningContent | listar learningProviders, listar learningContents |
| Organize chats, canais e reuniões em seções personalizadas ou definidas pelo sistema na lista de chat de um usuário | teamworkSection, teamworkSectionItem | listar seções, criar seção, reordenar seções, adicionar item, mover item, reordenar itens |
Cenários IVR
Veja a seguir os cenários de IVR (Resposta de Voz Interativa) compatíveis com as APIs de chamada no Microsoft Graph:
- Reproduza um prompt de áudio , por exemplo, quando uma chamada for colocada na fila de um agente de atendimento ao cliente.
- Grave uma resposta - por exemplo, para gravar o áudio da pessoa que ligou, geralmente depois que ela ouviu uma solicitação com opções.
- Assine os tons - por exemplo, quando quiser saber quais tons DTMF o chamador selecionou, geralmente depois de ouvir o prompt de áudio.
- Cancelar o processamento de mídia - por exemplo, quando você quiser cancelar qualquer operação playPrompt ou recordResponse que possa estar em andamento.
Limites do Microsoft Teams
As limitações de desempenho e de capacidade testadas do Microsoft Teams estão documentadas nas especificações e limites do Microsoft Teams. Esses limites aplicam-se diretamente ao usar o Microsoft Teams ou usar as APIs do Microsoft Graph. Como todas as equipes têm um grupo correspondente, e cada grupo é um objeto de diretório, limites no número de grupos e o número de objetos de diretório ("recursos") também podem ser levados em consideração.
Os arquivos dentro de canais são armazenados no SharePoint. os limites do SharePoint Online se aplicam.
Confira também redução dos limites dos serviços do Microsoft Teams.
Equipes e grupos
Na Microsoft Graph, o Microsoft Teams é representado por um recurso de grupo. Os grupos do Microsoft Teams e Microsoft 365 atendem às várias necessidades de colaboração em grupo. Quase todos os recursos baseados em grupo se aplicam aos grupos do Microsoft Teams e do Microsoft 365, como calendário de grupo, arquivos, anotações, fotos, planos e assim por diante. A principal diferença entre uma equipe e um grupo do Microsoft 365 é o modo de comunicação entre os membros. Os membros do Teams se comunicam por meio de chat persistente no contexto de uma equipe específica. Os membros do grupo do Microsoft 365 se comunicam por conversas em grupo, que são conversas de email que ocorrem no contexto de um grupo no Outlook.
Qualquer grupo que tenha uma equipe possui uma propriedade resourceProvisioningOptions que contém "Team".
Observação: a propriedade Group.resourceProvisioningOptions pode ser alterada. Não adicione ou remova "Team" dessa coleção; caso contrário, você obterá resultados incorretos ao listar todas as equipes.
Veja a seguir as diferenças no nível da API entre equipes e grupos:
- O chat persistente está disponível apenas para o Microsoft Teams. Esse recurso é representado hierarquicamente pelos recursos channel e chatMessage.
- As conversas em grupo estão disponíveis apenas para grupos do Microsoft 365. Esse recurso é representado hierarquicamente pelos recursos conversation, conversationThread e post.
- O método Listar equipes unidas se aplica apenas ao Microsoft Teams.
- APIs de chamadas e reuniões online se aplicam apenas ao Microsoft Teams.
- Confira também os problemas conhecidos dessas APIs.
Alterações de associação no Microsoft Teams
| Caso de uso | Verbo | URL |
|---|---|---|
| Adicionar membro | POST | /teams/{team-id}/members |
| Remover membro | DELETE | /teams/{team-id}/members/{membership-id} |
| Atualizar a função do membro | PATCH | /teams/{team-id}/members/{membership-id} |
| Atualizar equipe | PATCH | /teams/{team-id} |
Requisitos de sondagem
Se seu aplicativo sonda para ver se um recurso foi alterado, você só poderá fazer isso uma vez por dia. (teamsAsyncOperation é uma exceção no sentido de que é foi desenvolvida para ser sondada frequentemente.) Se você precisar saber sobre mudanças com mais frequência que esta, você deve criar uma assinatura para esse recurso e receber notificações de alteração (webhooks). Caso não encontre suporte para o tipo de assinatura necessária, recomendamos que você faça comentários por meio do Fórum de ideias da Plataforma para Desenvolvedores do Microsoft 365 .
Ao pesquisar novas mensagens, você deve especificar um intervalo de datas onde isso for possível. Para obter mais informações, consulte obter mensagens de chat delta para um usuário.
As sondagem está executando uma operação OBTER em um recurso repetidamente para ver se o recurso foi alterado. Você tem permissão para obter o mesmo recurso várias vezes por dia, desde que não seja uma sondagem. Por exemplo, não há problema em GET /me/joinedTeams sempre que o usuário visita/atualiza sua página da Web, mas não há problema em GET /me/joinedTeams em um loop a cada 30 segundos para atualizar essa página da Web.
Os aplicativos que não seguem esses requisitos de sondagem serão considerados violações de termos de uso das APIs da Microsoft. A violação destes Termos da API pode resultar suspensãoou no cancelamento do uso das APIs da Microsoft.