> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# D7Messaging

# Introduction

D7Messaging is a mobile engagement and communications provider enabling enterprises to intelligently personalize their two-way marketing and customer care interactions across multiple channels. This article provides guidance on configuring the D7Messaging connector on the MoEngage dashboard.

<Info>
  **Prerequisites**

  Ensure you have access to your [D7Messaging](https://app.d7networks.com/api-tokens) dashboard and have the [API key](https://app.d7networks.com/api-tokens) for your D7Messaging account.
</Info>

# Configure D7Messaging as a Custom SMS Connector (Service Provider)

<Info>
  This article describes the steps to configure D7Messaging as a Custom Connector (Service Provider) on the MoEngage dashboard.
</Info>

1. Navigate to **Settings** > **Channel** > **SMS** > **Sender configuration**.
2. Click **+ Add Sender** at the upper right corner. In the Add Sender screen, you can\
   add a new custom service provider or a sender to a configured service provider.
3. Click **+ Add custom service provider**.
4. Add details and settings to the Sender Details screen.

| Field                     | Description                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Mark as default**       | Turn this toggle on to mark the sender as the default sender for D7Messaging. If marked as default, this sender would be used to send all SMS campaigns from MoEngage unless you select a different sender while creating the campaign. This is not required.                                                                                                                                                |
| **Service provider name** | This field identifies the service provider you are configuring on the MoEngage dashboard and must be unique. Type the service provider's name here. Enter D7Messaging.                                                                                                                                                                                                                                       |
| **Sender name**           | This field identifies the readable sender name that can be used while creating a campaign or alert.                                                                                                                                                                                                                                                                                                          |
| **Sender type**           | The sender type can either be **Promotional** or **Transactional**. <ul><li>Select Promotional when you plan to use the sender to send information about your brand, promote deals, or engage with users.</li><li>Select the sender type as Transactional for sending alerts about transactions, OTPs, security information, or any information that can be classified as transactional in nature.</li></ul> |

<img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_31131217560084.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=180268589037f9f98fccb83a91a23e07" alt="Image 10-10-24 at 3.17 PM.jpeg" width="940" height="614" data-path="images/partner_31131217560084.png" />

5. Configure the webhook by adding the following details.

| Field       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **API URL** | This field contains information about the URL that should be used to send an API request to the sender. You can get this information from the sender's API documentation. Type the sender's API endpoint here. The API URL for D7Messaging is: <br />[https://api.d7networks.com/messages/v1/send](https://api.d7networks.com/messages/v1/send)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Method**  | Select **POST** as the HTTP method.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Headers** | Add the Request Headers to be passed to the API as Key-Value pairs using this option. <ul><li>Authorization: Bearer the\_token\_from: [https://app.d7networks.com/api-tokens](https://app.d7networks.com/api-tokens)</li><li>**Content-Type**: application/JSON <img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_31131241335444.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=5ddd2e08473eed473bfaef3e4bc89b8a" alt="Image 10-10-24 at 3.17 PM (1).jpeg" width="970" height="902" data-path="images/partner_31131241335444.png" /></li></ul> |

6. Under **Body Type**, select **Raw** and add the following details:
   ```json theme={null}
   {
   "messages": [
   {
   "originator": "SignOTP",
   "recipients": ["Moesms_destination"],
   "content": "Moesms_message",
   "client_ref": "MoEngage"
   }
   ]
   }
   ```
   <img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_31157502381972.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=709a34026e596559678b467793b83ed0" alt="Raw.png" width="698" height="356" data-path="images/partner_31157502381972.png" />
7. Click **Send test SMS** to verify your configuration. The Send Test SMS dialog box is displayed.
   1. Under Mobile Number, enter a mobile number.
   2. In the Message box, enter a message.
   3. Click **Send** to test the configuration.
   4. Click **OK** to close the dialog box.
   5. Click **Save** to save the sender configuration.

## Delivery Tracking

You can configure delivery tracking after creating the sender in the MoEngage Dashboard.

1. Open the D7Messaging you configured and go to step 3, "Delivery tracking (optional)."
2. Copy the Delivery Tracking URL. <img src="https://mintcdn.com/moengage/cJSG0nHne5L3-Q_X/images/partner_31131222382484.png?fit=max&auto=format&n=cJSG0nHne5L3-Q_X&q=85&s=61843e3c303f1898977681a98728a53d" alt="Image 10-10-24 at 3.17 PM (3).jpeg" width="982" height="470" data-path="images/partner_31131222382484.png" /> In the **Delivery tracking URL** field, enter the following URL:\
   \[[https://api-0X.moengage.com/sms/dlr/custom/2759791019\\\](](https://api-0X.moengage.com/sms/dlr/custom/2759791019]\()[https://api-0X.moengage.com/sms/dlr/custom/2759791019](https://api-0X.moengage.com/sms/dlr/custom/2759791019\)) \
   where X is the number of the data center (DC).
   * You can configure this on the D7 User Dashboard as a Report URL or add it in the message body by clicking Previous and updating it.
   * The final message raw body will look like the following:

<CodeGroup>
  ```json JSON wrap theme={null}
  {
      "messages": [
      {
          "originator": "SignOTP",
          "recipients": ["Moesms_destination"],
          "content": "Moesms_message",
          "report_url": "https://api-01.moengage.com/sms/dlr/custom/2759791019", "client_ref": "MoEngage"
      }
  ]
  }
  ```
</CodeGroup>

* After the URL is added, under **Map attributes of the delivery response** , you must map attributes to receive the delivery report. For more information, refer to [Delivery Tracking for Custom Connectors](/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-custom-connector-for-sms).
* Select **Map fields from the delivery response** or **Map fields manually**. If you select the latter, configure the following values:
  * **Attribute storing unique ID of the sent response** : Enter the *request\_id*.
  * **Attribute storing Unique delivery ID field of delivery response** : Enter the *request\_id*.
  * **Attribute storing delivery status** : Enter the *status*.
  * **Success values for delivery status** : Enter *delivered*.
  * **Attribute storing failure reason** : Enter the *status*.

3. Check the parameters on the Delivery Tracking URL and click **Save**.

# Next Steps

* Create an SMS campaign using the [Getting Started for creating SMS campaign](/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/create-an-sms-campaign).
* Set the [Frequency Capping for SMS](/user-guide/settings/channels/delivery-controls/frequency-capping).
* Set the [Current Service Provider](/user-guide/campaigns-and-channels/sms-mms-and-rcs/sms/getting-started-with-sms/configure-an-sms-sender).
* [Read more about campaign analytics.](/user-guide/campaigns-and-channels/connectors/analyze/connector-campaign-analytics)
