WhatsApp Campaign Troubleshooting

TL;DR

A WhatsApp campaign is a process with plenty of points where things can go wrong. A message template wasn’t approved, a list came up empty, a scheduled campaign goes out at the wrong time, some recipients don’t get the message, or an error pops up the moment you hit send. This article covers the most common problems, organized by the stage where they appear: before sending, at the moment of sending, in scheduled campaigns, and after the campaign goes out. Each problem comes with an explanation, a fix, and, where relevant, a link to a more in-depth article.

How to use this guide

The problems below are organized by the campaign stage where they crop up. Look for the symptom that matches what you’re seeing on screen. Each problem is a self-contained unit, so you can jump straight to it without reading the ones before it. If the problem is urgent (a campaign going out soon and you can’t see the list), jump to the relevant section, fix it, and come back to read the context afterward.

Problems before sending

I don’t see my message template in the campaign selection list

Only message templates in Approved status appear in the list. Check the status on the message templates page. Statuses that don’t allow sending:

Pending. The message template was submitted to Meta and is still under review. The wait is usually less than an hour, sometimes up to 24 hours.
Rejected. Meta rejected it. You’ll need to edit and resubmit. See Message Template Rejected: A Full Guide to Fixing and Appealing.
Paused. The message template was temporarily suspended due to low quality. You’ll need to wait for it to be reinstated or edit it.
Disabled. The message template was permanently disabled. You’ll need to create a new one.

If the status is Approved but the message template still isn’t showing in the list, refresh the campaigns page.

The list I want to select isn’t showing up

Check that the list actually exists on the customer management page. Lists that were deleted or recently renamed won’t appear in the selector. If the list was created a moment ago, refresh the page.

I selected a list but it doesn’t show the expected number of recipients

Some customers in the list may be:

Without a valid phone number. Only customers with a WhatsApp number in international format are counted.
In Opted-Out status. Customers who asked to remove themselves won’t receive messages, and may not be counted.

An error about a missing variable when I click “Send”

If the message template includes variables {{1}}, {{2}}, {{3}}, you must fill each one with either free-form text or a system variable. If you leave a variable empty, Mumble returns an error before sending. Check that all parameters are filled, and that the variables you chose actually exist on the customer cards.

I chose a system variable but it doesn’t display correctly for some customers

If you chose a system variable like “First Name” but some customers have no value in that field, Mumble will send the message with the field empty (for example, “Hi ,” instead of “Hi Dana,”). The fix:

Set a default value on the customer cards before sending. Manually update the missing ones to “Customer” or a similar term.
Or, split the list in two: customers with a name and customers without one. Send each group a tailored message.

Problems at the moment of sending

The campaign went out but the report shows 0 messages sent

The most common cause: the list was empty at the moment of sending. Possible reasons:

The list was deleted between the moment you selected it and the moment of sending.
All customers were removed from the list.
The customers’ status was changed to one that isn’t eligible to receive campaigns (for example, blocked).

Worth knowing: Mumble doesn’t block a campaign that goes out to an empty list. It counts as a valid send with 0 recipients. Check the list before resending.

Some customers received the message twice

Mumble filters duplicates automatically within each campaign, even when you select more than one list. If a customer received the message twice, the campaign was most likely sent twice by mistake.

Check the campaigns page to see whether more than one campaign appears with the same message template on the same date. This can happen when someone clicked “Send” more than once, or when two people on the team sent the same campaign without coordinating.

How to prevent it in the future:

Set up an internal approval process before sending a large campaign, especially if several agents have send permissions.
Give each campaign a unique, clear name (for example, “Independence Day Sale 2026”) so it’s easy to tell whether it’s already been sent.
After clicking “Send,” wait for the on-screen confirmation before clicking again.

Sending is slow, some messages are still pending after an hour

Mumble sends large campaigns gradually to stay within Meta’s limits. A campaign of 10,000 recipients can spread out over several hours, and that’s normal behavior. During sending, the report updates in real time, and you’ll see messages move from pending to sent to delivered gradually.

If messages are still pending after 24 hours, there’s a real problem. Possible reasons:

You hit Meta’s tier limit. If the campaign exceeded the daily allowed number of recipients, the surplus messages will only go out after the limit resets.
Account quality dropped. Meta can throttle sending on numbers with a low quality rating. See Quality Rating: The Complete Guide.
A message template was suspended during the campaign. If Meta suspended the message template while it was sending, subsequent messages will come back as failed.

An error message the moment I click “Send”

Common errors when sending:

“Campaigns can’t be sent on your current plan.” The Standard plan doesn’t include campaigns. A Pro plan or higher is required. See Upgrading or Changing Your Plan.
“You’ve exceeded your monthly message template quota.” Every plan includes a number of message templates per month. If you’ve hit the limit, you won’t be able to send until next month or until you upgrade. Another option: pay overage ($0.0105 per additional message).
“The number is in Restricted status by Meta.” The WhatsApp Business account was restricted. See Meta Business Verification: The Complete Guide.

