ChannelMessage.Send
Allows an app to send channel messages in Microsoft Teams, on behalf of the signed-in user.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Delegate Permission
|
|
Id |
ebf0f66e-9fb1-49e4-a278-222f76911cf4 |
Consent Type |
User |
Display String |
Send channel messages |
Description |
Allows an app to send channel messages in Microsoft Teams, on behalf of the signed-in user. |
Resources
Property |
Type |
Description |
createdDateTime |
dateTimeOffset |
Read only. Timestamp at which the channel was created. |
description |
String |
Optional textual description for the channel. |
displayName |
String |
Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters. |
email |
String |
The email address for sending messages to the channel. Read-only. |
id |
String |
The channel's unique identifier. Read-only. |
isFavoriteByDefault |
Boolean |
Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with Create team. Default: false . |
membershipType |
channelMembershipType |
The type of the channel. Can be set during creation and can't be changed. The possible values are: standard , private , unknownFutureValue , shared . The default value is standard . Note that you must use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: shared . |
tenantId |
string |
The ID of the Azure Active Directory tenant. |
webUrl |
String |
A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only. |
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. |
lastUpdatedDateTime |
dateTimeOffset |
Date and time at which the chat was renamed or list of members were 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 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. |
Property |
Type |
Description |
attachments |
chatMessageAttachment collection |
References to attached objects like files, tabs, meetings etc. |
body |
itemBody |
Plaintext/HTML representation of the content of the chat message. Representation is specified by the contentType inside the body. The content is always in HTML if the chat message contains a chatMessageMention. |
chatId |
string |
If the message was sent in a chat, represents the identity of the chat. |
channelIdentity |
channelIdentity |
If the message was sent in a channel, represents identity of the channel. |
createdDateTime |
dateTimeOffset |
Timestamp of when the chat message was created. |
deletedDateTime |
dateTimeOffset |
Read only. Timestamp at which the chat message was deleted, or null if not deleted. |
etag |
string |
Read-only. Version number of the chat message. |
eventDetail |
eventMessageDetail |
Read-only. If present, represents details of an event that happened in a chat, a channel, or a team, for example, adding new members. For event messages, the messageType property will be set to systemEventMessage . |
from |
chatMessageFromIdentitySet |
Details of the sender of the chat message. Can only be set during migration. |
id |
String |
Read-only. Unique ID of the message. IDs are unique within a chat/channel/reply-to-message, but might be duplicated in other chats/channels/reply-to-messages. |
importance |
string |
The importance of the chat message. The possible values are: normal , high , urgent . |
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 collection |
List of entities mentioned in the chat message. Supported entities are: user, bot, team, and channel. |
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: systemEventMessage . |
policyViolation |
chatMessagePolicyViolation |
Defines the properties of a policy violation set by a data loss prevention (DLP) application. |
reactions |
chatMessageReaction collection |
Reactions for this chat message (for example, Like). |
replyToId |
string |
Read-only. ID of the parent chat message or root chat message of the thread. (Only applies to chat messages in channels, not chats.) |
subject |
string |
The subject of the chat message, in plaintext. |
summary |
string |
Summary text of the chat message that could be used for push notifications and summary views or fall back views. Only applies to channel chat messages, not chat messages in a chat. |
webUrl |
string |
Read-only. Link to the message in Microsoft Teams. |