CData Python Connector for Salesforce Marketing Cloud

Build 25.0.9454

GetMessageContactHistory

Retrieves the history of the last message that was sent to a specific mobile number in Salesforce Marketing Cloud. This procedure provides delivery timestamps, message content identifiers (Ids), and channel information for audit and tracking purposes.

Input

Name Type Required Description
MessageId String True Specifies the unique identifier (Id) of the message that is associated with the MessageContact record. This identifier links the request to a specific outbound MobileConnect message whose contact-level history is being retrieved.
TokenId String True Specifies the unique Id that is returned for the MessageContact operation. This value enables retrieval of message-tracking details that correspond to a specific send request.
MobileNumber String True Specifies the mobile number that is associated with the contact whose message history is being requested. This value ensures that the stored procedure returns tracking data for the correct recipient.

Result Set Columns

Name Type Description
Count Integer Returns the total number of recipients that are included in the send request after subtracting any mobile numbers that were unsubscribed at the time of sending. This count reflects the number of intended recipients who were eligible to receive the message.
CreateDate Datetime Returns the date and time when the MessageContact send request was submitted. This timestamp provides a reference point for reviewing delivery history and tracking message-processing timelines.
Status String Returns the delivery status of the message for the specified contact. This status indicates whether the message was delivered, bounced, queued, or failed during carrier processing.
History String Returns the detailed history that is associated with the most recent message sent to the specified mobile number. This history can include status changes, carrier responses, timestamps, and other diagnostic information that describe the contact's message-delivery lifecycle.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9454