如何建立 Microsoft Teams 的應用程式?
建立和發佈建置在 Microsoft Teams 平台的應用程式,包括決定建置哪些功能內容、建置 Web 服務、建立應用程式套件,以及將套件發佈給目標使用者。 由組織的系統管理員決定誰可以存取和安裝您的應用程式,而使用者將可自行決定在任何特定內容中安裝應用程式。 讓我們進一步查看每個步驟。
設計應用程式
為 Microsoft Teams 建立成功應用程式最重要的步驟,是選擇適當的組合擴充點和 UI 元素來利用。 您應該花很多時間了解您嘗試使用應用程式解決的問題,並經由使用者在 Microsoft Teams 用戶端中與應用程式互動的各種方式來規劃您的解決方案。 不要低估內容與範圍的重要性! 在一對一聊天中運作良好的交談式 Bot,在群組聊天或頻道交談中可能完全無法運作。
以下是您可用的功能,以及一些最適合案例的回顧。 您可以透過多種方式完成許多工作;為作業選擇正確的工具可提供更好的用戶體驗。
- 傳訊擴充功能 - 搜尋命令很適合讓使用者搜尋外部系統,然後在 Teams 中共用該搜尋的結果。 使用卡片和卡片動作,您可以豐富格式化該搜尋的結果,並允許使用者在結果上執行動作,而不需要離開 Microsoft Teams 用戶端。
- 訊息擴充功能 - 動作命令很適合在單一位置收集使用者的資訊,然後將該資訊傳送至您的 Web 服務。 在您需要建立某種記錄,或收集多個部分資訊做為單一交易一部分的情況下,這些案例會更為出色。
- 索引標籤 - 在群組和頻道中提供共用畫布供多人共同作業。 如果您有適用於一組人員的資訊或服務,應該將此新增到您的應用程式。 請記住,每個人都在同一個畫布上工作,您的頁面應為無狀態,並且以單一頁面應用程式的方式運作。
- 索引標籤 - 在個人應用程式中允許個人網頁式體驗。 它們通常最適合「中樞」案例 -「指派給我的項目」或「我已建立的內容」。 它們對於靜態內容 (例如說明或頁面) 也很有用。
- 交談式 Bot - 在群組和頻道中可協助新增其他資訊至對涉及的每個人 (或至少大部分) 有用的交談。 它們可用來主動在交談中新增相關資訊,或回應使用者要求 (嗨 Bot,為午餐地點建立一個投票」)。 通常它們不應該用於多輪交談 - 使用工作模組收集資訊,或改為將交談移至一對一聊天,然後將結果插入原始交談。
- 交談式 Bot - 在個人應用程式中可以啟用極不同的工作負載。 幾個範例包括問答式 Bot、在其他系統中啟動工作流程的 Bot、會說笑話的 Bot 和記錄筆記的 Bot。 請記住,考慮交談式介面是否最適合呈現您的功能。
- Webhook 和連接器 對於允許使用者訂閱來自外部系統之通知訊息的通道很有用。
- 可使用會議應用程式來進行共同作業、合作、掌握最新動態的通訊和分享意見反應。 會議應用程式可為會議週期的每個階段提供使用者體驗。 會議生命週期包括會議前、會議中和會議後的應用程式體驗,視出席者的狀態而定。 在本單元中,您將了解如何建立要用於 Microsoft Teams 會議的自訂應用程式。
最佳的應用程式通常會利用多個擴充點。 例如,假設您的組織想要允許人員提交改進建議。 您可以使用傳訊擴充功能搜尋命令來建立應用程式,以尋找並共用現有的建議、新增動作命令以允許使用者建立和更新建議、頻道索引標籤,讓小組可以看到指派給他們的所有建議,以及個人索引標籤,讓使用者可以看到他們過去提交的所有建議。 新增使用自然語言處理和機器學習建置的交談式 Bot,讓使用者在建議中執行複雜的查詢,而且您獲得功能完整、完全整合的 Teams 應用程式!
準備開發環境
您至少需要存取已啟用自訂應用程式上傳的 Microsoft 365 組織。 如果您沒有,可以註冊 Microsoft 365 開發人員計畫來取得開發組織。 您也需要部署和託管 Web 服務的方法。 針對本機開發,您可以使用如 ngrok的通道服務,但針對生產環境,您需要部署服務,可能是雲端服務提供者 (例如 Azure)。 您可以使用內部部署基礎結構來託管 Web 服務,但它們必須可公開存取 (而不是在防火牆後面)。
選取開發環境
開發人員在建置 Microsoft Teams 應用程式時有多種選項。
社群型適用於 Microsoft Teams 的 Yeoman 產生器 (也稱為「yo teams」),在開發人員回答一些有關所建置 Microsoft Teams 應用程式類型的問題後,即會建立專案鷹架。 您可以在這裡深入了解適用於 Microsoft Teams 的 Yeoman 產生器:建立您的第一個 Microsoft Teams 應用程式。
Microsoft Teams 工具組可讓您直接在 Visual Studio Code 環境內直接建立自訂 Teams 應用程式。 工具組會引導您完成程式,並提供建置、偵錯及啟動 Teams 應用程式所需的一切。 您可以在這裡深入了解適用於 Visual Studio 及 Visual Studio Code 的 Microsoft Teams 工具組: 使用 Microsoft Teams 工具組建置應用程式。
建立您的 Web 服務
決定使用者如何與您的應用程式互動之後,就該建置為其提供動力的 Web 服務了。 根據您建立的功能,Teams 會提供各種 SDK、範本、程式碼範例和產生器,以協助您開始使用,包括:
- 適用於傳訊擴充功能與交談式 Bot 的 Bot Framework SDK
- 適用於索引標籤和其他內容頁面的 Teams JavaScript 用戶端 SDK
- 適用於在 Node.js 中建置應用程式的 Yeoman 產生器
- 網頁內容頁面的一組開放原始碼控制項 Fluent UI
- 準備正式上線的應用程式範本
有關可協助您開始使用的完整工具和範例清單,請參閱 完整文件。
請記住,您必須以一種可以透過網際網路公開存取的方式託管您的網路服務 (通常是在 Microsoft Azure 等雲端服務提供者中),並經由 HTTPS 提供內容。
建立應用程式套件
Web 服務已啟動並運作,您必須建立可在 Microsoft Teams 中發佈和安裝的應用程式套件。 應用程式套件包含兩個圖示和 JSON 資訊清單檔案,描述您應用程式的中繼資料、應用程式使用的擴充點,以及提供這些擴充點之服務的指標。
建立應用程式套件時,您可以選擇手動建立,或使用 App Studio,這是 Teams 中的應用程式,可協助建立 Teams 應用程式。 App Studio 會引導您建立應用程式資訊清單,並可以協助將 Bot 註冊到 Bot Framework。 它也包含卡片設計工具,可協助您以視覺化方式建立卡片和卡片動作,並將範例在 Teams 中傳送給自己。
發佈應用程式
您可以根據目標受眾,選擇三種發佈自訂 Microsoft Teams 應用程式的選項。
- 直接共用應用程式套件。 您可以選擇直接與使用者共用應用程式套件。 如果您的應用程式是針對少數受眾 (只有幾個小組或個人),以及在應用程式開發和測試期間,這非常有用。
- 將您的應用程式發佈至組織應用程式目錄。 如果您的應用程式適用於特定組織 (或者,如果自訂應用程式以滿足組織的特定需求),租用戶系統管理員可以將您的應用程式上傳至組織的應用程式目錄。 這會使貴組織任何人都可以安裝您的應用程式 (但不會自動安裝)。
- 將應用程式發佈到公開的應用程式市集。 如果您的應用程式是供所有 Teams 使用者使用,您可以提交應用程式,以在公開的應用程式市集中發佈。 您必須通過嚴格的審查流程,因此請確定沒有遺漏任何細節。
發佈應用程式時,您不只需要考慮想要的目標受眾,也要考慮您想要與貴組織共用應用程式的 IT 政策。 每個組織都有完整的控制權,可決定哪些應用程式能上傳至其組織應用程式目錄,以及哪些應用程式能從應用程式市集安裝。
安裝應用程式。
在 Microsoft Teams 中安裝應用程式是 特定內容。 安裝您應用程式的個人應用程式部分 (適用於個別使用者) 不會在任何特定小組中安裝應用程式,反之亦然。 在特定小組中安裝的應用程式不會在任何其他小組中安裝。 這表示您不應該假設應用程式已安裝在所有可能的內容中 - 可能沒有。 組織的 IT 系統管理員可以完全控制誰可以在哪些內容中安裝哪些應用程式,因此您也不應假設應用程式目前正在互動的使用者有在不同內容中安裝應用程式的權限。
無論好壞,從應用程式套件直接安裝應用程式通常受到嚴格限制,因此,如果您選擇直接共用應用程式套件來發佈應用程式,需要確保使用者可以進行安裝。