WhatsApp Failed Message Auto-Retry
Introduction
When you send a WhatsApp campaign, Meta applies frequency capping limits that restrict how many marketing messages a customer can receive in a given period. If a customer has already reached that limit, your message is rejected with the reason “Frequency capping limit reached” — even though the number is valid, the customer has opted in, and your template is approved.
These failures are temporary. The same customer can usually receive the message a few hours later, once their cap resets. Failed Message Auto-Retry takes advantage of that: enable it on a campaign and AiTrillion automatically attempts delivery again, at intervals you choose, without you having to watch your reports and resend by hand.
This article shows you how to turn Auto-Retry on when creating a campaign, how to set the retry intervals, and how to confirm from the campaign message logs that retries actually ran.
How Auto-Retry Works
· Enabled per campaign — Auto-Retry is switched on per campaign, while you are creating it. It is not an account-wide setting.
· Capping failures only — only messages that failed because of Meta frequency capping limits are retried. No other failure type is eligible.
· Maximum of two attempts — AiTrillion makes at most two retry attempts per failed message, so a message is never retried indefinitely.
· Intervals you control — you set the first and second retry intervals yourself, in hours.
·
Fully tracked —
the retry count and the last failure reason appear in the campaign message
logs.
Note: Auto-Retry is deliberately limited to frequency capping failures. A message that failed because the number is not on WhatsApp, because the customer opted out, or because the template was rejected will fail again on every attempt — retrying it would waste your send volume without improving delivery.
Before You Begin
· Your WhatsApp Business API account must be approved and connected to AiTrillion.
· You need at least one approved WhatsApp template.
·
You need enough
message credits to cover the retries as well as the original send
Step 1: Start Creating a WhatsApp Campaign
Figure 1: Expand WhatsApp Marketing and
open Campaigns.
Figure 2: Click Create campaign in the top-right corner.
The campaign builder is laid out in three columns. Work through the first two before reaching the Auto-Retry setting:
1. Template selection — choose the approved template you want to send.
2. Preview — check how the message will appear on the customer’s phone.
3. Campaign details — enter a campaign name, choose your target audience, and set when to send.
In the Campaign details column, scroll below When to send to the Retry failed messages section, then:
4. Switch on Auto-Retry messages failed due to meta capping limits.
5. Set First retry after (hours) — how long to wait before the first retry.
6. Set Second retry
after (hours) — how long to wait before the second and final retry.
Figure 3: The campaign builder, with the Retry failed messages panel and the Auto-Retry toggle switched on.
Both intervals default to 24 hours. That is a sensible starting point, because Meta’s frequency caps are measured over a rolling period and a short gap is unlikely to find the customer’s limit reset. Waiting a full day before each attempt gives the cap time to clear.
Note: Set the intervals with your campaign’s timing in mind. If you are promoting a sale that ends in 24 hours, a second retry 48 hours after the original send will reach the customer after the offer has expired. Shorten the intervals, or accept that late retries may not be worth sending.
Step 4: Send the Campaign
Click Send now to launch the campaign, or choose Schedule for later if you set a future send time. Auto-Retry applies to the messages in this campaign only.
Step 5: Check Retry Activity in the Message Logs
Once the campaign has run, open its report to see what happened. The summary tiles across the top give you the headline numbers — Total Sent, Pending, Delivered, Read, Clicked, Replied, and Failed — and the message log below lists every individual message.
Two columns tell you how Auto-Retry performed:
· Retry attempt — how many retry attempts have been made for that message. A value of 0 means the message was never retried; 1 or 2 means Auto-Retry has acted on it.
·
Last failure reason —
the reason the most recent attempt failed. For retried messages this reads
“Frequency capping limit reached”.
Figure 4: The campaign report - the Failed tile, and the Retry attempt and Last failure reason columns in the message log.
Note: Customer names and phone numbers have been blurred in the screenshot above for privacy. Your own message log will show them in full.
Reading the Results
Retry attempt 0 with no failure reason
The message was delivered on the first attempt. Nothing to do.
Retry attempt 1 or 2, status now Delivered
Auto-Retry worked exactly as intended — the message failed on capping, was tried again, and reached the customer. These are deliveries you would have lost without the feature.
Retry attempt 2, status still Failed
Both retries were used and the customer was still capped. No further attempts will be made. If this happens across a large share of your audience, you are messaging the same customers too frequently — reduce your WhatsApp send frequency rather than lengthening the retries.
Status Failed with a reason other than capping
These messages are not eligible for Auto-Retry and show a Retry attempt of 0. Address the underlying cause: remove numbers that are not on WhatsApp, respect opt-outs, and fix any template that Meta has rejected or paused.
Important Notes
Note: Auto-Retry must be enabled on each campaign individually. It does not carry over from one campaign to the next, and there is no account-wide setting that turns it on by default.
Note: Only frequency capping failures are retried. Every other failure type is left alone by design.
Note: A maximum of two retry attempts are made per message. There is no way to raise this limit.
Note: Each retry consumes message credits in the same way as the original send. A campaign using both retries can cost up to three times the credits for the messages that keep failing.
Note: Retries are not instant. The message goes out after the interval you configured, so a time-sensitive offer may arrive after it is still useful.
Troubleshooting
The Retry failed messages section is not visible
It sits at the bottom of the Campaign details column, below When to send. Scroll down within that column. If the section still does not appear, confirm your WhatsApp Business API account is connected.
Auto-Retry is on but Retry attempt stays at 0
Check the Last failure reason. Auto-Retry only acts on “Frequency capping limit reached”. Any other reason leaves the count at 0. Also confirm that enough time has passed — with a 24-hour first interval, nothing will happen on the day of the send.
Retries ran but the messages still failed
The customers were still within their capping window on both attempts. This usually means your audience is receiving WhatsApp messages too often. Space your campaigns further apart or narrow your target audience.
Next ⏭️
· Test a WhatsApp Message Before Sending
· Create a WhatsApp message template using the WhatsApp provider Wati
More Helpful Articles
· Integrate the WhatsApp provider Wati with AiTrillion to send WhatsApp messages to customers
· Request for WhatsApp Business API for Workflows and Campaigns
· Subscribe and obtain consent for Email, SMS, WhatsApp marketing during newsletter popup signup