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
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.
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.
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.
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?
| Status | Meaning | What to do |
|---|---|---|
| Connected | The number is linked and ready to send and receive. | Nothing. You can send from your app. |
| Waiting for scan | A QR code is showing and has not been scanned yet. | Scan it from Linked devices in WhatsApp. |
| Disconnected | The number was unlinked, for example after logging it out from Linked devices on the phone. | Link it again by scanning a new code. |
| Pending | The 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
Ready to start?
How to link a WhatsApp number to the client portal

