Criar equipes e gerenciar membros usando a API do Microsoft Teams

  • Artigo

Você pode usar a API do Microsoft Teams no Microsoft Graph para criar equipes de várias maneiras. Este artigo descreve a abordagem que recomendamos para obter os melhores resultados.

Criar uma equipe

Todas as equipes têm o respaldo de grupos do Microsoft 365. A maneira mais rápida de configurar e utilizar sua equipe ao criar novas equipes através do Microsoft Graph é configurar um novo grupo do Microsoft 365, todos os proprietários e membros e convertê-los em uma equipe.

  1. Crie um grupo do Microsoft 365 usando a operação criar grupo. Você pode especificar os proprietários e os membros. Certifique-se de que tenha os proprietários certos do grupo recém-criado, conforme descrito na Etapa 2.

    Para criar uma equipe para esse grupo, é necessário definir os seguintes valores de propriedade, conforme mostrado:

    • groupTypes = { "Unified" }
    • mailEnabled = true
    • securityEnabled = false
    POST /groups
{
    "displayName":"Flight 157",
    "mailNickname":"flight157",
    "description":"Everything about flight 157",
    "visibility":"Private",
    "groupTypes":["Unified"],
    "mailEnabled":true,
    "securityEnabled":false,
    "members@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/bec05f3d-a818-4b58-8c2e-2b4e74b0246d",
        "https://graph.microsoft.com/v1.0/users/ae67a4f4-2308-4522-9021-9f402ff0fba8",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783",
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133"
    ],
    "owners@odata.bind":[
        "https://graph.microsoft.com/v1.0/users/6a1272b5-f6fc-45c4-95fe-fe7c5a676133",
        "https://graph.microsoft.com/v1.0/users/eab978dd-35d0-4885-8c46-891b7d618783"
    ]
}

    O exemplo a seguir mostra a resposta.

    Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade. Todas as propriedades serão retornadas de uma chamada real.

    HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#groups/$entity",
    "id":"b7f968af-ca51-42f6-a77e-82c7147bc8f2"
}

  2. Certifique-se de que o grupo tenha dois ou mais proprietários. É possível fazer isso por meio da operação adicionar proprietário. Elas devem ser contas de usuários reais e não contas de serviço. Ter dois proprietários ajuda a lidar com casos em que um proprietário sai da empresa ou não está disponível para realizar operações de gerenciamento de equipe.

  3. Adicione todos os membros (e convidados, se necessário) ao grupo usando a operação adicionar membro, se você não fez isso na Etapa 1. Se você estiver adicionando vários membros, adicione um atraso de 1 segundo após cada operação de adição.

  4. Depois que o grupo for criado com sucesso, o que pode levar até 15 minutos após a conclusão da Etapa 1, crie uma equipe do Microsoft Teams usando a operação criar equipe a partir de grupo. Se houver um erro, o processo de criação de grupo pode não ser concluído, tente esperar alguns minutos.

    POST https://graph.microsoft.com/v1.0/teams
Content-Type: application/json
{
  "template@odata.bind": "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
  "group@odata.bind": "https://graph.microsoft.com/v1.0/groups('groupId')"
}

    O exemplo a seguir mostra a resposta.

    Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade. Todas as propriedades serão retornadas de uma chamada real.

    HTTP/1.1 202 Accepted
Content-Type: application/json
Location: /teams/{teamId}/operations/{operationId}
Content-Location: /teams/{teamId}
{
}

    A equipe criada tem a mesma ID do que o grupo.

  5. Após concluir o processo, todos os proprietários e membros poderão ver a equipe recém-criada no cliente do Teams.

Adicionar ou gerenciar membros

Para adicionar membros depois de criar uma equipe, use a operação adicionar membro. É recomendável adicionar um atraso de 1 segundo entre as operações adicionar. Observe o seguinte em relação às alterações de associação:

  1. As alterações de associação feitas nos grupos do Microsoft 365 são sincronizadas com o Teams por meio de um mecanismo de sincronização de tela de fundo que geralmente demora 24 horas ou mais, em alguns casos.

  2. O processo em segundo plano será acionado somente se um ou mais usuários na equipe (proprietário ou membro) estiverem ativos no cliente da área de trabalho do Teams. A inicialização do aplicativo Teams e/ou sua execução constitui atividade. Um usuário não precisa visitar especificamente a equipe que está sendo modificada.

    Observação

    Os clientes móveis do Teams não acionam a sincronização de associação. Pelo menos um usuário deve estar no cliente da área de trabalho para garantir que esse processo em segundo plano corra bem.

Lista de verificação para validação

Depois de criar uma equipe, você pode usar a lista de verificação a seguir para verificar se a equipe foi criada com êxito.

Validar a criação de equipe

  1. Verifique se o grupo do Microsoft 365 que apoia a equipe é criado por meio dos centros de administração do Microsoft Entra ID ou do Microsoft 365.

  2. Verifique se a criação da equipe foi bem-sucedida por meio do portal de administração do Teams.

  3. Verifique se a equipe possui os proprietários e membros corretos listados por meio do portal de administração do Teams.

  4. Verifique se os proprietários da equipe conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.

  5. Verifique se os membros conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.

Validar a adição de membros

  1. Verifique se membros recém-exibidos no grupo por meio do Microsoft Entra ID ou Centro de administração do Microsoft 365.

  2. Verifique se os membros recém-adicionados conseguem ver a equipe após entrar no cliente da Web ou da área de trabalho do Teams.

Conteúdo relacionado