在寫這篇文章的時候，這個新功能還處在 Public Review，這意味著可能（很小的可能性）這里寫的方法在正式發布前還會有一些改動。

之前有一些做teams app開發的朋友問過我，能不能主動給一個team或者一個用戶安裝一個指定的app，之前做不到，但現在可以了，方法如下：

1. 權限

先要確保你的app有?TeamsAppInstallation.ReadWriteSelfForUser.All?和?TeamsAppInstallation.ReadWriteSelfForTeam.All，從名字我們可以清楚的看到，一個權限是給一個用戶主動安裝app，第二是針對 team 的。

1. 找到要安裝的 app 的 id

我在前一篇博客文章里解釋過各種 id 的區別，簡單的說，開發者在 teams app 的 manifest json 文件里指定的 id，并且不是 teams app id，在manifest里指定的 id 在teams graph api里叫做 external id，而 app id 是 teams 自動生成的一個 id。需要我們通過這個api來獲取。

GET https://graph.microsoft.com/beta/appCatalogs/teamsApps?$filter=externalId eq '{11111111-2222-3333-4444-911d24850d7c}'Response body:
{"value": [{"id": "b1c5353a-7aca-41b3-830f-27d5218fe0e5","externalId": "11111111-2222-3333-4444-911d24850d7c","name": "Test app name","version": "0.0.1",......}]
}

上面的調用就是查詢一個 external id 是等于 manifest ID 的一個 app，而在返回的內容里的 “id” 就是我們需要的 app id。

1. 檢查這個 app 是否已經給 user 安裝過

GET https://graph.microsoft.com/beta/users/{user-id}/teamwork/installedApps?$expand=teamsApp&$filter=teamsApp/id eq '{teamsAppId}'

1. 安裝 app 如果上一步檢測下來，user并沒有安裝過這個 app 的話，那么我們就可以開始安裝 app 了。

POST https://graph.microsoft.com/beta/users/{user-id}/teamwork/installedAppsRequest body:
{"teamsApp@odata.bind" : "https://graph.microsoft.com/beta/appCatalogs/teamsApps/{teamsAppId}"
}

上面 4 部都完成后，那個user就可以開始使用 app 了