# WhatsApp Web

Connect your existing WhatsApp account (personal or business) to DM Champ by scanning a QR code - no Meta Business verification required. This works just like linking WhatsApp Web in a browser, but instead of a browser, your WhatsApp conversations flow directly into DM Champ.

***

## What Is WhatsApp Web Integration?

WhatsApp Web integration lets you connect your existing WhatsApp number to DM Champ without going through the official WhatsApp Business API setup process. Instead of purchasing a new phone number and completing Meta Business verification, you simply scan a QR code with your phone.

This is ideal for businesses that want to get started quickly with their existing WhatsApp presence. You can also set up WhatsApp Web during the guided onboarding wizard by scanning a QR code as part of the channel connection step.

***

## WhatsApp Web vs. Business API

Choose the right integration method based on your needs:

| Feature                        | WhatsApp Web                                    | WhatsApp Business API                             |
| ------------------------------ | ----------------------------------------------- | ------------------------------------------------- |
| **Setup time**                 | Minutes (scan QR code)                          | Hours to days (Meta verification)                 |
| **Meta Business verification** | Not required                                    | Required                                          |
| **Use existing number**        | Yes                                             | Number must not be registered on WhatsApp         |
| **Template messages**          | Not supported                                   | Supported                                         |
| **Messaging limits**           | Standard WhatsApp limits                        | Tiered system (250 to unlimited, portfolio-level) |
| **Message delivery tracking**  | Basic                                           | Full delivery/read receipts                       |
| **24-hour window**             | No restriction                                  | Enforced by Meta                                  |
| **Typing indicators**          | Supported                                       | Not available                                     |
| **Batch sending**              | Supported                                       | Supported                                         |
| **Reliability**                | Depends on phone connection                     | Fully cloud-based, no phone needed                |
| **Official support from Meta** | Unofficial integration                          | Officially supported                              |
| **Best for**                   | Small businesses, quick start, personal numbers | High-volume, enterprise, regulated industries     |

