开发Teams的messaging extension

什么是Messaging Extension

Messaging Extension是微软Teams的一种十分有用的扩展方式。可以让用户发送adaptive cards。具体的说明不在这里展开了。可以阅读微软官方的详细说明：

准备工作

因为开发一个Messaging Extension涉及到的方面比较多，我在本地dotnet里添加一个Teams的模板，让开发更加简单

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

installed-templates

开发步骤

  • 因为我们的web api会监听5000端口，运行ngrok，讲请求转发到此端口 ngrok.exe http 5000

  • 拷贝ngrok生成的url. ngrok

  • 使用Teams App Studio或者在Bot Framework网站上创建一个bot https://dev.botframework.com/bots/new. 进一步的详细信息在 这里. 对于 Messaging endpoint, 填入我们前一步拷贝的ngrok的url，并且在url后加上这个：/api/extension

bot-reg

  • 在bot被成功创建后，记住生成的 Microsoft App ID ，我们在下一步会用到这个。

get-app-id

  • 运行 dotnet new teamsmsgext --name SampleApp 来生成一个项目的框架.

  • 用你最喜爱的编辑工具打开 SampleApp/manifest/manifest.json 文件, 用上一步骤获取的 Microsoft App ID 进行替换.

manifest-json

  • 打包 SampleApp/manifest 这个目录，生成 manifest.zip 文件.

zip-manifest

  • 上传 manifest.zip 文件到你的Teams里. Manage Team -> Apps, 点击右下方的链接 Upload a custom app

upload-custom-app

  • 运行你的项目，执行 dotnet run.

  • 搞定了！你现在可以切换到 Microsoft Teams，选择刚才上传zip文件的那个团队，进入这个团队的任意一个聊天频道（channel），点击输入框下方的 ... 按钮，你就可以看到你自己的 messaging extension了！

msg-ext

msg-ext-select-city

msg-ext-seattle

Written on December 1, 2018