Account safety

Unofficial WhatsApp API and QR linking: why the number gets banned, and how the official API differs

What the unofficial WhatsApp API linked by QR code is, why WhatsApp bans numbers that use it for a bot or for campaigns, the warning signs, how it differs from the official WhatsApp API, and how to move with your number.

8 min read Updated 17 November 2026 ArabyBot team
The ArabyBot teamOfficial Meta partner · written from our own platform data
On this page 6
  1. What unofficial WhatsApp means
  2. Why WhatsApp bans a number working this way
  3. Signs that come before the final ban
  4. The difference between the unofficial and the official API
  5. The fix that does not depend on luck: the official API
  6. Frequently asked questions

The short answer

Because these systems log into your number the way WhatsApp Web does, by scanning a QR code, then send and reply automatically from your personal or Business app account. WhatsApp says its products are not intended for automated or bulk messaging and that both violate the Terms of Service, and that it detects accounts sending automated messages with machine learning and reports and bans them. So a ban here is not bad luck but the expected result of the method itself. The official API is not linked by QR code: it is registered in a business account at Meta, its templates are approved, and its violations start with a written warning.

Also asked as: «الفرق بين واتساب api الرسمي وغير الرسمي» · «بوت واتساب بالباركود بيحظر الرقم» · «واتساب غير رسمي ليه بيتحظر» · «ربط واتساب qr امن ولا لا» · «is unofficial whatsapp api safe» · «official vs unofficial whatsapp api» · «whatsapp qr bot banned»

What unofficial WhatsApp means

Two kinds carry the name. The first is a modified version of the WhatsApp app downloaded from outside the official stores. The second is a system that asks you to scan a QR code from your phone, as you do with WhatsApp Web, and so becomes a device linked to your account that a program sends from and replies on: a bot, an AI agent, or a campaign to thousands of numbers.

The second is often sold as «WhatsApp API», and it is not the official WhatsApp API. Its mark is that it starts with scanning the code, and that messages in it are free with no templates to approve.

Why WhatsApp bans a number working this way

  • Automated and bulk messages are a violation. WhatsApp says its products are not intended for them, and that both have always violated the Terms of Service.
  • Detection is automated. WhatsApp uses machine learning and users' reports to detect and ban accounts that send automated messages.
  • Modified versions are forbidden. WhatsApp says: do not use modified versions of WhatsApp, and using an unauthorized application can result in the account being banned.
  • And the companies themselves are pursued. WhatsApp says it takes legal action against those engaged in automated or bulk messaging or assisting others in it.
  • And the linking itself is a violation. WhatsApp says using unofficial apps and websites, or linking your account to an unofficial version of WhatsApp, violates the Terms of Service, and that the account might be banned temporarily or permanently, or restricted so that it loses the ability to link devices.
  • Examples WhatsApp names: GB WhatsApp, FM WhatsApp, TeleMessage, TM WhatsApp, and others.
  • And WhatsApp's supported agent is something else. WhatsApp separates an agent connected through the supported Agents feature inside WhatsApp itself from connecting the account in an unofficial app or website; the distinction does not cover unofficial connection methods.
WhatsApp Help Center «Unauthorized use of automated or bulk messaging on WhatsApp»measured 17 November 2026WhatsApp Help Center «How to use WhatsApp responsibly»measured 17 November 2026WhatsApp Help Center «About account bans for unofficial apps»measured 17 November 2026WhatsApp Help Center «About unofficial WhatsApp apps»measured 17 November 2026

Signs that come before the final ban

  • The «Temporarily banned» message: for WhatsApp it means an unofficial version or automated harvesting of data. If that does not stop, the ban becomes permanent.
  • The «Your account is restricted» message: the account's activity shows signs of spam, automated or bulk messaging. During the restriction you cannot start chats with new numbers or use linked devices, so the system linked by the code stops.
  • The link dropping again and again: the system asks you to scan the code anew time after time.
WhatsApp Help Center «About temporarily banned accounts»measured 17 November 2026WhatsApp Help Center «About restricted accounts»measured 17 November 2026

