Why your WhatsApp bot keeps getting banned: diagnosis and appeal

A restricted number is a symptom and the useful question is of what. The causes fall into a few distinct categories with different consequences: a quality problem you can recover from, a policy violation you can appeal, and an unauthorised-access finding you generally cannot.

Working out which one you have determines whether the next step is an appeal, a change of behaviour, or accepting that the number is gone and planning accordingly.

What we'll cover

• Restriction is not one thing
• Reading what happened
• The quality-driven restriction
• Building it with CodeWords
• The policy violation
• The unauthorised access finding
• Appealing, and what makes one work
• When the number is not coming back
• What to tell customers while you are restricted
• Making it survive
• Limits worth knowing about
• What to do first
• Frequently asked questions

Restriction is not one thing

A messaging limit reduction is a constraint rather than a ban, and it is reversible through behaviour.

A temporary restriction stops sending for a period and is usually quality-driven.

A business account ban removes the account's ability to use the platform.

A number ban removes the number, which is the outcome people mean when they say banned.

A portfolio-level action affects everything under it, which is the most serious and the least commonly understood.

The distinction matters because the remedy for one does nothing for another.

Reading what happened

Check Business Manager first, where the account status and any notice is shown.

Look at the quality rating history, which frequently shows a decline preceding the action.

Look at what changed in the days before: a new campaign, a new list, a new template, a volume increase.

Check the template that was sending when it happened, since one poorly received template can account for it.

Ask your provider, if you use one, since they may have visibility and context you do not.

Do not immediately re-register elsewhere, which looks like evasion and makes everything worse.

The quality-driven restriction

The most common cause, and the most recoverable.

Blocks and spam reports from recipients are the driver, and they accumulate faster than most teams monitor.

It is usually one audience — a purchased list, an old list, a segment that did not opt in for this.

Stop the campaign rather than reducing it, since continuing at lower volume prolongs the signal.

Send only wanted messages for a period: transactional, requested, replies within an open window.

Recovery takes sustained good behaviour over a period rather than an action you can take today.

Building it with CodeWords

CodeWords connects to more than 3,000 integrations, and the connection is made once and reused.

1. Open CodeWords and start a new automation.
2. Describe what should happen in plain language to Cody, the automation builder: which messages send, to whom, and what stops a send.
3. Authorize the connection to your WhatsApp Business Platform account.
4. Describe the exceptions: a customer who has not opted in, a quality rating drop, a limit reached, an opt-out request.
5. Run it with monitoring on the quality rating before increasing volume.

You describe the outcome; Cody builds it, connects it, and deploys it. The free plan covers light use, with Pro at $39 per month and Business at $100 per month as usage grows; details are on the pricing page.

The policy violation

Prohibited content and prohibited categories are the usual cause, and the list is broader than people expect.

Some sectors are restricted entirely regardless of how carefully you message.

Template category misuse — sending marketing content through a utility template — is a specific and common finding.

Claims in message content can trigger it, particularly around health, finance and prohibited goods.

Read the Commerce and Business Messaging policies properly rather than assuming general advertising rules apply.

This category is appealable where it is a misunderstanding, and is not where the content genuinely breached policy.

The unauthorised access finding

Using unofficial tooling is detected behaviourally and results in a ban that is usually permanent.

Having migrated to the official platform does not clear history on a number previously used that way.

Bought or rented numbers frequently carry prior history you did not create and cannot see.

Shared or recycled numbers are a related risk, since a number's past is attached to it.

Appeals rarely succeed here, because the finding is about the method rather than the content.

Plan for replacement rather than spending weeks appealing.

Appealing, and what makes one work

Use the official route in Business Manager or through your provider rather than informal channels.

Be specific about what changed. An appeal saying you will be more careful is weaker than one describing the campaign you stopped and the list you deleted.

Include your opt-in evidence, since consent is the question underneath most quality findings.

One appeal, properly made, beats several repeated ones, which can themselves be a negative signal.

Expect it to take time and to give no detailed reasoning either way.

Fix the cause while appealing, because an appeal granted on a number still doing the same thing is temporary.

When the number is not coming back

Decide early. Weeks spent appealing an unauthorised-access ban are weeks not spent migrating.

Plan the number change as a project: signage, listings, invoices, website, the CRM, every integration.

