How to Connect WhatsApp to Wawp

Q: Instances Limit & Scaling Quotas

Every Wawp workspace operates under an allocated Instances Limit, which controls how many active WhatsApp channels you can link simultaneously. Free Plan Quota: The default Free tier enables linking exactly 1 WhatsApp number to test and deploy standard API automations. Reaching the Limit: Once your allocated ins

Learn how to connect your WhatsApp number to Wawp using QR code or Login code, and manage your connection via the instance dashboard.

7 min read·Updated May 12, 2026

Getting Started: The Connection Process

To begin, log into your Wawp Workspace Dashboard. By default, this opens the "Linked Numbers" management tab, which serves as your central operation hub for provisioning and monitoring all connected WhatsApp channels.

Before you connect, ensure your number meets these criteria:

It has not been linked to a similar service within the last month.
It has been in active contact with other numbers.
It has not been banned by WhatsApp.

Wawp instance area — **Linked Numbers Dashboard**
The central management area in the Wawp portal for viewing and adding WhatsApp instances.
Keywords: wawp dashboard, linked numbers, instance management

Step 1: Create an Instance

An "instance" is the dedicated container that links your number to the Wawp platform.

Access Linked Numbers From the "Linked Numbers" page, click the "New Instance" button.

Preparation Wawp will automatically provision and prepare the container for your number.

Ready to Link The status will change to "Scan QR Code" once it is ready for you to link your number.

⛓️‍💥 To create an instance via API directly for your system integration, follow this document: Create new Session

After creating the instance, it should look like this screen:

Create Wawp instance — **Instance Creation Ready**
A new instance prepared and awaiting connection via QR code or pairing code.
Keywords: create instance, prepare session, whatsapp link ready

Step 2: Choose Your Connection Method

WhatsApp allows you to connect in multiple ways, and Wawp supports both primary connection channels seamlessly.

Whatsapp linked devices — **WhatsApp Linked Devices Menu**
The standard WhatsApp mobile app menu used to link new devices by scanning a QR code.
Keywords: whatsapp settings, linked devices, link new device

All connected WhatsApp profile information appears directly on your card as shown below:

Connect Wawp instance — **Active Connection Card**
A successfully connected WhatsApp instance displaying profile information and a green 'Working' status.
Keywords: active connection, whatsapp linked, session status

Method 1: Connect by Scanning a QR Code

This is the most common and familiar method. It works exactly like logging into standard WhatsApp Web or Desktop.

From your Wawp instance row actions, click on "Scan QR":

scan qr code on wawp — **Scan QR Code Option**
The action button to display a secure QR code for linking your WhatsApp account.
Keywords: scan qr, whatsapp web link, authorize session

Get QR Code Click "Scan QR" within your instance actions. A secure modal will appear containing your unique QR code.

Open WhatsApp On your phone, open the WhatsApp app.

Linked Devices Go to Settings (for iPhone) or the three-dot menu (for Android) and select "Linked devices".

Scan Tap "Link a device" and use your phone's camera to scan the QR code displayed on your Wawp dashboard.

Note: Linking must be done via the official WhatsApp Business App OR WhatsApp Personal App. See the reference walkthrough video below.

— Wawp Support

Method 2: Connect by Pairing Code

This method is fast and does not require a working camera, making it ideal if you are linking directly from the same mobile device.

Trigger Pairing On your Wawp dashboard, click the "Pair Code" button inside the instance row actions. [wawp_img src="/assets/articles/connect-whatsapp-wawp/link-with-code.webp" alt="connect whatsapp number by code" name="Link with Pairing Code" desc="Selecting the alternative pairing code method for connecting without a camera scan." keywords="pair code, link without qr, manual authentication"]

Generate Code Select your country, enter your target WhatsApp phone number inside the secure modal, and click "Generate Pairing Code". [wawp_img src="/assets/articles/connect-whatsapp-wawp/enter-code.webp" alt="wawp connect by code" name="Enter Pairing Code" desc="The modal interface for entering your phone number and generating an 8-character pairing code." keywords="pairing code generator, mobile auth, manual link"]

Check Phone On your phone, check your active WhatsApp notifications for a push prompt asking if you are attempting to link a new device.

Confirm Tap "Confirm" on your phone and input the 8-character pairing code provided by Wawp. [wawp_img src="/assets/articles/connect-whatsapp-wawp/confirm-phone.webp" alt="confirm wawp connect to whatsapp" name="Phone Confirmation Prompt" desc="The mobile push notification on WhatsApp used to confirm a new device connection attempt." keywords="phone confirmation, authorize device, link security"]

Once entered successfully, your instance authenticates instantly, and real-time synchronization will begin automatically.

Pro Tips for Managing Your Numbers

To keep your dashboard highly organized and facilitate secure cross-team operations, Wawp provides built-in auxiliary workspace controls:

Remote Linking (Temp Access Link): If the target WhatsApp phone is held by a separate client or team member, open the instance dropdown menu and click Temp Access Link. This generates a secure, time-expiring external gateway URL that allows them to scan the QR code or trigger pairing directly without requiring administrative entry to your main account dashboard.
Assigning Custom Names: Click the small edit pencil directly next to the instance identifier string to define custom operational titles (e.g., "Customer Care Line", "Automated Marketing Line"). This makes navigating high-capacity clusters simple and clear.

Instances Limit & Scaling Quotas

Every Wawp workspace operates under an allocated Instances Limit, which controls how many active WhatsApp channels you can link simultaneously.

Free Plan Quota: The default Free tier enables linking exactly 1 WhatsApp number to test and deploy standard API automations.
Reaching the Limit: Once your allocated instances quota is consumed, the "New Instance" provisioning button becomes disabled automatically to prevent system over-allocation.
How to Scale: If your operations require broadcasting across multiple sending numbers or configuring independent client clusters, you can expand your workspace limit instantly by:
1. Upgrading your Core Plan: Switch to a higher premium subscription tier via the Plan & Billing tab.
2. Purchasing Flexible Add-ons: Navigate to the Add-ons Explorer to provision extra individual flexible instances on-demand without altering your base subscription structure.

Connection Status Guide

Understanding your instance status helps you diagnose connection states and perform the appropriate maintenance actions immediately:

Status Badge	Meaning	Recommended Action
Working	WhatsApp channel connected successfully to Wawp and operating normally.	No action required. Your instance is fully authenticated and actively broadcasting messages or processing integration webhooks.
Scan QR Code	Container prepared. Awaiting initial authorization verification handshakes.	Click Scan QR or Pair Code to link your WhatsApp account immediately before the secure verification session times out.
Starting	The background cluster worker is actively provisioning your container resources.	Wait a few seconds and click the Refresh button at the top of your dashboard until the status updates to ready.
Stopped	The instance container has been halted intentionally by user command.	Open the instance dropdown menu and select Start to wake up the worker instantly without needing to re-link your device.
Failed	An unexpected network handshake exception or device termination occurred.	Inspect your API Logs or Webhook Events for specific payload errors, ensure your phone remains connected, or trigger a restart.