---
schema_version: "1"
id: c8f6cbd0ebd0e5dedbc7363786eb32915de45644bec833cca5471d813ac6e1c2
title: Key WhatsApp Data Model Objects for Unified Reporting
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mke_unified_reporting_key_dmo_fields_whatsapp.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mke_unified_reporting_key_dmo_fields_whatsapp.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 3414ecc47ddad047e3a9f21a88c61b63bc76f8c223f12676375d8a2f6a9a280a
description: In the unified reporting system for Marketing Cloud Engagement+, there are three data model objects (DMOs) that contain helpful data for creating reports related to WhatsApp messaging. These DMOs contain information about your send definitions, engagement data, and message content.
products:
  - Marketing
  - Marketing Cloud Engagement
release: "264"
---
# Key WhatsApp Data Model Objects for Unified Reporting

In the unified reporting system for Marketing Cloud Engagement+, there are three data model objects (DMOs) that contain helpful data for creating reports related to WhatsApp messaging. These DMOs contain information about your send definitions, engagement data, and message content.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Marketing Cloud Engagement <strong>Pro+</strong>, <strong>Corporate+</strong>, and <strong>Enterprise+</strong> Editions</td></tr></tbody></table>

These DMOs contain information that’s useful for creating reports that focus on WhatsApp sends:

- **Bulk Message**: Contains metadata about your messages, such as the campaign ID and send method. The data applies to WhatsApp messages that you send from Journey Builder in Marketing Cloud Engagement. It also contains information about API-triggered WhatsApp messages.
- **Digital Content**: Contains metadata about the WhatsApp send.
- **Message Engagement**: Contains send and engagement data related to WhatsApp messages.

## Bulk Message

The Bulk Message DMO contains metadata related to a WhatsApp send, based on the send definition in Marketing Cloud Engagement.

This table lists the fields in the Bulk Message DMO that you’re likely to use when creating WhatsApp-related reports in the unified reporting system.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d58092e108">Field Label</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d58092e111">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Campaign ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">The ID of the campaign in <span>Marketing Cloud Next</span> that sent the bulk send. This
              ID isn’t the same as a campaign ID from <span>Marketing Cloud Engagement</span>.</td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Data Source ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">The ID of the <span>Marketing Cloud Engagement</span> enterprise ID (EID) that the data came
              from.</td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Data Source Object ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">The ID of the <span>Marketing Cloud Engagement</span> data stream that the data came
              from.</td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Engagement Channel ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">The messaging channel for the message. For WhatsApp messages, the value of this field
              is <code>WHATSAPP</code>.</td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">
              <p>The job ID for the WhatsApp send.</p>
              <p style="margin-bottom:0;">For journey sends, this value contains the ID of the journey activity that sent the
                message.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Message Purpose</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">
              <p>The category of the message send, which impacts the price you pay for each message.
                Possible values:</p>
              <ul>
                <li><code>Promotional</code>—Messages sent for a marketing-related purpose.</li>

                <li><code>Transactional</code>—Messages sent in response to a customer action, such as
                  a confirmation or authentication message.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Name</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">
              <p>The name of the send definition used to send the WhatsApp message. </p>
              <p style="margin-bottom:0;">For journey sends, this value contains the name of the journey activity that sent the
                message.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field Label" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e108 "><strong>Send Method Type</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e111 ">
              <p>The mechanism used to send the WhatsApp message. Possible values are:</p>
              <ul>
                <li><code>Journey</code></li>

                <li><code>API Triggered</code></li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

## Digital Content

The Digital Content DMO contains information about the content that’s associated with your message sends.

This table lists the fields in the Digital Content DMO that you’re likely to use when you use the unified reporting system to create reports related to WhatsApp messaging.

 
| Field Label | Description |
| --- | --- |
| **Data Source** | A reference ID for the source of records identified by an external record ID. |
| **Data Source Object** | The ID of the data source that the object came from. |
| **Id** | The message ID in Marketing Cloud Engagement. This ID is different from the asset ID. |
| **Name** | The name of the asset in Content Builder. |

## Message Engagement

The Message Engagement Data Model Object (DMO) contains information about the sending, delivery, and engagement of WhatsApp messages sent from your account.

