How to mention a user in Adaptive Cards in MS Teams?

Question

I am trying to mention a user in MS Teams using Adaptive Cards but when Adaptive Cards payload is posted as a message, I could see it rendering as a plain text.

Below is the payload:

{   "contentType": "application/vnd.microsoft.card.adaptive",   "content": {     "type": "AdaptiveCard",     "body": [       {         "type": "TextBlock",         "text": "Hi Himanshu Shukla"       }     ],     "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",     "version": "1.0",     "msteams": {       "entities": [         {           "type": "mention",           "text": "Himanshu Shukla",           "mentioned": {             "id": "29:123124124124",             "name": "Himanshu Shukla"           }         }       ]     }   } }

I am following below documentation for it:

https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-format?tabs=adaptive-md%2Cdesktop%2Cconnector-html

Can you please help me to identify what I am doing wrong.

Answer 1

Himanshu Shukla - We have tested this using below card and it's working correctly at our end.
{

"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",

"type": "AdaptiveCard",

"version": "1.6",

"body": [

{

"type": "TextBlock",

"text": "<at>Alex Wilber</at> created the incident"

},

{

"type": "ActionSet",

"actions": [

{

"type": "Action.Execute",

"title": "Submit",

"verb": "submit"

}

]

}

],

"msteams": {

"entities": [

{

"type": "mention",

"text": "<at>Alex Wilber</at>",

"mentioned": {

"id": "User ID",

"name": "Alex Wilber"

}

}

]

}

} To include a mention in an Adaptive Card, your app needs to include the following elements:

• <at>username</at> in the supported Adaptive Card elements.
• The mention object inside of an msteams property in the card content includes the Teams user ID of the user being mentioned.
• The userId is unique to your bot ID and a particular user. It can be used to @mention a particular user. The userId can be retrieved using one of the options mentioned in get the user ID.

Ref Doc: https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-format?tabs=adaptive-md%2Cdesktop%2Cconnector-html%22learn.microsoft.com%22#mention-support-within-adaptive-cards

You have not use <at>username</at> tag correctly and User Id also wrong. Please use <at> tag and correct user ID and check again.

Answer 2

Himanshu Shukla -
We have tested this using below card and it's working correctly at our end.

{

"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",

"type": "AdaptiveCard",

"version": "1.6",

"body": [

{

"type": "TextBlock",

"text": "<at>Alex Wilber</at> created the incident"

},

{

"type": "ActionSet",

"actions": [

{

"type": "Action.Execute",

"title": "Submit",

"verb": "submit"

}

]

}

],

"msteams": {

"entities": [

{

"type": "mention",

"text": "<at>Alex Wilber</at>",

"mentioned": {

"id": "User ID",

"name": "Alex Wilber"

}

}

]

}

}

To include a mention in an Adaptive Card, your app needs to include the following elements:

• <at>username</at> in the supported Adaptive Card elements.
• The mention object inside of an msteams property in the card content includes the Teams user ID of the user being mentioned.
• The userId is unique to your bot ID and a particular user. It can be used to @mention a particular user. The userId can be retrieved using one of the options mentioned in get the user ID.

Ref Doc: https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-format?tabs=adaptive-md%2Cdesktop%2Cconnector-html%22learn.microsoft.com%22#mention-support-within-adaptive-cards

You have not use <at>username</at> tag correctly and User Id also wrong.
Please use <at> tag and correct user ID and check again.