Problems with scheduled campaigns

I want to edit a scheduled campaign that hasn’t gone out yet

Scheduled campaigns can’t be edited. You can only cancel them and create a new campaign with the updated details.

Steps:

On the campaigns page, find the scheduled campaign (usually marked as “Scheduled”).
Click the cancel icon in the actions column.
Create a new campaign with the changes you wanted, and schedule it for the desired time.

Important: canceling a scheduled campaign is irreversible. Make sure you want the new campaign before canceling the existing one.

The scheduled campaign didn’t go out at the time I set

Check that the time you set is in the future and not in the past. A campaign scheduled for a date that has already passed won’t be sent. If a future schedule didn’t send as it should have, contact support with the campaign number and the expected time.

I set a schedule but the campaigns page marks it as “Sent”

If you accidentally selected “No” in the “Is this a scheduled send?” field, the campaign went out immediately. Check exactly when it went out in the send-date column. If it went out by mistake, there’s no way to recall messages that have already been sent.

Problems after sending

A large portion of the messages are in failed status

Several possible reasons, in order of frequency:

Incorrect phone number format. Numbers without a country code, with spaces, with special characters (-, *, #), or with an invalid number of digits will fail automatically. Check the format in the original Excel file.
Numbers that don’t use WhatsApp. Customer numbers not registered on WhatsApp will come back as failed with a “user not on WhatsApp” message.
Error 131026 (Message Undeliverable). The recipient receives messages from you, but this specific message didn’t get through. See the guide to fixing error 131026.
The business number was blocked. Recipients who blocked you in the past won’t receive the message and will come back as failed.

For details on reading the results and understanding the statuses, see Reading Campaign Results.

I sent a campaign to someone who didn’t ask for it

If a customer claims they didn’t consent to receive the message, you’re exposed to a spam report. Check:

How did the customer enter your database? Is there documentation of their consent?
Remove the customer from all lists immediately.
If the customer reported spam through WhatsApp, your quality rating may have been hurt. Check the Account Quality card on the main page.

Protection for the future: keep documentation of the consent source for every customer, and before large campaigns, verify that all customers genuinely gave valid consent.

The campaign went out, but customers complain they didn’t get a message

Check the per-recipient table in the campaign report. If the status is:

delivered but the customer says they didn’t receive it: their read receipts may be off, or the customer wants to avoid responding. The message did reach the device.
failed: the message didn’t arrive. Check the reason according to the previous section.
pending after a long time: there’s a sending problem. Check the business number’s status on the main page.

Someone wants to remove themselves from future campaigns

If a customer wants to stop receiving campaigns, there are a few ways:

Manual removal from distribution lists. Find the customer, edit their card, and remove them from all lists used for campaigns.
Tagging as Opted-Out. Create a list called “Opted Out” and move the customer to it. From now on, never include this list in any campaign.
Changing the status. Change the customer’s conversation status to “Not Relevant” or similar. This status filters the customer out of campaigns that segment by status.

Important: Meta requires businesses to have a clear opt-out mechanism that’s honored immediately. Keeping a customer who asked to be removed is a violation of the terms of service and can lead to a ban.

The campaign looks like it succeeded, but I didn’t get any replies back

Marketing campaigns tend to be one-directional. A response rate of 2-7% is considered reasonable, and a higher rate depends on a specific call to action.

If you wanted replies and the rate was zero, possible reasons:

The call to action wasn’t clear (“Get in touch” works less well than “Reply with the word YES”).
The value proposition was weak.
The campaign went out to an audience that’s no longer relevant (customers who haven’t purchased in years).

Preventing problems in future campaigns

Simple hygiene rules that prevent most problems:

Test before a large send. Always send the campaign to a small list of 5-10 internal recipients (agents, stakeholders), make sure the message arrives and looks right, and only then send to the full audience.
Set default values on customer cards. Missing fields create odd messages (“Hi ,”). A default value solves this.
Clean the list before sending. It’s worth removing numbers that haven’t responded in 6 months. Blocked customers, duplicates, and invalid numbers hurt your statistics and your quality rating.
Document consent. Keep the source for every customer: a CSV import with a date, a first conversation opened, a signup through a form on your website.
Stick to the correct category. A marketing message template mistakenly classified as Utility will be detected quickly by Meta and suspended. See Message Templates: The Complete Guide.
Smart timing. Use the “golden hour” data from previous campaigns to pick a time for the next one.

The bottom line

Most campaign problems can be avoided with five minutes of prep before sending: checking that the message template is approved, that the list is valid, that the variables are filled, and that the timing is right. When a problem does come up, the answer is almost always in the campaign report. The per-recipient status tells the full story, and the main page shows whether there’s an account-level problem. Invest a minute before and five minutes after, and most campaigns will work as planned.

Want to Use WhastApp API?

Campaign Troubleshooting: When Things Go Wrong and How to Fix Them

Mumble Team