> ## 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 with a Passkey

> Some WhatsApp numbers can no longer be linked with the usual QR scan and now require a passkey. This guide walks you through the extra browser steps to connect your number to GoGHL.ai using a passkey - it takes about 3 minutes and uses your browser's built-in tools.

## Setup Video[​](#setup-video "Direct link to Setup Video")

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/L8jLTq2evb8?modestbranding=1&rel=0" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />

***

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

**QR scan won't link** - WhatsApp requires a passkey for your number, so scanning the QR code no longer completes the connection.

**Passkey-protected account** - Your WhatsApp account is secured with a passkey (fingerprint, face, or screen lock), and WhatsApp asks for it before linking a new device.

***

## 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 so you can approve the passkey prompt.
* Use a desktop browser (Chrome is recommended) so you can open the developer Console.
* Set aside about 3 minutes and follow the steps in order-there is a short timer.

***

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

### Step 1: Open the Passkey Setup Screen[​](#step-1-open-the-passkey-setup-screen "Direct link to Step 1: Open the Passkey Setup Screen")

If you need a passkey to log in, this window will pop up.

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-1-instructions.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=184748b4784a7bf4c04229d6b362b9d8" alt="The GoGHL.ai Passkey setup screen with the Copy script and Open WhatsApp Web buttons" width="1150" height="720" data-path="images/features/img/passkey-1-instructions.png" />
</Frame>

### Step 2: Copy the Script and Open WhatsApp Web[​](#step-2-copy-the-script-and-open-whatsapp-web "Direct link to Step 2: Copy the Script and Open WhatsApp Web")

<Steps>
  <Step>
    Click **Copy script** to copy the connection script to your clipboard.
  </Step>

  <Step>
    Click **Open WhatsApp Web**. This opens WhatsApp Web in a new tab and starts a 3-minute timer.
  </Step>
</Steps>

> **Important:** In the WhatsApp Web tab, **do not scan the QR code.** You'll paste the script into the browser Console instead.

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-2-whatsapp-web.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=9754202e8da009ab5dc2eeef1dbff212" alt="WhatsApp Web open in a new tab showing the Scan to log in QR code - do not scan it" width="1150" height="720" data-path="images/features/img/passkey-2-whatsapp-web.png" />
</Frame>

### Step 3: Open the Console (Inspect)[​](#step-3-open-the-console-inspect "Direct link to Step 3: Open the Console (Inspect)")

In the WhatsApp Web tab:

<Steps>
  <Step>
    Right-click anywhere on the page and choose **Inspect**, or press **Cmd + Option + I** (Mac) / **Ctrl + Shift + I** (Windows).
  </Step>

  <Step>
    In the developer panel that opens, click the **Console** tab.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-3-open-inspect.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=0a2ab838777422ab030ad7e8c3e8dce4" alt="WhatsApp Web with the browser developer tools open on the Console tab" width="1150" height="720" data-path="images/features/img/passkey-3-open-inspect.png" />
</Frame>

### Step 4: Allow Pasting[​](#step-4-allow-pasting "Direct link to Step 4: Allow Pasting")

The first time you paste into the Console, the browser shows a warning and blocks the paste to keep you safe.

<Steps>
  <Step>
    Press **Cmd + V** (Mac) / **Ctrl + V** (Windows) to try pasting. An orange warning appears-this is normal.
  </Step>

  <Step>
    Type **allow pasting** into the Console and press **Enter**.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-4-allow-pasting.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=b11fc2e2e8f68df11f2bd38bcd42d398" alt="Typing &#x22;allow pasting&#x22; in the Console after the paste warning appears" width="1150" height="720" data-path="images/features/img/passkey-4-allow-pasting.png" />
</Frame>

### Step 5: Paste and Run the Script[​](#step-5-paste-and-run-the-script "Direct link to Step 5: Paste and Run the Script")

<Steps>
  <Step>
    Press **Cmd + V** (Mac) / **Ctrl + V** (Windows) again to paste the script you copied from GoGHL.ai.
  </Step>

  <Step>
    Press **Enter** to run it.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-5-paste-run.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=36765e2a4b1f38667d2bdf28de4ad8ce" alt="The connection script pasted into the Console and running" width="1150" height="720" data-path="images/features/img/passkey-5-paste-run.png" />
</Frame>

### Step 6: Approve the Passkey[​](#step-6-approve-the-passkey "Direct link to Step 6: Approve the Passkey")

