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

# Log in with Phone Number

> The  feature lets you connect a WhatsApp account to the system using a short  instead of scanning a QR code. WhatsApp calls this "linking with phone number," and it's the perfect alternative when you can't scan the QR code-for example, when you're setting up on the same phone that holds WhatsApp, or when the camera can't reach the screen.

Instead of pointing your phone's camera at a QR code, the dashboard shows you a code, and you type that code into WhatsApp on your phone to link the device.

***

## When to Use It[​](#when-to-use-it "Direct link to When to Use It")

**Camera can't scan** - The QR code won't scan because of screen glare, a damaged camera, or display issues.

**Remote setup** - It's easier to read out or paste a code than to share a scannable QR image.

***

## Before You Start[​](#before-you-start "Direct link to Before You Start")

* The WhatsApp account you want to connect must be active on your phone.
* Keep your phone nearby and unlocked during setup.
* Make sure both devices have a stable internet connection.

***

## Step-by-Step Setup[​](#step-by-step-setup "Direct link to Step-by-Step Setup")

### Step 1: Open the WhatsApp Connection Screen[​](#step-1-open-the-whatsapp-connection-screen "Direct link to Step 1: Open the WhatsApp Connection Screen")

<Steps>
  <Step>
    Log into your CRM dashboard.
  </Step>

  <Step>
    Click **Message Hub** in the left sidebar.
  </Step>

  <Step>
    Select the WhatsApp instance and click **Manage** to open the connection screen.
  </Step>

  <Step>
    You'll see the QR code and, just below it, a **Log in with phone number** button.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/assets/images/link-with-phone-1-connect-screen-7f1a34f8633de6e01e46375420de68bd.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=3361b85d1e8b90018d23f1f14a5e13e2" alt="WhatsApp connection screen with the Log in with phone number button" width="2880" height="1557" data-path="images/features/assets/images/link-with-phone-1-connect-screen-7f1a34f8633de6e01e46375420de68bd.png" />
</Frame>

### Step 2: Enter Your Phone Number[​](#step-2-enter-your-phone-number "Direct link to Step 2: Enter Your Phone Number")

<Steps>
  <Step>
    Click **Log in with phone number**.
  </Step>

  <Step>
    Select your country from the dropdown.
  </Step>

  <Step>
    Enter the phone number tied to the WhatsApp account you're connecting.
  </Step>

  <Step>
    Click **Next**.
  </Step>
</Steps>

> **Tip:** If you'd rather scan the QR code instead, click **Log in with QR code** to switch back at any time.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/assets/images/link-with-phone-2-enter-number-237123cb54586da37092df2733286626.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=55f6b4e5134896fc62e59f4cb656c02b" alt="Enter the phone number for the WhatsApp account" width="2880" height="1557" data-path="images/features/assets/images/link-with-phone-2-enter-number-237123cb54586da37092df2733286626.png" />
</Frame>

### Step 3: Get Your 8-Character Code[​](#step-3-get-your-8-character-code "Direct link to Step 3: Get Your 8-Character Code")

The dashboard displays an 8-character code (for example, `QDV8-CG7V`). You'll enter this code into WhatsApp on your phone.

* Click **Copy code** to copy it to your clipboard.
* The code expires after a short time-if it does, request a new one.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/assets/images/link-with-phone-3-code-displayed-4f8a2f3ca435e601849cac3244961226.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=52d675b6f62c464c22de75bc030ae3d6" alt="The dashboard displays the 8-character linking code" width="2880" height="1557" data-path="images/features/assets/images/link-with-phone-3-code-displayed-4f8a2f3ca435e601849cac3244961226.png" />
</Frame>

### Step 4: Confirm the Device[​](#step-4-confirm-the-device "Direct link to Step 4: Confirm the Device")

WhatsApp asks you to confirm the new device-for example, *"Chrome (Mac OS) is attempting to link to your WhatsApp account."* Tap **Confirm** to continue.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/img/link-with-phone-6-wa-confirm-device.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=79bba637b4ac80d2fe31f0ebb2821d4e" alt="WhatsApp confirms the linked device" width="1179" height="2556" data-path="images/features/img/link-with-phone-6-wa-confirm-device.png" />
</Frame>

### Step 5: Open the Code Entry Screen in WhatsApp[​](#step-5-open-the-code-entry-screen-in-whatsapp "Direct link to Step 5: Open the Code Entry Screen in WhatsApp")

On your phone:

