> ## 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.

# Configure WhatsApp

> Set up the WhatsApp channel in MoEngage by configuring your sender profile, adding approved templates, managing opt-ins, and delivery controls.

To use WhatsApp Messaging on MoEngage, you first need to configure the WhatsApp channel. To configure the WhatsApp channel in MoEngage, navigate to **Settings** > **Channels** > **WhatsApp**.

<Tip>
  Before you begin, ensure you have completed all the prerequisites listed [here](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/prerequisites).
</Tip>

# Steps to Configure WhatsApp

The following are the steps to configure the WhatsApp channel:

1. [Configure your sender profile](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/configure-whatsapp#configure-your-sender-profile)
2. [Add templates that are already approved by WhatsApp](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/configure-whatsapp#add-whatsapp-templates)
3. [Update WhatsApp opt-in on MoEngage](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/configure-whatsapp#update-whatsapp-opt-in-on-moengage)
4. [Configure delivery control settings](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/configure-whatsapp#configure-delivery-control-settings)
5. [Whitelist IPs](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/configure-whatsapp#whitelist-ips)

## Configure your Sender Profile

<img src="https://mintcdn.com/moengage/QRy8rcYszbTJNwGr/images/moengage_b385a7.png?fit=max&auto=format&n=QRy8rcYszbTJNwGr&q=85&s=5336d8146aa1547d053dddc83f785bd1" alt="Screenshot 2025-09-02 at 5.16.09 PM.png" width="2690" height="1476" data-path="images/moengage_b385a7.png" />

Configuring a WhatsApp Business Solution Provider (BSP) or WhatsApp Service Provider (WSP) is a mandatory prerequisite for running any WhatsApp campaigns. It’s important because it establishes the technical integration between your business and the WhatsApp platform, allowing MoEngage to initiate and transmit messages on your behalf.

WhatsApp BSP/WSP can be added and managed in the sender configuration tab of WhatsApp settings. You can access the Sender configuration tab using this path: **Settings** > **Channels** > **WhatsApp** > **Sender configuration**.

Perform the following steps to add a WhatsApp sender:

1. On the **Sender configuration** tab, click **+ Add connector**.
   <img src="https://mintcdn.com/moengage/7H2dU4CG2W0DQCPI/images/moengage_6ec05d.png?fit=max&auto=format&n=7H2dU4CG2W0DQCPI&q=85&s=9c79b46064a705531715a3d448b278ef" alt="add connector WA.png" width="2710" height="1166" data-path="images/moengage_6ec05d.png" />
2. On the **WhatsApp connector** dialog box, choose the connector from the dropdown. The **Choose a connector** dropdown lists all the connectors that MoEngage supports.
3. After adding the connector, select the connector. **Sender 1** is auto-populated; click **+ Sender** against it to add more senders for that connector.
   <img src="https://mintcdn.com/moengage/cVruC-B7I1TnIZ0h/images/moengage_da969a.png?fit=max&auto=format&n=cVruC-B7I1TnIZ0h&q=85&s=3924a07f46e5a031f13aa54d65184a91" alt="add sender wa.png" width="2350" height="1138" data-path="images/moengage_da969a.png" />
4. Add the sender details based on the selected connector. To complete the sender configuration, refer to the respective [WhatsApp provider](https://partners.moengage.com/hc/en-us/categories/13546547431572-WhatsApp-Providers) articles.
5. Click **Save**.

## Add WhatsApp Templates

WhatsApp templates facilitate streamlined communication by helping businesses curate predefined, personalized messages. You can send WhatsApp Messages using MoEngage and use the templates that are already approved or whitelisted (directly or by the WhatsApp Service Provider or BSP) by WhatsApp in the MoEngage Platform. All the approved templates are listed in the **Approved templates** tab of WhatsApp settings. For information on template approval and configuring the template details in MoEngage, refer to [WhatsApp Templates](/user-guide/campaigns-and-channels/whatsapp/getting-started-with-whatsapp/whatsapp-templates).

<img src="https://mintcdn.com/moengage/CaPmX0z_ys8cr0ms/images/moengage_09db99.png?fit=max&auto=format&n=CaPmX0z_ys8cr0ms&q=85&s=cfda3ef7fb7fe92e960c446f31e6970f" alt="Screenshot 2025-09-02 at 6.12.23 PM.png" width="2692" height="1052" data-path="images/moengage_09db99.png" />

## Update WhatsApp Opt-in on MoEngage

It is recommended to update the opt-in status in MoEngage. You can configure the fields that store WhatsApp numbers, WhatsApp Opt-in statuses, and WhatsApp Lead & Message of end users in the general settings tab. You can access the General settings tab using this path: **Settings** > **Channels** > **WhatsApp** > **General settings**.

<Frame>
  <img src="https://mintcdn.com/moengage/RgBTZI_0c8BIv-AG/images/download-(1).png?fit=max&auto=format&n=RgBTZI_0c8BIv-AG&q=85&s=d98df5cf73404bdf435d2b730dd9fc4a" alt="Download (1)" width="2262" height="1264" data-path="images/download-(1).png" />
</Frame>

* Use the following fields to select the attribute that stores WhatsApp mobile number and opt-in status:
  | Field                                                                     | Description                                                                                                                                              |
  | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | **Select the attribute in which user's WhatsApp mobile number is stored** | This field denotes the attribute that would be storing the WhatsApp mobile number in MoEngage. Select *Mobile Number* from the dropdown.                 |
  | **Select the attribute in which user's WhatsApp Opt-In is stored**        | This field denotes the attribute that would be storing the WhatsApp opt-in status in MoEngage. Select *WhatsApp Subscription Status* from the drop-down. |
* Configuring mobile number format guarantees that all mobile numbers are correctly passed to WhatsApp providers, which is essential for successful message delivery. To configure the mobile number format for the application, click the **Set the mobile number format** link.  You are taken to the **Mobile number management** page. For more information, refer to [Mobile Number Standardization](/user-guide/settings/advanced-settings/mobile-number-standardization).
* To configure the WhatsApp Lead & Message using the following toggles:
  <Info>
    You cannot turn on the following toggles if [PII tokenized sending](/user-guide/data/privacy/personal-data-or-personally-identifiable-information-pii/pii-tokenized-sending) is enabled for you.
  </Info>
  | Toggles                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | **Create a new profile if message is received from new number** | Formerly, MoEngage discarded WhatsApp messages received from users without an existing user profile. With this toggle turned on, MoEngage automatically generates user profiles for new users upon receipt of messages, thereby guaranteeing the preservation of these communications.                                                                                                                                                                                                                        |
  | **Store all incoming messages from all customers**              | Formerly, MoEngage retained incoming messages directly associated with campaigns, such as quick replies. With this toggle turned on, MoEngage stores all the incoming messages from all existing users.  **Note:**  If the **Create a new profile if message is received from new number** toggle is turned on along with this toggle, MoEngage stores all incoming messages and tracks them under an event named *WhatsApp Message Received*, encompassing those from both existing and newly created users. |
* Click **Save** to save the configurations.

## Configure Delivery Control Settings

Configure [Frequency Capping (FC)](/user-guide/settings/channels/delivery-controls/frequency-capping) and [Do Not Disturb (DND)](/user-guide/settings/channels/delivery-controls/do-not-disturb) to ensure that you are sending the optimum number of messages to your users and not during DND hours. This is an optional step.

## Whitelist IPs

MoEngage uses dynamic IPs to send messages. If your WhatsApp BSP/WSP requires a static IP address, refer to the provided [documentation](/user-guide/settings/account/security/ip-whitelisting-in-moengage) for more information. This is an optional step.

# Next Steps

[Create a WhatsApp Campaign](/user-guide/campaigns-and-channels/whatsapp/create/create-a-whatsapp-campaign)