Microsoft Team Messaging Extension deep dive talk about Search Commands, Action Commands, Link Unfurling

1. Search Based
Messaging Extension
Build Messaging Extension with Microsoft Teams App
MS Teams Azure Bot
Action Based
Messaging Extension
Link Unfurling
Messaging Extension

2. Speaker Introduction
C# Corner MVP(3), MCP, MCTS,MCSA, OCA
http://manojmittalblogs.blogspot.in
https://www.youtube.com/user/manojmcans/videos
/Manojmcans
In/manoj-mittal-mcp-mcts-oca-mcsa/
https://www.c-sharpcorner.com/members/manoj-mittal
Manoj Mittal
Sr. Technical Architect
@ Mindtree Ltd

3. Build Messaging Extension with Microsoft Teams App
Overview
• Messaging Extension overview
• Search based Commands
• Action based Commands
• Link Unfurling
• Use Case : Search Patient via Custom API
using Messaging Extension

4. Overview of Messaging Extension in Microsoft Teams
What are Messaging Extensions ?
A way to “extend the message” and make conversation more interactive
A concept piggy-backing on the Bot Framework Invoke command
“Messaging extensions enable users to execute search queries or trigger actions in external systems. The
results of these actions are sent from your custom web service to the Microsoft Teams client as embedded
web pages or richly formatted cards”

5. Can be invoked from one of the following location in Microsoft Teams App
1. Command Box
2. Compose Message Box
3. Message More Action Menu
• Implemented as Web Services
• Microsoft Teams Communicate with the web services via Bot Framework
• Messaging Extension are registered as bots with Bot Framework
• Web Services responds with task modules or rich formatted cards
How Messaging Extension Works

7. Overview
• Search Commands
• Implement search command message
handler

8. Search command can be trigger from
the following locations
1. Command Box
2. Compose Message Box
Developing Search Commands with message extension handlers

9. Search based Messaging Extension
• Search Query is send from Microsoft Teams to your web services.
• Your web services responds with list or grids of results.
• When user select a results, it is added to compose message box as a card or text.

10. Register search based Messaging Extension in the app manifest file
"composeExtensions": [
{
"botId": "",
"canUpdateConfiguration": true,
"commands": [
{
"id": "searchQuery",
"context": [ "compose", "commandBox" ],
"description": "Test command to run query",
"title": "Search",
"type": "query",
"parameters": [
{ … }
] } ] } ]

11. Implement search commands messaging extension

12. Deploy search based Messaging Extension in the App Studio

13. Overview
• Action Commands
• Implement action command message
handlers

14. Messaging Extension Action Scenario
Perform action in external system & include result in conversation
Complete complex tasks involving multiple steps and share results

15. Developing action based Messaging Extension (1/2)
The messaging extensions action command allows users to collect information using modal
popup, process their information, and send it back to the Teams channel conversation area.
When Invoked, JSON payload
send to registered web
services.
When web services respond
with task module implemented
with web interface or adaptive
cards.

16. Action based Messaging Extension (2/2)

17. Register action based Messaging Extension | Manifest file
"composeExtensions": [
{
"botId": "",
"commands": [ {
"id": "createCard",
"type": "action",
"context": [ "compose" ],
"parameters": [
{ }, { }, { }, ] },
{
"id": "shareMessage",
"type": "action",
"context": [ "message" ],
"parameters": [ { } ] } ] } ],

18. How will the action commands respond
Decide how the message will be sent back to user
• Insert message in the compose message box ?
• Respond directly to a conversation ?
When respond directly to conversation, must also register the web services as a bot in the
app manifest.

19. Implement & Handling action command messaging extension

20. Deploy action based Messaging Extension in the App Studio

21. Overview
• Unfurling links
• Implement link unfurling message handlers

22. Link Unfurling Messaging Extension
• Messaging extensions Link Unfurling invokes the activity when the hyperlink from defined domain
(defined or whitelist into the manifest file) is pasted into the message compose area.
• Link Unfurling help to respond to the full hyperlink with richly formatted card as well as
additional information similar to search result

23. Register link unfurling Messaging Extension in the app manifest file
"composeExtensions": [
{
"botId": "",
"commands": [
{
"context": [ "commandBox" ],
"type": "query"
"messageHandlers": [
{
"type": "link",
"value": {
"domains": [
"*.botframework.com", "*.wikipedia.org"
] } } ] } ]

24. Create and send card when search command is invoked

25. Deploy link unfurling Messaging Extension in the App Studio