A **Passkeys & Security Keys** prompt appears. Approve the passkey with the device that holds it:

* **Use your phone or tablet** - Scan the on-screen QR code with the camera on the device that has your passkey for whatsapp.com.
* **Use your security key** - Insert and touch your security key if you use one.

Then confirm with your fingerprint, face, or screen lock on that device.

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-6-passkey-prompt.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=1ed1faa7d8fe06ab86a100d491a57231" alt="The Passkeys & Security Keys prompt with a QR code to approve on your phone" width="1150" height="720" data-path="images/features/img/passkey-6-passkey-prompt.png" />
</Frame>

### Step 7: Finish on Your Device[​](#step-7-finish-on-your-device "Direct link to Step 7: Finish on Your Device")

Your phone shows a passkey prompt-approve it with your fingerprint, face, or screen lock. The browser then shows **Follow the steps on your device** while it completes the link.

That's it. Once approved, the number connects on its own-**you don't need to switch back to the setup screen.** Your WhatsApp account is now linked and ready to send and receive messages from this location.

<Frame>
  <img src="https://mintcdn.com/goghl/FiVKYbp9npiK_NRw/images/features/img/passkey-7-approve-phone.png?fit=max&auto=format&n=FiVKYbp9npiK_NRw&q=85&s=eeffbca05177440c8866eed8badbb995" alt="The browser showing &#x22;Follow the steps on your device&#x22; while the passkey is approved on the phone" width="1150" height="720" data-path="images/features/img/passkey-7-approve-phone.png" />
</Frame>

***

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

* **Mind the timer.** The setup starts a 3-minute timer. If it runs out, return to the connection screen and start again with a fresh script.
* **Do not scan the QR code** in the WhatsApp Web tab-this method uses the pasted script, not the QR scan.
* **Only paste the GoGHL.ai script.** Never paste code into the Console that you didn't get from GoGHL.ai.
* **Keep your phone unlocked** so the passkey prompt can appear and be approved.
* **One account per instance.** Only one WhatsApp account can be connected per instance.

***

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

### The Paste Is Blocked[​](#the-paste-is-blocked "Direct link to The Paste Is Blocked")

* This is expected the first time. Type **allow pasting** in the Console, press **Enter**, then paste the script again.

### The Timer Ran Out[​](#the-timer-ran-out "Direct link to The Timer Ran Out")

* Go back to the GoGHL.ai connection screen, copy a fresh script, and start the process again.

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

* Make sure you typed **allow pasting** and successfully pasted and ran the script.
* Keep your phone unlocked with the camera ready to scan the on-screen QR code.
* Check that both devices have a stable internet connection, then run the script again.

### The Number Didn't Connect[​](#the-number-didnt-connect "Direct link to The Number Didn't Connect")

* Confirm you approved the passkey on the device that holds it.
* Start over with a fresh script if the timer expired mid-way.

***

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

<AccordionGroup>
  <Accordion title="What is a passkey and why do I need it?">
    A passkey is a secure way to prove it's really you, using your fingerprint, face, or screen lock instead of a password. WhatsApp now requires a passkey to link some numbers, so the usual QR scan won't complete the connection on its own.
  </Accordion>

  <Accordion title="Is it safe to paste the script into the Console?">
    Yes, as long as it's the script GoGHL.ai gave you. The browser shows a warning because pasting unknown code can be dangerous-only ever paste the script from GoGHL.ai, and never code from an untrusted source.
  </Accordion>

  <Accordion title="Why does it say 'do not scan the QR code'?">
    This method links your number through the pasted script and passkey approval, not through the QR scan. Scanning the QR code would start a different flow that won't work for passkey-protected numbers.
  </Accordion>

  <Accordion title="What is the 3-minute timer for?">
    The script and connection request are only valid for a short window. If the timer runs out before you finish, copy a fresh script from the connection screen and start again.
  </Accordion>

  <Accordion title="Do I need to switch back to GoGHL.ai after approving?">
    No. Once you approve the passkey on your device, the number connects on its own. You don't need to return to the setup screen.
  </Accordion>

  <Accordion title="What if I can't open the Console?">
    Use a desktop browser like Chrome, then right-click the page and choose Inspect, or press Cmd + Option + I (Mac) / Ctrl + Shift + I (Windows) and open the Console tab.
  </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%20connecting%20WhatsApp%20using%20a%20Passkey.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)