How to setup mentions in MSTeams #16

Nestor231 · 2022-01-13T09:30:15Z

Hi @onozaty !

Good day!

I have a question, I'm trying to use this plugin in conjunction with MS Teams,

but I don't know what should I supply on the Assign Notice ID and how do i retrieve that id,

I am trying to get the mentions working on MSTeams, How do I do it?

Thanks!

onozaty · 2022-01-13T23:47:24Z

Hi @Nestor231

In Teams, Incoming Webhooks do not allow for Mentions.
Therefore, it is not possible to use this plugin for mentioning either.

When Teams supports it, we will consider supporting it in this plugin as well.

Thanks.

Nestor231 · 2022-01-14T05:54:08Z

Hello @onozaty

I appreciate your fast feedback :)

Actually mentions is already supported in their MSTeams incoming webhook

Please check this link for reference

Using AdaptiveCards For Teams Mention When sending message

i tested this as well using json and submitted a request to an incoming webhook that i set up with a channel.

Here's the sample json request body i used for the request:

{
	"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": "[Project Name] Hi, <at>Sample_Name</at>. A redmine ticket has been assigned to you."
				}
			],
			"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
			"version": "1.0",
			"msteams": {
                                "width": "Full",
				"entities": [{
					"type": "mention",
					"text": "<at>Sample_Name</at>",
					"mentioned": {
						"id": "<email_registered_on_teams >", // For confidentiality purposes
						"name": "<name_registered_on_teams>"
					}
				}]
			}
		}
	}]
}

From what I learned by playing around with the request body:

in teams, id can be the mentioned user's email address on teams. ( Assign Notice ID can be set as the user's teams email address for this matter)
"name" under "mentioned" on the "msteams" field is the display name that will be displayed (FirstName LastName combination from redmine can be displayed as the value)

And here's the result:

onozaty · 2022-01-14T16:15:38Z

Hi @Nestor231

Thank you for the information.

I found out that it is supported by Adaptive Cards in Teams.

I would like to consider implementing it.
I think the information you provided will be very helpful in implementation.

Thank you very much.

Nestor231 · 2022-01-17T03:41:32Z

You're welcome @onozaty,

Have a great day!

onozaty · 2022-01-18T23:51:51Z

Hi @Nestor231

I'm trying out a small message to see if I can make a mention.

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "body": [
          {
            "type": "TextBlock",
            "text": "Hi <at>UserA</at>"
          }
        ],
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.0",
        "msteams": {
          "entities": [
            {
              "type": "mention",
              "text": "<at>UserA</at>",
              "mentioned": {
                "id": "user@example.com",
                "name": "HogeHoge"
              }
            }
          ]
        }
      }
    }]
}

I thought that if I changed the email address in the id to the email address used when logging in to Teams as appropriate, I would be able to make a Mention, but it hasn't worked.

The color of the username part changes, but it does not become a link.
Also, no mentions are made.

If you can find anything strange, I would appreciate your advice.
I am using Teams Free (classic) to verify.

Thanks.

Nestor231 · 2022-01-19T02:23:44Z

Hello @onozaty ,

I tested your request body, and it's working fine on my end.
I'm not sure if it's because you're using Teams Free.

I tested this using Microsoft Teams Version 1.4.00.32771 (64-bit). It was last updated on 12/13/2021.

Nestor231 · 2022-01-19T02:29:35Z

I was able to replicate what you did just now.

In my case, i used an email which is not registered within teams.

I am not sure with Teams Free with that behavior.

What I can infer is that, Teams couldn't find the said email that you used for the mention
or that there's a limitation on Teams Free. I'm not sure which is the case though

onozaty · 2022-01-19T14:29:56Z

Thank you for trying it.

The email address "user@example.com" will be replaced with the email address used to log in to Teams.
It may be a limitation in Teams Free.

onozaty · 2022-01-29T15:11:14Z

Hi @Nestor231

I have implemented it.
Could you please give it a try?

It is still in branch status.
Please checkout "feature/17-teams-adaptive-cards" and give it a try.

git fetch
git checkout feature/17-teams-adaptive-cards

Thanks.

Nestor231 · 2022-01-31T07:29:35Z

Hello @onozaty ,

Sorry I replied so late,

I have tested it now and,

Yep, It's working! Thanks man ! much appreciated

onozaty · 2022-01-31T13:58:01Z

Thanks for the confirmation!
Thanks to your support, I was able to implement it.

It will be officially released as version 2.1.0 later.

onozaty · 2022-02-01T14:40:45Z

It has been officially released as v2.1.0.

Thanks!

Nestor231 · 2022-02-02T02:48:37Z

You're welcome man and thanks!
Looking forward to more of your projects in the future ^_^

Jiemin17 · 2022-12-02T07:28:08Z

Hi @onozaty
I have the same problem
and I would like to ask how did you solve it in the end

onozaty · 2022-12-02T15:09:49Z

Hi @Jiemin17
I changed the format of the message so that it can be mentions.

