ChatMessage.Read.All
Allows the app to read all one-to-one and group chats messages in Microsoft Teams, without a signed-in user.
Merill's Note
For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the
ChatMessage.Read.Allpermission.If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the
Export-MsIdAppConsentGrantReportcommand. See How To: Run a quick OAuth app audit of your tenant
| Category | Application | Delegated |
|---|---|---|
| Identifier | b9bb2381-47a4-46cd-aafb-00cb12f68504 | - |
| DisplayText | Read all chat messages | - |
| Description | Allows the app to read all one-to-one and group chats messages in Microsoft Teams, without a signed-in user. | - |
| AdminConsentRequired | - | - |
Graph Methods
→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)
| Methods | |
|---|---|
Resources
Granting this permission allows the calling application to access (and/or update) the following information in your tenant.
Graph reference: chat
| Property | Type | Description |
|---|---|---|
| chatType | chatType | Specifies the type of chat. Possible values are: group, oneOnOne, meeting, unknownFutureValue. |
| createdDateTime | dateTimeOffset | Date and time at which the chat was created. Read-only. |
| id | String | The chat's unique identifier. Read-only. |
| isHiddenForAllMembers | Boolean | Indicates whether the chat is hidden for all its members. Read-only. |
| lastUpdatedDateTime | dateTimeOffset | Date and time at which the chat was renamed or the list of members was last changed. Read-only. |
| onlineMeetingInfo | teamworkOnlineMeetingInfo | Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only. |
| tenantId | String | The identifier of the tenant in which the chat was created. Read-only. |
| topic | String | (Optional) Subject or topic for the chat. Only available for group chats. |
| viewpoint | chatViewpoint | Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context. |
| webUrl | String | The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only. |