> **Important:** WhatsApp Web integration is unofficial and relies on your phone staying connected to the internet. If your phone loses connection, DM Champ cannot send or receive messages. For high-volume, mission-critical business messaging, the [WhatsApp Business API](https://help.dmchamp.com/messaging-channels/whatsapp-business) is the more reliable choice.

***

## Setting Up WhatsApp Web

### Step 1: Start the Connection

1. Navigate to **Phone Numbers** in the left sidebar.
2. Click **Connect WhatsApp Web**.
3. Enter the phone number associated with your WhatsApp account (in international format, e.g., +1234567890).

### Step 2: Scan the QR Code

1. A QR code will appear on screen.
2. Open WhatsApp on your phone.
3. Go to **Settings** (or the three-dot menu) and select **Linked Devices**.
4. Tap **Link a Device**.
5. Point your phone's camera at the QR code displayed in DM Champ.
6. Wait for the connection to be established.

Once connected, your WhatsApp conversations will be accessible through DM Champ, and the AI bot (if enabled) can respond to incoming messages.

> **Note:** The QR code expires after a short period. If it expires before you scan it, click the refresh button to generate a new one.

***

## Session Management

### Checking Connection Status

Your WhatsApp Web connection status is displayed next to the phone number in the **Phone Numbers** section. Possible statuses include:

| Status           | Meaning                               |
| ---------------- | ------------------------------------- |
| **Connected**    | Active and receiving/sending messages |
| **Initializing** | Connection is being set up            |
| **QR Pending**   | Waiting for you to scan the QR code   |
| **Disconnected** | Session is no longer active           |

### Reconnecting

If your session disconnects (due to network issues, phone restart, etc.), you can reconnect without scanning a new QR code:

1. Go to **Phone Numbers**.
2. Find your WhatsApp Web number.
3. Click the **Reconnect** button.
4. The system will attempt to restore the previous session automatically.

If automatic reconnection fails (for example, if you logged out from your phone), you will need to scan a new QR code.

### Disconnecting

To intentionally disconnect your WhatsApp Web session:

1. Go to **Phone Numbers**.
2. Find your WhatsApp Web number.
3. Click **Disconnect**.

This terminates the connection and cleans up the session. You can reconnect later by scanning a new QR code.

> **Tip:** You can also disconnect from your phone by going to **Linked Devices** in WhatsApp and removing the DM Champ session.

***

## AI Activity Tracking

When using the AI bot with a WhatsApp Web connection, DM Champ monitors how many automated messages are being sent. This helps you stay within safe limits and avoid WhatsApp flagging your account for excessive automation.

### Warning Levels

DM Champ tracks your AI activity and shows warnings when you approach your daily limit:

| Warning Level            | Meaning                                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| **80% (Caution)**        | "Approaching daily limit" warning appears. Consider reducing automated message frequency to avoid hitting the cap. |
| **100% (Limit reached)** | "Daily limit reached" error appears. AI messaging is paused for the rest of the day to protect your account.       |

Take these warnings seriously - sending too many automated messages through WhatsApp Web can lead to WhatsApp temporarily or permanently restricting your account.

### Staying Safe

* **Monitor your warnings** regularly in the Phone Numbers section.
* **Reduce AI response frequency** if you see the 80% caution warning.
* **Introduce delays** between automated responses to mimic natural conversation patterns.
* **Mix manual and automated** messaging when possible.

***

## Typing Indicators

WhatsApp Web integration supports typing indicators - the "typing..." bubble that your contacts see when someone is writing a message. When the AI bot is preparing a response, DM Champ shows this typing indicator to the contact, making the conversation feel more natural and human-like.

This feature is enabled automatically and requires no configuration.

***

## Batch Sending

You can send messages to multiple contacts at once through WhatsApp Web. This is useful for campaigns and broadcast messages.

> **Important:** Batch sending through WhatsApp Web is subject to standard WhatsApp rate limits. Sending too many messages too quickly can trigger anti-spam protections. DM Champ automatically paces batch messages to reduce this risk, but you should still be mindful of volume.

***

## Usage Tracking

WhatsApp Web now includes usage tracking to help you monitor your messaging activity. You can view metrics on messages sent and received through your WhatsApp Web connection, giving you better visibility into how the channel is being used across your campaigns.

***

## Session Health Monitoring

DM Champ continuously monitors the health of your WhatsApp Web connection:

* **Automatic reconnection** attempts are made if the connection drops unexpectedly.
* **Status updates** are reflected in real time in the Phone Numbers section.
* **Activity timestamps** track when the last successful message was sent or received.

If the system detects that your session has been inactive or disconnected for an extended period, it will notify you so you can take action.

***

## Limitations

Be aware of the following limitations compared to the WhatsApp Business API:

* **No template messages:** You cannot send pre-approved template messages. All messages are free-form.
* **Phone dependency:** Your phone must remain connected to the internet for the session to stay active. If your phone loses connectivity for an extended period, the session may disconnect.
* **Unofficial integration:** This integration is not officially supported by Meta. WhatsApp may change their platform in ways that affect this feature.
* **Limited delivery tracking:** While you can still see blue ticks (read receipts) in WhatsApp itself, delivery status tracking within DM Champ is more limited than with the Business API.
* **Account risk:** Excessive automation or spam-like behavior can result in your WhatsApp account being temporarily or permanently banned. Follow the AI activity warnings and best practices.
* **Single device:** Connecting to DM Champ counts as one of your linked devices. WhatsApp allows up to 4 linked devices.

***

## Troubleshooting

### QR Code Not Appearing

* Refresh the page and try again.
* Ensure you have a stable internet connection.
* If the issue persists, try disconnecting any existing session first and starting fresh.

### Connection Keeps Dropping

* Check that your phone has a reliable internet connection (Wi-Fi recommended).
* Make sure your phone's battery optimization settings are not closing WhatsApp in the background.
* Reconnect the session from the Phone Numbers section.

### Messages Not Being Sent

* Verify the connection status shows as **Connected**.
* Check that you have sufficient credits in your DM Champ account.
* Ensure the recipient's number is correct and has WhatsApp installed.
* If you recently received an AI activity warning, reduce your automated messaging volume.

### "Session Already Connected" Error

* You may already have an active session for this number. Go to Phone Numbers and check the status.
* If the status shows as connected but messages are not working, try disconnecting and reconnecting.

### Phone Shows "Logged Out" for DM Champ

* Your session has been terminated from the phone side. You will need to scan a new QR code.
* Go to Phone Numbers, disconnect the existing session, and set up a new connection.

***

## Best Practices

* **Keep your phone charged and connected** to the internet at all times for uninterrupted service.
* **Use Wi-Fi** on your phone for the most stable connection.
* **Heed AI activity warnings** to protect your WhatsApp account from restrictions.
* **Start with low automation volume** and gradually increase as you establish a messaging pattern.
* **Consider upgrading to the** [**WhatsApp Business API**](https://help.dmchamp.com/messaging-channels/whatsapp-business) if you need higher volume, template messages, or guaranteed reliability.
