開發Teams的messaging extension

什麼是Messaging Extension

Messaging Extension是微軟Teams的一種十分有用的擴充方式。可以讓使用者發送adaptive cards。具體的說明不在這裡展開了。可以閱讀微軟官方的詳細說明：

• https://docs.microsoft.com/en-gb/microsoftteams/platform/concepts/messaging-extensions/messaging-extensions-overview

準備工作

因為開發一個Messaging Extension涉及到的方面比較多，我在本地dotnet裡添加一個Teams的模闆，讓開發更加簡單

c:\demo> dotnet new -i MicrosoftTeams.Templates
           

開發步驟

• 因為我們的web api會監聽5000端口，運作ngrok，講請求轉發到此端口 

  ngrok.exe http 5000

• 拷貝ngrok生成的url. 

  

• 使用Teams App Studio或者在Bot Framework網站上建立一個bothttps://dev.botframework.com/bots/new. 進一步的詳細資訊在 這裡. 對于 

  Messaging endpoint

  , 填入我們前一步拷貝的ngrok的url，并且在url後加上這個：

  /api/extension

• 在bot被成功建立後，記住生成的 

  Microsoft App ID

   ，我們在下一步會用到這個。

• 運作 

  dotnet new teamsmsgext --name SampleApp

   來生成一個項目的架構.
• 用你最喜愛的編輯工具打開 

  SampleApp/manifest/manifest.json

   檔案, 用上一步驟擷取的 

  Microsoft App ID

   進行替換.

• 打包 

  SampleApp/manifest

   這個目錄，生成 manifest.zip 檔案.

• 上傳 manifest.zip 檔案到你的Teams裡. 

  Manage Team -> Apps

  , 點選右下方的連結 

  Upload a custom app

• 運作你的項目，執行 

  dotnet run

  .
• 搞定了！你現在可以切換到 Microsoft Teams，選擇剛才上傳zip檔案的那個團隊，進入這個團隊的任意一個聊天頻道（channel），點選輸入框下方的 

  ...

   按鈕，你就可以看到你自己的 messaging extension了！