This table lists the fields in the Message Engagement DMO that you’re likely to use when you use the unified reporting system to create reports related to WhatsApp messaging. For a complete list of fields, API names, and data types for this DMO, see _Data 360 DMO and Mapping Guide_: [Message Engagement DMO](https://developer.salesforce.com/docs/data/data-cloud-dmo-mapping/guide/c360dm-message-engagement-dmo.html).

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d58092e370">Field</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d58092e373">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Bulk Message ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">A job ID for the WhatsApp send. Use this field to join to BulkMessageDMO.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Contact Point ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">A reference ID that’s associated with the recipient’s phone number.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Country ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">An ID associated with the recipient’s country.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Data Source ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The ID of the data source that’s associated with the WhatsApp send.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Data Source Object ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The ID of the data source object that produced the WhatsApp send.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Device Type</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">Indicates whether the recipient viewed the message on a mobile device or on a
              computer.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Action Reason Text</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>A description of the reason that a WhatsApp error occurred. </p>
              <p style="margin-bottom:0;">Available for
                <code>NOT_SENT</code>, <code>FAILED</code>, and <code>WARNING</code> events
                only.
              </p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Channel Action</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>The type of engagement event that occurred. Possible values are:</p>
              <ul>
                <li><code>DR</code>—The status of an inbound message is available. Retrieve it in your WhatsApp
                  Business account.</li>

                <li><code>INBOUND</code>—A customer sent a message to you.</li>

                <li><code>SEND_STATUS</code>—The message was sent and the resulting status is
                  available.</li>

              </ul>
              <p>If your account used <span>Data 360</span> with the <span>Marketing Cloud Engagement</span> channel bundles before the Winter ’26 release, the possible values for this field
                are:</p>
              <ul>
                <li><code>Inbound</code>—A customer sent a message to you.</li>

                <li><code>Sent</code>—The message has been sent but hasn’t been delivered to the
                  recipient’s device.</li>

                <li><code>Undelivered</code>—The message couldn’t be delivered to the recipient’s
                  device.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Channel Type ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p style="margin-bottom:0;">A reference ID to the type of engagement channel. For the WhatsApp channel, the value of
                this field is <code>WHATSAPP</code>.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Date Time</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The date and time when the engagement event occurred.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Event Direction ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>Indicates where the event originated. Possible values:</p>
              <ul>
                <li><code>Inbound</code>—The message was sent from a customer to your brand.</li>

                <li><code>Outbound</code>—The message was sent from your brand to a customer.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Engagement Notes</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">Indicates the Salesforce product that the message was sent from. Possible value:
              <code>MARKETING_CLOUD_ENGAGEMENT</code>.
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>ErrorMessageText</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>A description of the reason that a WhatsApp error occurred. </p>
              <p>Available for
                <code>NOT_SENT</code>, <code>FAILED</code>, and <code>WARNING</code> events
                only.
              </p>
              <p style="margin-bottom:0;">This field contains the same information as the Engagement Action Reason Text
                field.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The unique ID of the engagement event.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Individual ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The ID of the unified individual that the message was sent to.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Internal Organization ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The ID of the business unit or other internal organization that owns the business
              account. This ID can also refer to a <span>Marketing Cloud Engagement</span> member ID (MID).</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Marketing Journey Activity ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The ID of the journey activity that sent the message. Use this value to join to
              Journey Builder DMOs.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Marketing Batch Number</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The batch ID for the WhatsApp send.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Message Recipient Send Status</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>The status of an attempt to deliver a message. Possible values:</p>
              <ul>
                <li><code>NOT_SENT</code>—The message wasn’t sent to the WhatsApp platform.</li>

                <li><code>SENT</code>—The WhatsApp platform accepted the message.</li>

                <li><code>DELIVERED</code>—The message was successfully delivered to the
                  recipient.</li>

                <li><code>READ</code>—The recipient viewed the message.</li>

                <li><code>FAILED</code>—The WhatsApp platform was unable to deliver the message to the
                  handset.</li>

                <li><code>WARNING</code>—The WhatsApp platform flagged the message content.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Message Text</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The text in the message body.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Messaging Error Code</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>A status code that indicates the reason a message wasn’t delivered. This field is
                only provided for messages where the value of the <strong>Engagement Channel Action ID</strong> field
                is <code>NOT_SENT</code>, <code>FAILED</code>, or <code>UNDELIVERED</code>.</p>
              <p style="margin-bottom:0;">The error code begins with <code>MC</code> if the error code originated from
                Salesforce, or <code>WA</code> if the error code originated from the WhatsApp
                platform.</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Recipient Message ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">A unique ID for each instance of an outbound or inbound message.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Send Classification ID</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">
              <p>The send classification for the message send, which impacts the price you pay for each
                message. Possible values:</p>
              <ul>
                <li><code>Promotional</code>—Messages sent for a marketing-related purpose.</li>

                <li><code>Transactional</code>—Messages sent in response to a customer action, such as
                  a confirmation or authentication message.</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Sender Code</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The WhatsApp channel ID that was used to send the message.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Sender Display Name</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The sender name that was used to send the message.</td>

          </tr>
          <tr class="">
            <td data-label="Field" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e370 "><strong>Send Time Phone Number</strong></td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d58092e373 ">The recipient’s phone number.</td>

          </tr>
        </tbody>
      </table>