Help Center
All topics
Get started8Account, team & permissions44Units & fields70Records, views & tasks39WhatsApp & Cortex Chat68Email & social27Lead ads & distribution38Automations52Documents & quotes32Dashboards40Cortex AI18Developers & API12
Help Center·448 guidesAll topicsContact support
Help CenterWhatsApp & Cortex ChatSet up

Link with an 8-character code instead of scanning

If the phone is far from the screen, ask for an 8-character pairing code such as ABCD-EFGH, and type it in WhatsApp on the phone. The result is the same as scanning the QR code.

3 min
Open in Corteksa
Before you start · 1 thing · for owners and managers
A session in “Scan QR” status

Steps

1
Open the session’s QR code (in the setup wizard, or QR Code in the session’s actions menu), and choose the Use phone number tab.
2
Type the WhatsApp number in international format, with the country code, such as +966512345678, then press Get code.
An 8-character code shows, in the format ABCD-EFGH.
3
On the phone, open WhatsApp → Linked devices → Link a device, then choose Link with phone number instead.
4
Type the code exactly as it showed.
The session changes to Working, and you get a notification that it’s linked.

How it works

Before issuing the code, Corteksa checks that the number isn’t linked to another session in the workspace, and that your plan allows one more session. That way the request is refused early, instead of the number being disconnected after you type the code.

WhatsApp doesn’t always issue a pairing code for every account. If it doesn’t, you see that the code isn’t available, and then you scan the QR code instead.

If something goes wrong

What you see
Why
What to do
“Pairing code not available — use the QR code”
WhatsApp didn’t issue a code for this number.
Go back to scanning the code.
“This session isn’t waiting to be linked”
The session isn’t in Scan QR status.
Start the session and wait for the QR code to appear, then ask for the pairing code. See Session states: start, stop, restart and log out.
“This number is already linked to the session ...”
The number is working in another session.
Use that session, or delete it first. See One number per session.
“The number must be a valid international number”
The number has no country code, or it has a mistake.
Type it like +966512345678.

A real example

Namaa Academy
The situation

The academy’s director is in Jeddah, and the sales number’s phone is with an employee at another branch.

What they did
  1. He created the session from his computer and asked for a pairing code for the sales number.
  2. He sent the code to the employee, and she typed it in WhatsApp.
The result

The number was linked in 2 minutes, without moving the phone.

A made-up company, to show the idea. The numbers are rounded.

Good to know

You can only ask for the code for a session in Scan QR status.
The number must be in a correct international format.
A number linked to another session in the workspace is refused, with a message naming the session that has it.
The code is for WhatsApp Web sessions only.
Did this guide solve it?
If not, we’ll ask what was missing.
Next, you might need
Connect by QR code
Step by step · 5 min
One number per session
Explains · 3 min
Session limit
Explains · 3 min
Open in Corteksa
Did this guide solve it?

We read every answer. To get a reply, use Contact support.