Merge pull request #25357 from microsoftgraph/users/sumanac/everyonementionv1.0

Mention everyone in chat for v1.0

Author: Danielabom

api-reference/v1.0/api/chatmessage-get.md

@@ -531,26 +531,26 @@ Content-type: application/json
 }
 ```
 
-### Example 6: Get a chat message with a forwarded message
+### Example 5: Get a chat message with an @mention for everyone
 
-The following example shows a request that gets a chat message with a forwarded message as an attachment.
+The following example shows a request to get a chat message that @mentions everyone in a group chat.
 
 #### Request
 
 The following example shows a request.
 
 <!-- {
   "blockType": "request",
-  "name": "get_chatmessage_6",
-  "sampleKeys": ["19:e2ed97baac8e4bffbb91299a38996790@thread.v2", "1727903166936"]
+  "name": "get_chatmessage_5",
+  "sampleKeys": ["19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2", "1725986575123"]
 }-->
 ```msgraph-interactive
-GET https://graph.microsoft.com/v1.0/chats/19:e2ed97baac8e4bffbb91299a38996790@thread.v2/messages/1727903166936
+GET https://graph.microsoft.com/v1.0/chats/19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2/messages/1725986575123
 ```
 
 #### Response
 
-The following example shows the response. The message body contains a forwarded message as an attachment. The **contentType** for the forwarded message is identified as `forwardedMessageReference`. The original message that was forwarded is also available in the attachment **content**.
+The following example shows the response. The message body contains an @mention for everyone in a group chat that is represented by the `<at></at>` tag. The **conversationIdentityType** property is set to `chat` in the **conversation** identity of the **mentioned** object.
 
 <!-- {
   "blockType": "response",
@@ -575,7 +575,7 @@ Content-type: application/json
     "deletedDateTime": null,
     "subject": null,
     "summary": null,
-    "chatId": "19:e2ed97baac8e4bffbb91299a38996790@thread.v2",
+    "chatId": "19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2",
     "importance": "normal",
     "locale": "en-us",
     "webUrl": null,
@@ -589,27 +589,33 @@ Content-type: application/json
         "user": {
             "@odata.type": "#microsoft.graph.teamworkUserIdentity",
             "id": "28c10244-4bad-4fda-993c-f332faef94f0",
-            "displayName": null,
+            "displayName": "Adele Vance",
             "userIdentityType": "aadUser",
             "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
         }
     },
     "body": {
         "contentType": "html",
-        "content": "<attachment id=\"1727881360458\"></attachment>"
+        "content": "<p>Hi&nbsp;<at id=\"0\">Everyone</at></p>"
     },
-    "attachments": [
+    "attachments": [],
+    "mentions": [
         {
-            "id": "1727881360458",
-            "contentType": "forwardedMessageReference",
-            "contentUrl": null,
-            "content": "{\"originalMessageId\":\"1727881360458\",\"originalMessageContent\":\"\\n<p>hello</p>\\n\",\"originalConversationId\":\"19:97641583cf154265a237da28ebbde27a@thread.v2\",\"originalSentDateTime\":\"2024-10-02T15:02:40.458+00:00\",\"originalMessageSender\":{\"application\":null,\"device\":null,\"user\":{\"userIdentityType\":\"aadUser\",\"tenantId\":\"2432b57b-0abd-43db-aa7b-16eadd115d34\",\"id\":\"28c10244-4bad-4fda-993c-f332faef94f0\",\"displayName\":null}}}",
-            "name": null,
-            "thumbnailUrl": null,
-            "teamsAppId": null
+            "id": 0,
+            "mentionText": "Everyone",
+            "mentioned": {
+                "application": null,
+                "device": null,
+                "user": null,
+                "tag": null,
+                "conversation": {
+                    "id": "19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2",
+                    "displayName": "Everyone",
+                    "conversationIdentityType": "chat"
+                }
+            }
         }
     ],
-    "mentions": [],
     "reactions": []
 }
 ```

api-reference/v1.0/resources/chatmessage.md