The difference between the unofficial and the official API

  • How it connects. Unofficial: scanning a QR code from your phone. Official: registering the number in a business account at Meta.
  • Automatic replies. Unofficial: a violation of the app's terms. Official: permitted, and what the API was made for.
  • The message you start. Unofficial: any text to any number. Official: a template Meta approves first, at a published price per country.
  • On a violation. Unofficial: a ban on the number with no explanation. Official: a written warning, then a restriction with a duration, then an appeal.
  • The price. Unofficial: messages are free and the number is the price. Official: template messages are paid, and the number stays.
Meta developer docs «WhatsApp Business Platform policy and spam enforcement»measured 17 November 2026

WhatsApp Business or the official API · What the WhatsApp Cloud API is

The fix that does not depend on luck: the official API

Whoever tried an AI agent or a campaign on a system linked by the code and then lost their number was not wrong about the idea, but about the road. The AI agent and the campaigns are all available on the official API, and the difference is that the number stays.

On the official WhatsApp API the rules are written down: Meta starts with a warning that names the policy that was broken, then a block on templates for one or three days, then a block on all messages for five, seven or thirty days, then a lock removed only by an appeal, then permanent disabling for an account that changed nothing after repeated warnings. An appeal is typically reviewed within 24 to 48 hours.

Meta developer docs «WhatsApp Business Platform policy and spam enforcement»measured 17 November 2026

And you move with your own number. A WhatsApp Business app number is connected to the API through a partner that supports onboarding app numbers, so the app stays on your phone and the API works beside it. The other way is deleting the app account and then registering the number on the API, which loses the earlier conversations. ArabyBot connects the number either way.

Meta developer docs «Migrate an existing WhatsApp number to a business account»measured 17 November 2026
62%of the API templates were read
32%were delivered and not read yet
6%failed, each with a code and a reason
ArabyBot's measurement on 11,900 templates sent through the official send API between 18 Oct and 16 Nov 2026measured 16 November 2026

One account carries over 99% of these messages; so this is one business's result, not a market rate. What matters in it for someone who has lived a ban: a message that does not arrive on the official API comes back with an error number that explains why, and the whole number does not stop without an explanation. WhatsApp error codes and what they mean

A WhatsApp bot on the official API · The quality rating and sending limits · WhatsApp API pricing

Frequently asked questions

1

Is every «WhatsApp API» on sale official?

No. If the connection starts with scanning a QR code from your phone, it is not the official API. The official one is registered in a business account at Meta, and its templates are approved before sending.

2

I used an unofficial system and my number was not banned; am I safe?

There is no guarantee. WhatsApp says it keeps improving its detection systems and bans on their basis. A number not banned today is working in a way that violates the terms every day.

3

Can I move my number from an unofficial system to the official API?

Yes, as long as the number works. Unlink the system linked by the code from Linked devices, then connect the number to the official API: either with the WhatsApp Business app staying on your phone through a partner that supports it, or by deleting the app account and registering the number on the API.

4

Is the AI agent itself the cause of the ban?

No. The cause is that the agent answers from the app account, a place where automated messages are forbidden. The same agent on the official API works within the rules.

5

Is linking WhatsApp to an outside website or system by QR code a violation?

Yes, if the system is unofficial. WhatsApp says using unofficial apps and websites, or linking your account to an unofficial version of WhatsApp, violates the Terms of Service, and that the account might be banned temporarily or permanently or lose the ability to link devices.

Every WhatsApp ban page in one place

The ArabyBot teamOfficial Meta business partner in the Middle East 264 guides Figures from our platform All guides

How we write these guides Figures come from our platform and Meta's actual invoices, dated with their sample; we describe what works today, not what we plan, and say what we do not do and when someone else is the better choice. Reviewed by the ArabyBot team on 17 November 2026.

Share this guide

Try the agent before you pay anything

The agent that will answer your customers is the one answering you now: ask it from the chat button here or on WhatsApp. Your account is free with no credit card, and the free trial on your own number or page is activated after you contact our team on customer-service WhatsApp.

And you run all of it from your phoneEverything on this page is also run from the ArabyBot mobile app — replies, orders, campaigns and AI reports. Not a web dashboard only.