---
schema_version: "1"
id: ba25ce49379388345487ed2a13c09c80137617c8aa99e12a5255614e103a2bc6
title: ChatterMessage
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_chattermessage.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_chattermessage.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: dde32c79842c93a4b96f3748ba3959f02ce9ef27e33db6aaae42d5e08cc83fc7
description: Represents a message sent as part of a private conversation in Chatter. This object is available in API version 23.0 and later.
---
# ChatterMessage

Represents a message sent as part of a private conversation in Chatter. This object is available in API version 23.0 and later.

## Supported Calls

delete(), describeSObjects(), query(), retrieve(), update()

## Fields

| Field Name | Details |
| --- | --- |
| Body | 
Type

textarea

Properties

Update

Description

Text of the message.



 |
| ConversationId | 

Type

reference

Properties

Filter, Group, Sort

Description

ID of the conversation that the message is associated with.



 |
| SenderId | 

Type

reference

Properties

Filter, Group, Nillable, Sort

Description

ID of the sender.



 |
| SenderNetworkId | 

Type

reference

Properties

Filter, Group, Nillable, Sort

Description

ID of the Experience Cloud site from which the message was sent. This field is available only if digital experiences is enabled in your org.

This field is available in API version 32.0 and later.





 |
| SentDate | 

Type

dateTime

Properties

Filter, Sort

Description

Date the message was sent.



 |

## Usage

Use this object to view and delete messages sent or received via private conversations in Chatter. Users can access this object if they have the Manage Chatter Messages and Direct Messages permission. Users with the Moderate Experiences Chatter Messages permission can access this object in Experience Cloud sites they’re a member of, only if the message has been flagged as inappropriate. This object is provided to allow administrators to view and delete users’ Chatter messages, for example, for compliance purposes.

Messages are hard deleted. That is, they’re removed completely without a trip to the Recycle Bin.

Deleting a message that resulted from sharing a file with someone doesn’t also delete the file.

#### See Also

- [ChatterConversation](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_chatterconversation.htm "Represents a private conversation in Chatter, consisting of messages that conversation members have sent or received. This object is available in API version 23.0 and later.")
- [ChatterConversationMember](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_chatterconversationmember.htm "Represents a member of a private conversation in Chatter. A member has either sent messages to or received messages from other conversation participants. This object is available in API version 23.0 and later.")