@@ -75,7 +75,7 @@ Represents an individual chat message within a [channel](channel.md) or [chat](c
 |lastModifiedDateTime|dateTimeOffset|Read only. Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed. |
 |lastEditedDateTime|dateTimeOffset|Read only. Timestamp when edits to the chat message were made. Triggers an "Edited" flag in the Teams UI. If no edits are made the value is `null`.|
 |locale|string|Locale of the chat message set by the client. Always set to `en-us`.|
-|mentions|[chatMessageMention](chatmessagemention.md) collection| List of entities mentioned in the chat message. Supported entities are: user, bot, team, and channel.|
+|mentions|[chatMessageMention](chatmessagemention.md) collection| List of entities mentioned in the chat message. Supported entities are: user, bot, team, channel, chat, and tag.|
 |messageHistory|[chatMessageHistoryItem](../resources/chatmessagehistoryitem.md) collection|List of activity history of a message item, including modification time and actions, such as reactionAdded, reactionRemoved, or reaction changes, on the message.
 |messageType|chatMessageType|The type of chat message. The possible values are: `message`, `chatEvent`, `typing`, `unknownFutureValue`, `systemEventMessage`. Note that you must use the `Prefer: include-unknown-enum-members` request header to get the following value in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `systemEventMessage`.|
 |policyViolation | [chatMessagePolicyViolation](chatmessagepolicyviolation.md) |Defines the properties of a policy violation set by a data loss prevention (DLP) application.|

api-reference/v1.0/resources/chatmessagemention.md

@@ -1,6 +1,6 @@
 ---
 title: "chatMessageMention resource type"
-description: "Represents a mention in a chatMessage entity. The mention can be to a user, team, bot or channel. "
+description: "Represents a mention in a chatMessage entity."
 ms.localizationpriority: medium
 author: "RamjotSingh"
 ms.subservice: "teams"
@@ -12,7 +12,7 @@ ms.date: 09/16/2024
 
 Namespace: microsoft.graph
 
-Represents a mention in a [chatMessage](chatmessage.md) entity. The mention can be to a [user](user.md), [team](team.md), bot, or [channel](channel.md). 
+Represents a mention in a [chatMessage](chatmessage.md) entity. The mention can be to a [user](user.md), [team](team.md), bot, [channel](channel.md), or [chat](chat.md). 
 
 In a **chatMessage** object that contains one or more mentions, the message body **content** property represents the chat message in HTML. It encloses the **mentionText** of each mention in an HTML `at` element, with an `id` attribute that corresponds to the **id** property of the mention.
 
@@ -35,7 +35,7 @@ For a fuller context of the example, see [List channel message replies](../api/c
 | Property	   | Type	|Description|
 |:---------------|:--------|:----------|
 |id|Int32|Index of an entity being mentioned in the specified **chatMessage**. Matches the {index} value in the corresponding `<at id="{index}">` tag in the message body.|
-|mentioned|[chatMessageMentionedIdentitySet](chatmessagementionedidentityset.md)|The entity (user, application, team, or channel) that was @mentioned.|
+|mentioned|[chatMessageMentionedIdentitySet](chatmessagementionedidentityset.md)|The entity (user, application, team, channel, or chat) that was @mentioned.|
 |mentionText|string|String used to represent the mention. For example, a user's display name, a team name.|
 
 

api-reference/v1.0/resources/chatmessagementionedidentityset.md

@@ -21,7 +21,7 @@ Inherits from [identitySet](../resources/identityset.md).
 |Property|Type|Description|
 |:---|:---|:---|
 |application|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents an application (for example, bot) @mentioned in a [message](../resources/chatmessage.md).|
-|conversation|[teamworkConversationIdentity](../resources/teamworkconversationidentity.md)|If present, represents a conversation (for example, team or channel) @mentioned in a [message](../resources/chatmessage.md).|
+|conversation|[teamworkConversationIdentity](../resources/teamworkconversationidentity.md)|If present, represents a conversation (for example, team, channel, or chat) @mentioned in a [message](../resources/chatmessage.md).|
 |device|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). Not used because it's not supported to @mention devices.|
 |user|[identity](../resources/identity.md)|Inherited from [identitySet](../resources/identityset.md). If present, represents a user @mentioned in a [message](../resources/chatmessage.md).|
 

changelog/Microsoft.Teams.Core.json

@@ -5699,6 +5699,24 @@
       "SubArea": "Messaging"
     },
     {
+      "ChangeList": [
+        {
+          "Id": "f9666fc8-6101-4ca6-bd26-3f11395ffc5f",
+          "ApiChange": "Property",
+          "ChangedApiName": "mentions",
+          "ChangeType": "Change",
+          "Description": "Added `chat` as a supported value for the **mentions** property in the [chatMessage](https://learn.microsoft.com/en-us/graph/api/resources/chatmessage?view=graph-rest-1.0) resource.",
+          "Target": "chatMessage"
+        }
+      ],
+      "Id": "f9666fc8-6101-4ca6-bd26-3f11395ffc5f",
+      "Cloud": "Prod",
+      "Version": "v1.0",
+      "CreatedDateTime": "2024-10-08T18:15:55.2254479Z",
+      "WorkloadArea": "Teamwork and communications",
+      "SubArea": ""
+       },
+      {
       "ChangeList": [ 
         {
           "Id": "5527a808-1e9a-4fa0-b52b-869cd2b870be",

concepts/whats-new-overview.md

@@ -17,11 +17,11 @@ For details about previous updates to Microsoft Graph, see [Microsoft Graph what
 > [!IMPORTANT]
 > Features in _preview_ status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.
 
-## January 2025: New and generally available
+## January 2025: New and generally available 
 
 ### Teamwork and communications | Messaging
 
-[Get](/graph/api/chatmessage-get#example-6-get-a-chat-message-with-a-forwarded-message) a chat message that has a forwarded message as an attachment.
+[Get](/graph/api/chatmessage-get#example-5-get-a-chat-message-with-an--for-everyone) a chat message with an @mention for everyone.
 
 ## January 2025: New in preview only