@mention via incoming webhook in MS Teams using MessageCard

Question

I have a onestep in Cherwell that based on a criteria triggers a webservice and sends a MessageCard over to a Channel in MS Teams. I cannot find a way to trigger an @mention when the message lands in the channel. With the current WFH all the technicians are in Teams and no so much on email so a Cherwell notification email may go unread for a while. If the @mention was a thing then we have a more dynamic response to some of these incidents that we need someone to jump on when they come into the system Thanks.

Answer 1

As of 21/09/2021, Microsoft has documentation for how this will be supported. However, Teams doesn't yet (Oct 2021) trigger the actual notification, see below.

Copying from the documentation:

User mention in Incoming Webhook with Adaptive Cards Incoming webhooks start to support user mention in Adaptive Cards with the AAD Object ID and UPN.

Note

Enable user mention in the schema for Incoming webhooks to support AAD Object ID and UPN. UI/UX changes are not required for user mentions with AAD Object ID and UPN. The activity feed notification for Incoming Webhook with user mention will be available in the future release.

Example for user mention in Incoming Webhook as follows:

JSON

{
"type": "message",
"attachments": [
    {
    "contentType": "application/vnd.microsoft.card.adaptive",
    "content": {
        "type": "AdaptiveCard",
        "body": [
            {
                "type": "TextBlock",
                "size": "Medium",
                "weight": "Bolder",
                "text": "Sample Adaptive Card with User Mention"
            },
            {
                "type": "TextBlock",
                "text": "Hi <at>Adele UPN</at>, <at>Adele AAD</at>"
            }
        ],
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.0",
        "msteams": {
            "entities": [
                {
                    "type": "mention",
                    "text": "<at>Adele UPN</at>",
                    "mentioned": {
                      "id": "AdeleV@contoso.onmicrosoft.com",
                      "name": "Adele Vance"
                    }
                  },
                  {
                    "type": "mention",
                    "text": "<at>Adele AAD</at>",
                    "mentioned": {
                      "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
                      "name": "Adele Vance"
                    }
                  }
            ]
        }
    }
}]
}

Following image illustrates user mention in Incoming Webhook:

For completeness, this is the code I used to test the above:

HttpResponseMessage response = await new HttpClient().PostAsync("https://XXXXXXX.webhook.office.com/webhookb2/XXXXXXXXXXX/IncomingWebhook/XXXXX/XXXXXXXXXXX",
    new StringContent(cardWithMentionsAsJsonString, Encoding.UTF8, "application/json"));