Crear equipos y administrar miembros mediante la API de Microsoft Teams

Puede usar la API de Microsoft Teams en Microsoft Graph para crear equipos de varias maneras. Este artículo describe el enfoque que recomendamos para los mejores resultados.

Crear un equipo

Todos los equipos tienen el respaldo de los grupos de Microsoft 365. La forma más rápida de hacer que su equipo esté listo para trabajar cuando se crean equipos nuevos a través de Microsoft Graph es configurando un nuevo grupo de Microsoft 365 con todos sus propietarios y miembros, y convertirlo en un equipo.

  1. Cree un grupo de Microsoft 365 usando la operación Crear grupo. Puede especificar propietarios y miembros. Asegúrese de que tiene los propietarios adecuados para el grupo recién creado, como se describe en el paso 2.

    Para crear un equipo para este grupo, debe establecer los siguientes valores de propiedad tal como se muestra a continuación:

    • 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"
        ]
    }
    

    En el ejemplo siguiente se muestra la respuesta.

    Nota: Puede que se acorte el objeto de respuesta que se muestra aquí para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada 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. Asegúrese de que el grupo tiene dos o más propietarios. Para hacerlo, puede usar la operación Agregar propietario. Deben ser cuentas de usuario reales y no cuentas de servicio. Tener dos propietarios ayuda a manejar los casos, como medida preventiva, en el caso de que un propietario abandone la empresa o no esté disponible para realizar operaciones de administración de equipos.

  3. Agregue al grupo a todos los miembros (e invitados si es necesario) mediante la operación agregar miembros si no lo ha hecho en el paso 1. Si va a agregar varios miembros, añada un 1 segundo de retardo después de cada operación de adición.

  4. Una vez que se haya creado el grupo correctamente, lo que puede tardar unos 15 minutos más una vez completado el paso 1, cree un equipo de Microsoft Teams con la operación crear equipo a partir de grupo. Si se produce un error, puede que el proceso de creación de grupos no se haya completado. Espere unos minutos y vuelva a intentarlo.

    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')"
    }
    

    En el ejemplo siguiente se muestra la respuesta.

    Nota: Puede que se acorte el objeto de respuesta que se muestra aquí para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.

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

    El equipo creado tiene el mismo identificador que el grupo.

  5. Cuando finalice este proceso, todos los propietarios y miembros deberían poder ver el equipo recién creado en el cliente de Teams.

Agregar o administrar miembros

Para agregar miembros después de crear un equipo, use la operación agregar miembro. Se recomienda agregar un retardo de 1 segundo entre las operaciones de adición. Tenga en cuenta lo siguiente con respecto a los cambios en la pertenencia:

  1. Los cambios de suscripción realizados en los grupos de Microsoft 365 se sincronizan con Teams a través de un mecanismo de sincronización en segundo plano que generalmente demora 24 horas (o más, en algunos casos).

  2. El proceso en segundo plano solo se activa si uno o más usuarios del equipo (propietario o miembro) están activos en el cliente de escritorio de Teams. Iniciar la aplicación Teams y/o que se esté ejecutando constituye una actividad: no es necesario que un usuario visite específicamente el equipo que se está modificando.

    Nota:

    Los clientes móviles de Teams no desencadenan la sincronización de suscripción. Al menos un usuario debe estar en el cliente de escritorio para garantizar que este proceso en segundo plano se ejecute sin inconvenientes.

Lista de comprobación para validación

Después de crear un equipo, puede usar la siguiente lista de comprobación para asegurarse de que el equipo se creó correctamente.

Validar la creación de equipos

  1. Compruebe que el grupo de Microsoft 365 que respalda al equipo se crea a través de los centros de administración de Microsoft Entra ID o Microsoft 365.

  2. Compruebe que la creación del equipo se haya realizado correctamente mediante el portal de administración de Teams.

  3. Compruebe que el equipo tiene los propietarios y miembros adecuados que aparecen en el portal de administración de Teams.

  4. Compruebe que los propietarios del equipo pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.

  5. Compruebe que los miembros pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.

Validar la adición de miembros

  1. Compruebe que los miembros recién aparecen en el grupo a través de la Microsoft Entra ID o Centro de administración de Microsoft 365.

  2. Compruebe que los nuevos miembros pueden ver al equipo después de iniciar sesión en el cliente de escritorio o Web de Teams.