https://learn.microsoft.com/en-us/microsoftteams/platform/task-modules-and-cards/cards/cards-format?tabs=adaptive-md%2Cdesktop%2Cconnector-html#user-mention-in-incoming-webhook-with-adaptive-cards

What problems do you have?

Jiemin17 · 2022-12-05T02:05:38Z

Hi @onozaty
Thanks for your reply.
My problem is that I can't tag anyone either
My code :

{
    "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": "try to at <at>me</at> and <at>karenlian</at>"
                }
            ],
            "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
            "version": "1.0",
            "msteams": {
                "entities": [
                    {
                        "type": "mention",
                        "text": "<at>me</at>",
                        "mentioned": {
                          "id": "jie@xxx.biz",
                          "name": "me"
                        }
                      },
                      {
                        "type": "mention",
                        "text": "<at>karenlian</at>",
                        "mentioned": {
                          "id": "karenlian@xxx.biz",
                          "name": "karenlian"
                        }
                      }
                ]
            }
        }
    }]
}

In the picture, although the text has turned blue, the members have not been tagged successfully

onozaty · 2022-12-05T03:14:51Z

Hi @Jiemin17

I see that the question is not about this plugin.

The format seems to be correct.
If the UPN was wrong, this could happen.
The part specified in mentioned/id.

This is usually the email address used to log in to Teams, but depending on how AD is operated, the UPN may not match the email address.

Thanks.

nicoardizzoli · 2023-05-03T08:17:07Z

Hello there, Someone knows how can i mention @general (and not users). I really need this functionality

onozaty · 2023-05-03T10:25:20Z

Hello there, Someone knows how can i mention general (and not users). I really need this functionality

Adaptive cards in Teams does not yet seem to support mentions to channels or teams.

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

Thanks.

nicoardizzoli · 2023-05-03T10:42:57Z

Thanks @onozaty and do you know how can i make it ? i need to send a notificacion from a backend application (springboot) via webhook to a teams channel, and i need to mark this message as IMPORTANT or mention General to make teams throws a notificacion to the users in this channel

onozaty · 2023-05-04T13:04:05Z

Webhook does not support this, so it will be necessary to use other methods.
For example, the Graph API appears to allow mentions to be made to channels.

https://learn.microsoft.com/en-us/graph/api/chatmessage-post?view=graph-rest-1.0&tabs=java#example-7--a-channel-in-a-channel-message

Thanks.

onozaty mentioned this issue Jan 14, 2022

[Teams] The Adaptive Cards format is used to support mentions #17

Closed

Nestor231 closed this as completed Feb 2, 2022

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

How to setup mentions in MSTeams #16

How to setup mentions in MSTeams #16

Nestor231 commented Jan 13, 2022 •

edited

onozaty commented Jan 13, 2022 •

edited

Nestor231 commented Jan 14, 2022 •

edited

onozaty commented Jan 14, 2022

Nestor231 commented Jan 17, 2022

onozaty commented Jan 18, 2022

Nestor231 commented Jan 19, 2022 •

edited

Nestor231 commented Jan 19, 2022 •

edited

onozaty commented Jan 19, 2022

onozaty commented Jan 29, 2022

Nestor231 commented Jan 31, 2022 •

edited

onozaty commented Jan 31, 2022

onozaty commented Feb 1, 2022

Nestor231 commented Feb 2, 2022

Jiemin17 commented Dec 2, 2022

onozaty commented Dec 2, 2022

Jiemin17 commented Dec 5, 2022

onozaty commented Dec 5, 2022

nicoardizzoli commented May 3, 2023 •

edited

onozaty commented May 3, 2023

nicoardizzoli commented May 3, 2023

onozaty commented May 4, 2023

How to setup mentions in MSTeams #16

How to setup mentions in MSTeams #16

Comments

Nestor231 commented Jan 13, 2022 • edited

onozaty commented Jan 13, 2022 • edited

Nestor231 commented Jan 14, 2022 • edited

onozaty commented Jan 14, 2022

Nestor231 commented Jan 17, 2022

onozaty commented Jan 18, 2022

Nestor231 commented Jan 19, 2022 • edited

Nestor231 commented Jan 19, 2022 • edited

onozaty commented Jan 19, 2022

onozaty commented Jan 29, 2022

Nestor231 commented Jan 31, 2022 • edited

onozaty commented Jan 31, 2022

onozaty commented Feb 1, 2022

Nestor231 commented Feb 2, 2022

Jiemin17 commented Dec 2, 2022

onozaty commented Dec 2, 2022

Jiemin17 commented Dec 5, 2022

onozaty commented Dec 5, 2022

nicoardizzoli commented May 3, 2023 • edited

onozaty commented May 3, 2023

nicoardizzoli commented May 3, 2023

onozaty commented May 4, 2023

Nestor231 commented Jan 13, 2022 •

edited

onozaty commented Jan 13, 2022 •

edited

Nestor231 commented Jan 14, 2022 •

edited

Nestor231 commented Jan 19, 2022 •

edited

Nestor231 commented Jan 19, 2022 •

edited

Nestor231 commented Jan 31, 2022 •

edited

nicoardizzoli commented May 3, 2023 •

edited