MessagingEndUser
Represents a single address—such as a phone number or Facebook page—communicating with a single Messaging channel.
This object is available for Einstein Conversation Insights customers whose data is stored natively on the Salesforce Platform. If you turned on Einstein Conversation Insights for the first time starting in Spring ’26, this object is available to query and access using Salesforce tools. For existing ECI customers, data migration and access to related Salesforce Platform objects is scheduled to begin in Summer ’26.
Introduced in API version 40.0.
create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()
-
Type: reference
-
Properties: Create, Filter, Group, Nillable, Sort, Update
-
Introduced: API version 43.0
-
Description:
ID of the Account associated with this Messaging end user.
This field is a relationship field.
-
Relationship name: Account
-
Relationship type: relationship
-
Refers to: Account
-
Type: reference
-
Properties: Filter, Group, Nillable, Sort
-
Introduced: API version 61.0
-
Description:
ID of the authenticated user associated with this messaging end user.
This field is a relationship field.
-
Relationship name: AuthenticatedEndUser
-
Relationship type: relationship
-
Refers to: User
-
Type: reference
-
Properties: Create, Filter, Group, Nillable, Sort, Update
-
Introduced: API version 43.0
-
Description:
ID of the associated Contact.
This field is a relationship field.
-
Relationship name: Contact
-
Relationship type: relationship
-
Refers to: Contact
-
Type: reference
-
Properties: Create, Filter, Group, Nillable, Sort, Update
-
Introduced: API version 49.0
-
Relationship name: Employee
-
Relationship type: relationship
-
Refers to: Employee
- Type: boolean
- Properties: Create, Defaulted on create, Filter, Group, Sort, Update
- Description: Indicates whether an initial response has been sent to the Messaging end user (
true) or not (false). - Default value: false
- Type: boolean
- Properties: Defaulted on create, Filter, Sort
- Introduced: API version 48.0
- Description: Indicates whether the Messaging end user has opted in to receiving messages (
true) or not (false). This field compares the related messaging channel’s consent requirement to the user’s consent status; if the user’s status meets the channel’s required consent level,IsFullyOptedInis set totrue. - Default value: false
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort
- Introduced: API version 48.0
- Description: The ISO country code associated with the Messaging end user.
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Introduced: API version 63.0
- Description: The preferred language of the messaging user who participated in the messaging session. Supported for Enhanced Chat and Apple Messages for Business only.
-
Type: reference
-
Properties: Create, Filter, Group, Nillable, Sort, Update
-
Introduced: API version 57.0
-
Description:
ID of the associated lead.
This field is a relationship field.
-
Relationship name: Lead
-
Relationship type: relationship
-
Refers to: Lead
- Type: string
- Properties: Create, Filter, Group, Nillable, Sort, Update
- Description: Reserved for future use.
- Type: picklist
- Properties: Create, Filter, Group, Restricted picklist, Sort
- Description: Type of message.
- Possible values:
- AppleBusinessChat — AppleBusinessChat — Represents Apple Messages for Business.
- Custom — Custom — Represents Bring Your Own Channel. Available in API version 58.0 and later.
- EmbeddedMessaging — EmbeddedMessaging — Represents Enhanced Chat. Available in API version 50.0 and later.
- Email — Email — Available in API version 66.0 and later.
- Facebook — Facebook
- MsCopilot — MsCopilot — Available in API version 67.0 and later.
- Phone — Phone
- Rcs — Rcs — Available in API version 67.0 and later.
- Text — Text
- Voice — Voice
- WhatsApp — WhatsApp
-
Type: reference
-
Properties: Create, Filter, Group, Sort
-
Description:
The ID of the Messaging channel associated with the Messaging end user.
This is a relationship field.
-
Relationship name: MessagingChannel
-
Relationship type: relationship
-
Refers to: MessagingChannel
- Type: picklist
- Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- Introduced: API version 48.0
- Description: The consent status of the messaging user.
- Possible values:
- DoublyOptedIn — DoublyOptedIn
- ExplicitlyOptedIn — ExplicitlyOptedIn
- ImplicitlyOptedIn — ImplicitlyOptedIn
- OptedOut — OptedOut
- Type: string
- Properties: Filter, Group, idLookup, Nillable, Sort
- Introduced: API version 67.0
- Description: The business-scoped user identifier provided by external messaging platforms such as Meta. This opaque, stable identifier uniquely represents the end user within the context of your business relationship on that platform.
- Type: string
- Properties: Create, Filter, Group, Sort
- Description: The phone number, Facebook page ID, or unique key associated with this Messaging end user.
- Type: string
- Properties: Create, Filter, Group, idLookup, Sort, Update
- Description: The name of the Messaging end user. Because this field is editable, we don’t recommend referencing it in automation. Instead, use the Messaging Platform Key.
- Type: url
- Properties: Create, Filter, Group, Nillable, Sort
- Description: The URL of the Messaging end user’s profile picture.
This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version.
-
MessagingEndUserChangeEvent: Introduced in API version 62.0.