The site is currently in beta.
WhatsApp API

How to link a WhatsApp number to the client portal

Smart One Group support teamLast updated: 3 min read

Short answer

To link a WhatsApp number to the Smart One Group WhatsApp API, open “WhatsApp” in the client portal, go to the “Link devices” tab and accept the number linking terms. Then, on your phone, open WhatsApp, choose “Linked devices”, tap “Link a device” and scan the QR code. When the status turns “Connected”, send a test message to confirm the number is ready for your app.

On this page

Steps to link a WhatsApp number

  1. Step 1: Open “WhatsApp”

    In the client portal open WhatsApp, then the Link devices tab. The section appears once your WhatsApp API subscription is active.

  2. Step 2: Accept the number linking terms

    Read the Number linking terms, tick I have read the terms and I agree, then click I agree and start linking. The link code stays hidden until you accept.

  3. Step 3: Scan the QR code with your phone

    On the phone that owns the number, open WhatsApp, then Settings → Linked devices → Link a device, and point the camera at the code. The code refreshes by itself every few seconds; if it expires, click Refresh code.

  4. Step 4: Check the connection and send a test

    The status turns Connected and your number appears. Enter another WhatsApp number under Test message delivery and click Send test message; it is a real message and counts toward your package limit.

What does the device status mean?

StatusMeaningWhat to do
ConnectedThe number is linked and ready to send and receive.Nothing. You can send from your app.
Waiting for scanA QR code is showing and has not been scanned yet.Scan it from Linked devices in WhatsApp.
DisconnectedThe number was unlinked, for example after logging it out from Linked devices on the phone.Link it again by scanning a new code.
PendingThe linking session is being prepared.Wait a moment or click Refresh code.

Sending through the API needs a device that is Connected; otherwise the response carries the device_offline error. Details in the WhatsApp API reference.

Can I link more than one number?

Yes, up to the device limit of your package. Click Add device on the Link devices tab and scan a new code from the other phone. Devices used and allowed are shown at the top of the tab and on the Package & usage tab.

If you see Device limit reached, upgrade your package from Subscriptions.

How do I disconnect or change the number?

Click Disconnect on the Link devices tab and confirm. To link another number afterwards, scan a new code from the new phone. You can also unlink from the phone itself under Linked devices in WhatsApp.

Common questions

Not all the time; WhatsApp linked devices keep working while the phone is off. WhatsApp does unlink them if the app is not opened on the phone for a long time (about 14 days), so open it now and then.

First make sure you accepted the Number linking terms, then click Refresh code. If you see The link code is not available right now, wait a minute and try again; if it persists, open a support ticket.

No. The test is a real WhatsApp message, counts toward your package message limit, and only a few can be sent per minute.

Yes. Linking uses Linked devices, which both WhatsApp and WhatsApp Business offer.

Ready to start?

How to link a WhatsApp number to the client portal

Open WhatsApp