Teams的MessageExtension最新功能：Initiate actions

官方文档到目前为止对这个initiate action的说明比较简洁，由于没有一步步的截图和说明，从头到尾看一遍可能还在云里雾里。

我一步步摸索着走了一遍，发现这个initiate action的功能如此强大，不敢独享，所以写此博文：

1. 新建bot，叫TestMsgExt，manifest文件中的composeExtensions部分如下，特别之处是“fetchTask"这个新的属性

"composeExtensions": [{"botId": "89e9cdd8-f500-4696-a701-7c2323f62a86","canUpdateConfiguration": true,"commands": [{"id": "start","type": "action","title": "start","description": "start","initialRun": true,"fetchTask": true,"context": ["commandBox","compose","message"],"parameters": [{"name": "param","title": "param","description": ""}]}]}
],

2. 将此bot加入某个teams里，在菜单里就可以看到这个TestMsgExt的bot了

3. 点击后，bot就会收到如下的json

{"name": "composeExtension/fetchTask","type": "invoke","timestamp": "2019-06-17T14:32:04.956Z","localTimestamp": "2019-06-18T00:32:04.956+10:00","id": "f:1361493733941541435","channelId": "msteams","serviceUrl": "https://smba.trafficmanager.net/apac/","from": {"id": "29:1l8B9m9SOOdHTqLDgmXvSrJyHfwd2ihooa7cxgtzJ8QjQ4WFC4mA_8K2Sa7jL-xUh7g4yh8sZIiDOX6vTtoaz6w","name": "Tony Xia","aadObjectId": "56c6599d-9216-4078-a8cf-3f039d36e1fd"},"conversation": {"isGroup": true,"conversationType": "channel","tenantId": "aece5000-341d-493a-841d-f67e417f1447","id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"recipient": {"id": "28:89e9cdd8-f500-4696-a701-7c2323f62a86","name": "TestMsgExt"},"entities": [{"locale": "en-US","country": "US","platform": "Windows","type": "clientInfo"}],"channelData": {"channel": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"team": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"tenant": {"id": "aece5000-341d-493a-841d-f67e417f1447"},"source": {"name": "compose"}},"value": {"commandId": "start","commandContext": "compose","context": {"theme": "default"}},"locale": "en-US"
}

4. 我的bot响应如下：

{"task": {"type": "continue","value": {"card": {"contentType": "application/vnd.microsoft.card.adaptive","content": {"body": [{"type": "TextBlock","text": "Please enter the following information:"},{"type": "TextBlock","text": "Name"},{"type": "Input.Text","spacing": "None","title": "New Input.Toggle","placeholder": "Placeholder text"},{"type": "TextBlock","text": "Date of birth"},{"type": "Input.Date","spacing": "None","title": "New Input.Toggle"}],"actions": [{"type": "Action.Submit","title": "Submit1","data": {"id": "Submit1"}},{"type": "Action.Submit","title": "Submit2","data": {"id": "Submit2"}}],"type": "AdaptiveCard","$schema": "http://adaptivecards.io/schemas/adaptive-card.json","version": "1.0"}}}}
}

Teams在收到我bot的响应后会显示如下的对话框，对话框里的内容就是我上面json里的adapative card。

5. 如果我们走官方文档中的"Compose extension result response" (https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/messaging-extensions/create-extensions#compose-extension-result-response) ，bot会收到如下请求：

{"name": "composeExtension/submitAction","type": "invoke","timestamp": "2019-06-17T14:36:26.449Z","localTimestamp": "2019-06-18T00:36:26.449+10:00","id": "f:2286900813950650039","channelId": "msteams","serviceUrl": "https://smba.trafficmanager.net/apac/","from": {"id": "29:1l8B9m9SOOdHTqLDgmXvSrJyHfwd2ihooa7cxgtzJ8QjQ4WFC4mA_8K2Sa7jL-xUh7g4yh8sZIiDOX6vTtoaz6w","name": "Tony Xia","aadObjectId": "56c6599d-9216-4078-a8cf-3f039d36e1fd"},"conversation": {"isGroup": true,"conversationType": "channel","tenantId": "aece5000-341d-493a-841d-f67e417f1447","id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"recipient": {"id": "28:89e9cdd8-f500-4696-a701-7c2323f62a86","name": "TestMsgExt"},"entities": [{"locale": "en-US","country": "US","platform": "Windows","type": "clientInfo"}],"channelData": {"channel": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"team": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"tenant": {"id": "aece5000-341d-493a-841d-f67e417f1447"},"source": {"name": "compose"}},"value": {"commandId": "start","commandContext": "compose","context": {"theme": "default"},"data": {"id": "Submit1","undefined": ""}},"locale": "en-US"
}

bot需要做如下响应，”preview“和”attachments“里的内容是可以根据自己的内容进行变化的，我这里使用了官方文档里的json。

{"composeExtension": {"type": "result","attachmentLayout": "list","preview": {"contentType": "application/vnd.microsoft.card.thumbnail","content": {"title": "85069: Create a cool app","images": [{"url": "https://placekitten.com/200/200"}]}},"attachments": [{"contentType": "application/vnd.microsoft.teams.card.o365connector","content": {"sections": [{"activityTitle": "[85069]: Create a cool app","activityImage": "https://placekitten.com/200/200"},{"title": "Details","facts": [{"name": "Assigned to:","value": "[Larry Brown](mailto:larryb@example.com)"},{"name": "State:","value": "Active"}]}]}}]}
}

可以看到我们的输入框里就有了一个adaptive card，我们就可以发送出去了

 

6. 如果我们走官方文档中的"Response with an adaptive card message sent from a bot" (https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/messaging-extensions/create-extensions#respond-with-an-adaptive-card-message-sent-from-a-bot)  ，bot会收到如下请求：

{"name": "composeExtension/submitAction","type": "invoke","timestamp": "2019-06-17T14:40:29.473Z","localTimestamp": "2019-06-18T00:40:29.473+10:00","id": "f:6033114440747937164","channelId": "msteams","serviceUrl": "https://smba.trafficmanager.net/apac/","from": {"id": "29:1l8B9m9SOOdHTqLDgmXvSrJyHfwd2ihooa7cxgtzJ8QjQ4WFC4mA_8K2Sa7jL-xUh7g4yh8sZIiDOX6vTtoaz6w","name": "Tony Xia","aadObjectId": "56c6599d-9216-4078-a8cf-3f039d36e1fd"},"conversation": {"isGroup": true,"conversationType": "channel","tenantId": "aece5000-341d-493a-841d-f67e417f1447","id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"recipient": {"id": "28:89e9cdd8-f500-4696-a701-7c2323f62a86","name": "TestMsgExt"},"entities": [{"locale": "en-US","country": "US","platform": "Windows","type": "clientInfo"}],"channelData": {"channel": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"team": {"id": "19:bf1cbc367561473db0c3fe762c11b508@thread.skype"},"tenant": {"id": "aece5000-341d-493a-841d-f67e417f1447"},"source": {"name": "compose"}},"value": {"commandId": "start","commandContext": "compose","context": {"theme": "default"},"data": {"id": "Submit2","undefined": ""}},"locale": "en-US"
}

bot需要返回一个adaptive card用来给用户预览，注意这里的type是botMessagePreview，这个是新的一种type。

{"composeExtension": {"type": "botMessagePreview","activityPreview": {"type": "message","attachments": [{"contentType": "application/vnd.microsoft.card.adaptive","content": {"body": [{"type": "TextBlock","text": "Please enter the following information:"},{"type": "TextBlock","text": "Name"},{"type": "Input.Text","spacing": "None","title": "New Input.Toggle","placeholder": "Placeholder text"},{"type": "TextBlock","text": "Date of birth"},{"type": "Input.Date","spacing": "None","title": "New Input.Toggle"}],"actions": [{"type": "Action.Submit","title": "Submit1","data": {"id": "Submit1"}},{"type": "Action.Submit","title": "Submit2","data": {"id": "Submit2"}}],"type": "AdaptiveCard","$schema": "http://adaptivecards.io/schemas/adaptive-card.json","version": "1.0"}}]}}
}

然后teams就会弹出对话框让用户进行对要发送的内容进行预览，预览的内容就是上面attachment里描述的adaptive card

接下去用户就可以点击Send，bot会再次收到一个消息，bot在消息处理的时候就可以发送这个预览的信息到channel里。

新的message extension处理机制，使得message extension十分灵活，同时体验的提升很多。官方文档有点简单，感兴趣的同学可以一步步走一遍，就能感受到这个新机制的强大之处。

 

 

 

 

 

 

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/278044.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Java枚举根据key获取value

Java枚举根据key获取value

package com.utcip.crm.common.constants; import com.utcip.crm.common.base.process.ScheduleStatusEnum; /** * 合同变更存储mongodb 状态值 * author jingfangnan * */ public enum ConstractMongoStatus { NEW(3,"新增"), UPDATE(2,"修改"), D…
阅读更多...
Selenium-基础操作

Selenium-基础操作

一、测试代码 Test public void test() { WebDriver driver new FirefoxDriver(); // 打开当前包中的index页面 driver.get("file:///D:/%E8%B5%B5%E6%AC%A2/Selenium/Selenium/src/com/html/index.html"); WaitSeconds(1000); // 清除用户输入 driver.findElement(…
阅读更多...
开发针对特殊租户的Teams机器人

开发针对特殊租户的Teams机器人

有些朋友问到，如果想要开发一个bot针对于Teams的某些租户，如何做？实际上微软的Teams的SDK早就提供了类似的功能。 如果你使用的是Javascript/Node.JS开发，使用session.message.sourceEvent.tenant.id 就可以知道当前消息来自于哪…
阅读更多...
行业看点 | 英特尔成功开发超导量子计算芯片 推动产业加速发展

行业看点 | 英特尔成功开发超导量子计算芯片 推动产业加速发展

量子计算将会成为下一次技术革命的核心，你可能认为它还很遥远，实际上量子计算会比预料的来得早。近期，英特尔在量子芯片方面取得突破，让量子计算朝着现实前进了一大步。 继IBM公司发布了自主量子处理器，谷歌着手研究基…
阅读更多...
Teams App抽奖机器人 - 基础架构

Teams App抽奖机器人 - 基础架构

今天我们来聊一下，一个Teams app的infrastructure，我在考虑LuckyDraw的主要出于这么几个出发点： 可管理性。因为这是一个个人产品，以后维护工作也只有我一个人，所以我希望整个infrastructure简单、易管理，不…
阅读更多...
Teams Bot的ServiceLevel测试

Teams Bot的ServiceLevel测试

每一个Teams bot实际上就是一个web api服务，这个服务通过Bot Framework和Teams进行通讯，所以对于Teams app的测试就是对于一个api service的测试。 软件行业发展到如今，测试技术已经趋于成熟。单元测试，冒烟测试，整合…
阅读更多...
BZOJ1016：[JSOI2008]最小生成树计数——题解

BZOJ1016：[JSOI2008]最小生成树计数——题解

https://www.lydsy.com/JudgeOnline/problem.php?id1016 现在给出了一个简单无向加权图。你不满足于求出这个图的最小生成树，而希望知道这个图中有多少个不同的最小生成树。（如果两颗最小生成树中至少有一条边不同，则这两个最小生成树就是不…
阅读更多...
如何做Teams Bot的测试覆盖

如何做Teams Bot的测试覆盖

在我昨天的文章中介绍了如果对Teams bot做service level的测试，那到底要写多少的测试代码才算够？如何才算测试到位了？这个时候我们就需要用”测试覆盖率”来衡量，虽然覆盖率高并不一定代表着就可以高枕无忧的以为我们软件质量高了…
阅读更多...
Spring Boot开发MongoDB应用实践

Spring Boot开发MongoDB应用实践

本文继续上一篇定时任务中提到的邮件服务，简单讲解Spring Boot中如何使用MongoDB进行应用开发。 上文中提到的这个简易邮件系统大致设计思路如下： 1、发送邮件支持同步和异步发送两种 2、邮件使用MongDB进行持久化保存 3、异步发送，直接将邮件…
阅读更多...
Teams Bot如何做全球化

Teams Bot如何做全球化

Office365在全球有大量的用户，可以说是拥有最多用户的商业SaaS平台。Teams最近在发展迅猛，有1300万日活用户，已经超越了Slack。? Microsoft Teams overtakes Slack with 13 million daily users 我在设计Teams LuckyDraw bot的时候就希望我…
阅读更多...
QuickBI助你成为分析师-邮件定时推送

QuickBI助你成为分析师-邮件定时推送

创建报表过程中经常需要将报表情况定时推送给其他用户，及时了解数据情况。高级版本邮件推送功能支持仪表板周期性推送到订阅人，默认以当前登录者视角查看，同时支持结合 行级权限进行权限控制 和 结合全局参数功能确定邮件推送内容参数&#x…
阅读更多...
2019年5月 Teams Community Call (China)

2019年5月 Teams Community Call (China)

这个月有四个话题： Tony Xia：这个月的Teams的产品更新，Teams开发能力的更新，开源项目更新，库更新王远：升级/迁移到Microsoft Teams刘钰：Teams账号注册探索指南Paul Zhang/Cheung：Bu…
阅读更多...
修改oracle 管理员密码 cmd

修改oracle 管理员密码 cmd

1.sqlplus/nolog 2.conn / as sysdba 3.alter user 用户名 identified by 新密码;转载于:https://www.cnblogs.com/taoqidexiaomao/p/9006927.html
阅读更多...
在2019年6月Teams Community Call上分享的Teams app基础架构视频

在2019年6月Teams Community Call上分享的Teams app基础架构视频

我在2019年6月Teams Community Call(China)上分享的如何在azure上搭建典型的teams bot的基础架构 会议视频： 15:00 - 33:00 Download Video
阅读更多...
解决 spring-cloud-starter-zipkin 启动错误

解决 spring-cloud-starter-zipkin 启动错误

应用场景&#xff1a;Spring Boot 服务添加 Zipkin 依赖&#xff0c;进行服务调用的数据采集&#xff0c;然后进行 Zipkin-Server 服务调用追踪显示。 示例pom.xml配置&#xff1a; <parent><groupId>org.springframework.boot</groupId><artifactId>s…
阅读更多...
什么是Microsoft Teams的App Studio

什么是Microsoft Teams的App Studio

Teams的app studio很多用户可能不知道&#xff0c;但是对于一个teams平台的开发人员来说&#xff0c;这个是开发利器&#xff0c;利用这个工具你可以轻松的配置manifest文件&#xff0c;可以轻松的一站式创建teams app所需要的所有东西。而且你可以很方便的可视化配置adaptive …
阅读更多...
Spring Cloud-鸿鹄Cloud分布式微服务云系统—架构图

Spring Cloud-鸿鹄Cloud分布式微服务云系统—架构图

这边结合了当前大部分企业的通用需求&#xff0c;包括技术的选型比较严格、苛刻&#xff0c;不仅要用业界最流行的技术&#xff0c;还要和国际接轨&#xff0c;在未来的5~10年内不能out。作为公司的架构师&#xff0c;也要有一种放眼世界的眼光&#xff0c;不仅要给公司做好的技…
阅读更多...
Teams bot的调用限制

Teams bot的调用限制

上个月Teams团队发布了对Teams app/bot调用api的频率的限制。这也从侧面说明Teams app越来越多&#xff0c;Teams团队需要优先保证Teams本身的计算资源&#xff0c;来提供流畅的用户体验。 具体的每个限制指标在这里&#xff1a; https://docs.microsoft.com/en-us/microsoftt…
阅读更多...
Array的sort方法

Array的sort方法

作为一个刚开始学习的前端&#xff0c;小结一下&#xff1a;sort方法&#xff1a; 如果调用该方法时没有使用参数&#xff0c;将按字母顺序对数组中的元素进行排序&#xff0c;说得更精确点&#xff0c;是按照字符编码的顺序进行排序。要实现这一点&#xff0c;首先应把数组的元…
阅读更多...
如何使用ARM创建Teams Bot所需要的Azure资源

如何使用ARM创建Teams Bot所需要的Azure资源

相信很多devops已经全面开始使用ARM来创建azure资源了&#xff0c;ARM有很多方便的地方&#xff0c;比如简单易学&#xff0c;Infrastructure as Code&#xff0c;但是深入使用ARM开始会发现一些有待改进的方面。这篇文章主要是分享一下我在做Teams app的时候使用ARM来创建资源…
阅读更多...
最新文章

Copyright @ 2022~2023