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

# Connect via WhatsApp Web

> Connect a WhatsApp account to GoGHL.ai by transferring an existing WhatsApp Web session. Install the Session Linker Chrome extension, log in to WhatsApp Web, and click one button to move the session to your CRM.

This method uses WhatsApp Web in your browser. Our **Session Linker** Chrome extension links the session that's already active on WhatsApp Web and transfers it to your CRM in one click.

***

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

**Already logged in on WhatsApp Web** - Your WhatsApp account is active on WhatsApp Web in your browser, so you can transfer it without touching your phone.

***

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

* Use **Google Chrome** on a desktop or laptop - the [Session Linker extension](https://chromewebstore.google.com/detail/session-linker-for-whatsa/bkhhpeldemklambeonnkbmnbbnemaoii) is a Chrome extension.
* If you're not logged in to WhatsApp Web yet, keep your phone nearby so you can scan the WhatsApp Web login QR code.
* Set aside about 2 minutes - there is a short sync wait of around 30 seconds before the transfer.

***

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

### Step 1: Choose Connect via WhatsApp Web[​](#step-1-choose-connect-via-whatsapp-web "Direct link to Step 1: Choose Connect via WhatsApp Web")

<Steps>
  <Step>
    Log into your CRM dashboard and open the WhatsApp connection screen for the instance you want to connect.
  </Step>

  <Step>
    Under **Suggested**, click **Connect via WhatsApp Web** - it's marked as the **Most stable connection**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/Q4zq8V77gqE6l10L/images/whatsapp/whatsapp-web-1-connect-button.png?fit=max&auto=format&n=Q4zq8V77gqE6l10L&q=85&s=65f219bee0b488f2ccb6b99dafc569a7" alt="The WhatsApp connection screen with Connect via WhatsApp Web as the suggested login option" width="1719" height="736" data-path="images/whatsapp/whatsapp-web-1-connect-button.png" />
</Frame>

### Step 2: Install the Session Linker Extension[​](#step-2-install-the-session-linker-extension "Direct link to Step 2: Install the Session Linker Extension")

If the extension isn't installed yet, a **Browser extension required** panel appears.

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-2-install-extension.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=aa54a45c4386e85e02f0f1fadad5ab01" alt="The Browser extension required panel with the Install extension button" width="2810" height="1424" data-path="images/whatsapp/whatsapp-web-2-install-extension.png" />
</Frame>

<Steps>
  <Step>
    Click **Install extension**. The [Session Linker for WhatsApp Web](https://chromewebstore.google.com/detail/session-linker-for-whatsa/bkhhpeldemklambeonnkbmnbbnemaoii) page opens in the Chrome Web Store.
  </Step>

  <Step>
    Click **Add to Chrome** and confirm to install it.
  </Step>

  <Step>
    Back on the connection screen, click **I've installed it - re-check**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-2b-chrome-web-store.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=013b5cfafbcbf625b9d8c53766ac5cec" alt="The Session Linker for WhatsApp Web listing in the Chrome Web Store with the Add to Chrome button" width="2880" height="1622" data-path="images/whatsapp/whatsapp-web-2b-chrome-web-store.png" />
</Frame>

Once the installation is detected, you're redirected to WhatsApp Web automatically.

### Step 3: Log In to WhatsApp Web[​](#step-3-log-in-to-whatsapp-web "Direct link to Step 3: Log In to WhatsApp Web")

On WhatsApp Web, the **Session Linker** panel appears in the corner of the page.

* **Already logged in?** Skip to the next step.
* **Not logged in?** The panel shows **Log in to continue**. Log in to WhatsApp Web as usual - scan the QR code with your phone (**WhatsApp → Linked Devices → Link a Device**) or use the phone number option.

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-3-login.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=6bca1449b6753b9ea85173167853dc6b" alt="WhatsApp Web login page with the Session Linker panel asking you to log in to continue" width="3456" height="1810" data-path="images/whatsapp/whatsapp-web-3-login.png" />
</Frame>

### Step 4: Wait for the Session to Sync[​](#step-4-wait-for-the-session-to-sync "Direct link to Step 4: Wait for the Session to Sync")

If the device was just linked, the panel shows **Finalizing sync…** with a short countdown of about 30 seconds. This gives WhatsApp Web a few moments to fully sync so the session is stable before the transfer.

Leave the tab open and wait for the countdown to finish.

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-4-finalizing-sync.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=e71774d660466bd39602d0c69e43b98f" alt="The Session Linker panel showing Finalizing sync with a countdown while WhatsApp Web loads chats" width="3456" height="1816" data-path="images/whatsapp/whatsapp-web-4-finalizing-sync.png" />
</Frame>

### Step 5: Transfer the Account to Your CRM[​](#step-5-transfer-the-account-to-your-crm "Direct link to Step 5: Transfer the Account to Your CRM")

When the session is ready, the panel shows **Transfer this account** with your number listed as logged in on WhatsApp Web.

Click **Transfer +\<your number> to CRM**. That's it - after the transfer, this browser's session is cleared and the tab closes; your CRM takes over the number.

> **Important:** Do not click **Log out** in WhatsApp Web - that unlinks the device and cancels the connection.

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-5-transfer.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=98879e4f3f23e3f72d582ac315cd2b64" alt="The Session Linker panel showing Transfer this account with the Transfer to CRM button" width="3456" height="1820" data-path="images/whatsapp/whatsapp-web-5-transfer.png" />
</Frame>

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

Back in your CRM dashboard, the connection screen shows **Importing your WhatsApp session…** while the transfer completes.

<Frame>
  <img src="https://mintcdn.com/goghl/gKkRpUlMfAQUS9FF/images/whatsapp/whatsapp-web-6-importing.png?fit=max&auto=format&n=gKkRpUlMfAQUS9FF&q=85&s=e7d202bf5f9b18a231341ac8c4bf7b5f" alt="The CRM connection screen showing Importing your WhatsApp session" width="2814" height="1404" data-path="images/whatsapp/whatsapp-web-6-importing.png" />
</Frame>

Once it finishes, 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/JZJa2MoUHOf9Nw9w/images/features/assets/images/link-with-phone-7-connected-10b25470c38ff123217eda89eafa630b.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=0a9727b2239229616c23e6a140e75a6c" alt="GoGHL.ai 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")

* **Don't log out of WhatsApp Web.** Logging out unlinks the device. Use the **Transfer** button - it clears the browser session for you as part of the handover.
* **The tab closes on its own.** After the transfer, the WhatsApp Web tab closes and the browser session is cleared - this is expected. The session now lives in your CRM.
* **One account per instance.** Only one WhatsApp account can be connected per instance.

***

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

### The Extension Isn't Detected[​](#the-extension-isnt-detected "Direct link to The Extension Isn't Detected")

* Make sure you completed the install in the Chrome Web Store, then click **I've installed it - re-check**.
* Confirm you're using Google Chrome - the extension doesn't run in other browsers.
* Refresh the connection screen and try again.

### The Session Linker Panel Doesn't Appear[​](#the-session-linker-panel-doesnt-appear "Direct link to The Session Linker Panel Doesn't Appear")

* Start from the connection screen and click **Connect via WhatsApp Web** so the transfer request is created - opening WhatsApp Web directly isn't enough.
* Check that the extension is installed and enabled in Chrome, then reload the WhatsApp Web tab.

### The Transfer Button Says Please Wait[​](#the-transfer-button-says-please-wait "Direct link to The Transfer Button Says Please Wait")

* This is the sync countdown after a fresh login. Leave the tab open and let it finish - it takes about 30 seconds.

### The Import Doesn't Finish[​](#the-import-doesnt-finish "Direct link to The Import Doesn't Finish")

* Check your internet connection and keep the dashboard open while **Importing your WhatsApp session…** is shown.
* If it stalls, click **Cancel** on the connection screen and start the process again from **Connect via WhatsApp Web**.

***

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

<AccordionGroup>
  <Accordion title="What is 'Connect via WhatsApp Web'?">
    It is an alternative login method that transfers an existing WhatsApp Web session to your CRM. Instead of scanning a QR code on the connection screen, you install the Session Linker Chrome extension, log in to WhatsApp Web, and click one button to move the session across.
  </Accordion>

  <Accordion title="Do I still need my phone?">
    Only if you are not logged in to WhatsApp Web yet - you'll scan the WhatsApp Web login QR code once. If your account is already active on WhatsApp Web, no phone is needed.
  </Accordion>

  <Accordion title="It's transferring a different WhatsApp number - what do I do?">
    The extension transfers the account that is currently logged in on WhatsApp Web in your browser, so check which WhatsApp number is logged in - the Session Linker panel shows the number before you transfer. If a different number is logged in - for example, your personal WhatsApp number instead of your business WhatsApp number - log out of WhatsApp Web from that number, log back in with the required WhatsApp number, and then click the transfer button.
  </Accordion>

  <Accordion title="What happens to my WhatsApp Web session after the transfer?">
    The session moves to your CRM. The browser's session is cleared and the tab closes - you'll no longer be logged in to WhatsApp Web in that browser. Messaging continues through your CRM.
  </Accordion>

  <Accordion title="Why do I have to wait about 30 seconds?">
    If the device was just linked, the extension waits a few seconds for WhatsApp Web to fully sync before transferring, so the session is stable when your CRM takes it over.
  </Accordion>

  <Accordion title="Is it safe to install the extension?">
    Yes. Install it only from the official Chrome Web Store listing linked on the connection screen. The extension's job is to hand your WhatsApp Web session over to your CRM - it clears the browser session as part of the transfer.
  </Accordion>
</AccordionGroup>

***

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

If you need help with the setup or onboarding:

* WhatsApp Support: [Chat on WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20Connect%20via%20WhatsApp%20Web.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)