How can a microsoft botframework bot mention a user in an adaptivecard?

1
votes

Following the Schema explorer at adaptivecards.io, there is no schema available for a bot mentioning a user (and teams sending him the proper notification that he was mentioned afterwards).

See https://adaptivecards.io/explorer/ for reference.

We want to use the bot for proactive messages to our users. If a user gets mentioned in one other solution, we want to transfer that mentioning event to the teams channel conversation and leverage the ability of teams to notify the user appropriately.

Question: Is there a way to add a valid teams @mention to a channel member in a bot message using adaptivecards?

1
botframeworkmicrosoft-teamsadaptive-cardsmention

1 Answers

2
votes

Mentioning users can be done in AdaptiveCards according to this documentation: https://docs.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-format?tabs=adaptive-md%2Cconnector-html#mention-support-within-adaptive-cards

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, which includes the Teams user id of the user being mentioned

The mention object looks similar to this:

{
"msteams": {
    "entities": [{
        "type": "mention",
        "text": "<at>John Doe</at>",
        "mentioned": {
            "id": "8:orgid:{org-ID-of-the-user}",
            "name": "John Doe"
        }
    }]
}

}

The ID to mention a user needs to be in this format: 8:orgid:{org-ID-of-the-user}