Tell customers through channels you still have, which is why a business dependent on one channel is exposed.

Start the new number clean, with verification, opt-in and a warm-up rather than the previous volume.

Do not reuse the same practices, since the new number will follow the old one.

Treat it as the cost of the original decision, which is the calculation worth doing before rather than after.

What to tell customers while you are restricted

A restriction is visible to customers as silence, which they interpret as being ignored. Handling that is a separate task from handling the restriction.

Say something on the channels you still have — email, your site, a phone line — rather than waiting for the platform to be restored.

Do not ask customers to message a different WhatsApp number in the middle of a restriction, since a sudden second number attracts exactly the attention you do not want.

Answer what arrives, because inbound replies inside an open window are frequently still possible even when outbound sending is limited.

Prioritise anybody mid-transaction — an order, a booking, an appointment — who will otherwise conclude you have disappeared.

Keep a record of what you could not send, so it can be sent once the restriction lifts rather than lost.

Be honest internally about the cause, since a team told the platform is "having issues" learns nothing and will repeat the campaign.

Making it survive

Monitor quality rating daily, since it is the leading indicator of everything in this article.

Keep opt-in records in a form you can produce on request.

Alert on a rating change to somebody who can stop a campaign.

Have a second channel for critical communication, so a restriction is not an outage.

Report the outcome: sends, blocks where visible, rating, and any notices received.

Limits worth knowing about

You will not get a detailed explanation, in most cases, for either the action or an appeal outcome.

A provider cannot overturn Meta's decision, only route your appeal.

Recovery timelines are not published and vary.

Prior history follows a number, which is why a used number is a risk.

Prevention is the only reliable strategy, since the process after the fact is slow and opaque.

What to do first

Establish which category you are in, from Business Manager and from what changed in the preceding days. A quality restriction, a policy finding and an unauthorised-access ban need completely different responses, and the most expensive mistake is spending a fortnight appealing something that was never appealable.

Two habits make the difference. Stop the offending campaign entirely rather than reducing it, since a continued signal at lower volume prolongs the restriction rather than easing it. And monitor the quality rating daily, because it declines before a restriction arrives and it is the only warning the platform gives you.

Frequently asked questions

Is a restriction the same as a ban?

No. A messaging limit reduction, a temporary sending restriction, a business account ban, a number ban and a portfolio-level action are different outcomes with different remedies, and treating them as one is why people apply the wrong response.

What is the most common cause?

A quality-driven restriction from blocks and spam reports, usually traceable to one audience — a purchased list, an old list, or a segment that did not opt in for that kind of message.

How do I recover from a quality restriction?

Stop the campaign rather than reducing it, send only wanted messages for a period — transactional, requested, replies inside an open window — and accept that recovery is sustained behaviour over time rather than an action you can take today.

What makes an appeal more likely to work?

Specificity. Describing the campaign you stopped and the list you deleted, with opt-in evidence attached, is stronger than a commitment to be careful. One properly made appeal beats several repeated ones.

Can a ban for using unofficial tooling be appealed?

Rarely successfully, because the finding is about the method rather than the content. Deciding that early matters, since weeks spent appealing are weeks not spent migrating.

Why did a number get banned that I just bought?

Prior history follows a number. Bought, rented or recycled numbers frequently carry history you did not create and cannot see, which is an argument for registering a number with no prior WhatsApp use.

Should I register elsewhere while appealing?

No. Immediately re-registering looks like evasion and makes the overall position worse.

What is the only reliable strategy?

Prevention. The process after the fact is slow, opaque and gives no detailed reasoning, so daily quality monitoring and retained opt-in records are worth considerably more than any recovery plan.

What do I tell customers during a restriction?

Reach them on channels you still have rather than waiting. Prioritise anybody mid-transaction, since silence during an order or a booking reads as the business disappearing. Keep a record of what could not be sent so it goes out afterwards rather than being lost.

Should I move customers to a second WhatsApp number during a restriction?

No. A sudden second number in the middle of a restriction looks like evasion and attracts exactly the scrutiny you are trying to avoid.

Related reading

• The WhatsApp anti-ban playbook
• WhatsApp automation mistakes that get numbers flagged
• WhatsApp Business Platform vs unofficial APIs