<Steps>
  <Step>
    Open **WhatsApp**.
  </Step>

  <Step>
    Tap **Menu** (three dots) on Android, or **Settings** on iPhone.
  </Step>

  <Step>
    Tap **Linked Devices**, then tap **Link a Device**.
  </Step>

  <Step>
    Tap **Link with phone number instead**.
  </Step>

  <Step>
    WhatsApp shows an empty 8-box **Enter code** screen.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/img/link-with-phone-4-wa-enter-code.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=aa2425d6734796e647105febe972a9ea" alt="WhatsApp Enter code screen on the phone" width="1179" height="2556" data-path="images/features/img/link-with-phone-4-wa-enter-code.png" />
</Frame>

### Step 6: Enter the Code[​](#step-6-enter-the-code "Direct link to Step 6: Enter the Code")

Type (or paste) the 8-character code from the dashboard into WhatsApp. WhatsApp shows **Logging in…** while it links the device.

> **Security:** Never enter a code you didn't request yourself.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/img/link-with-phone-5-wa-logging-in.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=4b81f9fdbca65e0b6bc26b85509e45a6" alt="Entering the code in WhatsApp shows Logging in" width="1179" height="2556" data-path="images/features/img/link-with-phone-5-wa-logging-in.png" />
</Frame>

### Step 7: Connection Complete[​](#step-7-connection-complete "Direct link to Step 7: Connection Complete")

Back in the dashboard, the screen updates to **WhatsApp Connected** with a **Successfully Connected** message. Your WhatsApp account is now linked and ready to send and receive messages from this location.

<Frame>
  <img src="https://mintcdn.com/goghl-whitelable/d0UJrCwlyc8wzaxE/images/features/assets/images/link-with-phone-7-connected-10b25470c38ff123217eda89eafa630b.png?fit=max&auto=format&n=d0UJrCwlyc8wzaxE&q=85&s=007a1043aa06f341dc75e91b8e634068" alt="The dashboard shows WhatsApp successfully connected" width="2880" height="1557" data-path="images/features/assets/images/link-with-phone-7-connected-10b25470c38ff123217eda89eafa630b.png" />
</Frame>

***

## Important Notes[​](#important-notes "Direct link to Important Notes")

* **Codes are time-limited.** If the code expires before you enter it, generate a new one from the connection screen.
* **One account per instance.** Only one WhatsApp account can be connected per instance.
* **Phone number must match.** Enter the number for the exact WhatsApp account you want to connect.
* **Keep your phone unlocked** during setup so the confirmation prompt can appear.

***

## Troubleshooting[​](#troubleshooting "Direct link to Troubleshooting")

### The Code Doesn't Work[​](#the-code-doesnt-work "Direct link to The Code Doesn't Work")

* Make sure you typed all 8 characters exactly as shown, including the correct case.
* The code may have expired-request a new one and try again.

### The Phone Number Is Rejected[​](#the-phone-number-is-rejected "Direct link to The Phone Number Is Rejected")

* Double-check the country code and number.
* Use the number tied to the WhatsApp account you're connecting.

### No Confirmation Prompt Appears[​](#no-confirmation-prompt-appears "Direct link to No Confirmation Prompt Appears")

* Keep your phone unlocked and WhatsApp open during setup.
* Check your internet connection on both devices.
* Restart the process from the connection screen if it stalls.

### Prefer to Scan Instead[​](#prefer-to-scan-instead "Direct link to Prefer to Scan Instead")

* Click **Log in with QR code** to switch back to the standard QR scanning method.

***

## FAQs[​](#faqs "Direct link to FAQs")

<AccordionGroup>
  <Accordion title="What is 'Log in with phone number'?">
    It is an alternative to scanning the QR code. The dashboard shows you an 8-character code, and you type that code into WhatsApp on your phone to link the device.
  </Accordion>

  <Accordion title="When should I use this instead of the QR code?">
    Use it when you cannot scan the QR code-for example, when the dashboard is open on the same phone that has WhatsApp, or when your camera cannot read the QR code.
  </Accordion>

  <Accordion title="How long is the code valid?">
    The code is time-limited. If it expires before you enter it, generate a new one from the connection screen.
  </Accordion>

  <Accordion title="Is it safe to enter the code?">
    Yes, as long as you requested it yourself. Never enter a code you did not request. WhatsApp also asks you to confirm the device before linking completes.
  </Accordion>

  <Accordion title="Which phone number should I enter?">
    Enter the number tied to the exact WhatsApp account you want to connect, with the correct country code.
  </Accordion>

  <Accordion title="Can I switch back to the QR code method?">
    Yes. Click "Log in with QR code" on the connection screen to return to standard QR scanning at any time.
  </Accordion>
</AccordionGroup>

***

## Support[​](#support "Direct link to Support")

If you need help with the setup or onboarding:

* Email: [**support@messagesync.ai**](mailto:support@messagesync.ai)