使用MS Graph API创建的MS Teams频道默认隐藏问题求助

使用MS Graph API创建Teams团队及频道时，创建的频道始终处于隐藏状态，用户必须手动点击「显示」才能看到。即使在请求中设置了isFavoriteByDefault: true，也无法让频道默认显示给创建时加入的成员。

复现代码 #

$data = [
    'displayName' => 'Test MS Team',
    "template@odata.bind" => "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
    'description' => 'Created using MS Graph API v1',
    'channels' => [
        [
            'displayName' => 'Test channel 1',
            'isFavoriteByDefault' => true,
            'description' => 'Test channel 1 descriptions'
        ],
        [
            'displayName' => 'Test channel 2',
            'isFavoriteByDefault' => true,
            'description' => 'Test channel 2 descriptions'
        ]
    ],
    // 添加多个成员目前在MS Graph中暂不支持
    'members' => [
        [
            '@odata.type' => '#microsoft.graph.aadUserConversationMember',
            'roles' => ['owner'],
            'user@odata.bind' => "https://graph.microsoft.com/v1.0/users('{$this->me()->getId()}')"
        ],
    ]
];

$this->request('POST', '/teams', $data, [], true);

实际现象 #

创建完成后，团队中的新增频道处于隐藏状态，需手动点击「显示」才能查看：

解决方案 #

方案1：分两步创建团队和频道 #

将团队创建与频道添加拆分为两个独立操作，确保isFavoriteByDefault参数对所有现有成员生效：

1. 先创建不含频道的空团队
2. 等待团队异步创建完成（可通过轮询团队状态或监听webhook事件确认）
3. 单独调用频道创建接口添加频道

示例代码：

// 第一步：创建基础团队
$teamData = [
    'displayName' => 'Test MS Team',
    "template@odata.bind" => "https://graph.microsoft.com/v1.0/teamsTemplates('standard')",
    'description' => 'Created using MS Graph API v1',
    'members' => [
        [
            '@odata.type' => '#microsoft.graph.aadUserConversationMember',
            'roles' => ['owner'],
            'user@odata.bind' => "https://graph.microsoft.com/v1.0/users('{$this->me()->getId()}')"
        ],
    ]
];
$teamResponse = $this->request('POST', '/teams', $teamData, [], true);
$teamId = $teamResponse['id'];

// 等待团队异步初始化完成（建议添加延迟或轮询逻辑）
sleep(30); // 仅作示例，实际需根据团队创建状态调整

// 第二步：添加频道1
$channel1Data = [
    'displayName' => 'Test channel 1',
    'isFavoriteByDefault' => true,
    'description' => 'Test channel 1 descriptions'
];
$this->request('POST', "/teams/{$teamId}/channels", $channel1Data, [], true);

// 添加频道2
$channel2Data = [
    'displayName' => 'Test channel 2',
    'isFavoriteByDefault' => true,
    'description' => 'Test channel 2 descriptions'
];
$this->request('POST', "/teams/{$teamId}/channels", $channel2Data, [], true);

方案2：为现有成员手动添加频道收藏 #

如果需要在创建团队时同步添加频道，可在团队创建完成后，为每个成员调用接口将频道添加到收藏列表：

POST /users/{user-id}/teamwork/favorites/add
Content-Type: application/json

{
    "favoriteEntityType": "channel",
    "id": "{channel-id}"
}

原因说明 #

通过POST /teams一次性创建团队并添加频道时，isFavoriteByDefault参数仅对团队创建完成后新加入的成员生效。对于创建团队时已存在的成员（如示例中的团队所有者），该参数不会自动将频道设为默认收藏，因此频道会处于隐藏状态。

内容的提问来源于stack exchange，提问作者Majed Fayazi