What This Playbook Is
If your business runs on WhatsApp, the worst thing that can happen is the moment your messages stop going out. It usually happens at the worst possible time, during a live campaign, mid-launch, or right before a busy weekend. You stare at the screen and ask: "is it my account, is it Meta, is it the credits, is it the card?"
This playbook gives you the short answer: it is almost always one of four things. Learn to spot which one, and you will fix most emergencies in minutes instead of days. The prevention checklist at the end stops most of them from happening in the first place.
This document is written so any owner or operator can follow it, no technical background required. Keep it bookmarked. Share it with whoever helps you run the account.
The Four Types of Message Delivery Issues
When messages fail to deliver, it is usually one of these four reasons. Diagnose which one, fix it fast.
Issue 1: Meta API Credit Card / Payment Issue
What is it? Meta charges a small fee for WhatsApp API conversations. Those fees are billed to the credit card linked inside your Meta Business Portfolio. If the card fails, the impact comes in two stages.
- Stage 1, card fails. Broadcasts and outbound template messages stop working. AI can still reply to incoming messages within the 24-hour conversation window.
- Stage 2, account disabled. If the balance remains unpaid, Meta will disable your WhatsApp Business account entirely.
Symptoms:
- Stage 1: Broadcasts fail to send, AI still replies to inbound messages.
- Stage 2: "WhatsApp Business account disabled" notice appears in Meta Business Manager.
How to diagnose:
- ABC Sales AI will show an error icon next to failed messages. Open the delivery log to see why they failed.
- Open your Meta Business Manager → WhatsApp Business Account settings.
- Click Billing & Payments in the left sidebar.
- Check for an outstanding balance, a failed payment, or an expired card.
How to fix: Clear any outstanding balance, replace the card if expired, and enable Meta auto top-up so the next payment never fails silently (see the Prevention Checklist below).
Issue 2: Rate Limiting (Healthy Ecosystem Enforcement)
What is it? Meta enforces messaging limits to keep WhatsApp a healthy ecosystem. If any single recipient receives too many marketing-category template messages in a short period (from anyone, not just you), Meta will throttle or temporarily block further outbound messages to that contact. A meaningful share of "why didn't this deliver?" cases trace to this.
Symptoms: Some messages deliver, some do not. Delivery rate drops gradually. You may see a "maintain healthy ecosystem" warning in your ABC dashboard.
How to reduce risk:
- Use Utility templates instead of Marketing templates whenever possible. Utility templates (appointment reminders, order updates, payment confirmations) have much higher delivery limits.
- Write your message so it qualifies as Utility, not Marketing. The difference: utility messages relate to an existing transaction or request the customer made. Marketing messages promote or sell.
- Spread Marketing templates out over time. As a rule of thumb, try not to send two marketing messages to the same contact within 24 hours of each other. Bursty sends are the fastest way to trigger throttling.
Issue 3: ABC Sales AI Subscription or Message Credits Depleted
What is it? Your ABC Sales AI subscription is a separate payment from the Meta API fees. ABC also runs on a credit system, your plan includes a generous monthly allowance of outgoing messages that fall outside the 24-hour conversation window. Messages sent within 24 hours of a customer's last message are free. If your subscription fails or your credit balance runs out, all outgoing messages stop.
Symptoms: All outgoing messages stop, AI replies, broadcasts, everything. Incoming messages still arrive normally, but nothing leaves the account.
How to fix: Open your ABC Sales AI billing dashboard, confirm the subscription is current and the payment method is valid, and clear any outstanding balance. If your credits are exhausted, top up. We strongly recommend enabling auto top-up so the system never stops mid-conversation.
Important: there are THREE separate things to maintain. All three must be active and funded for end-to-end delivery to work.
| Payment | What It Covers | Auto Top-Up? |
|---|---|---|
| ABC Sales AI Subscription | The AI software, automations, dashboard | Ensure card on file is valid |
| ABC Sales AI Message Credits | Outgoing messages outside the 24-hour conversation window | Enable auto top-up |
| Meta WhatsApp API Fees | Per-conversation delivery fees charged by Meta. Messages within 24 hours of the customer's last reply are free. | Enable auto top-up |
Issue 4: Account Quality / Phone Number Suspension
What is it? If too many recipients report your messages as spam or block your number, Meta lowers your quality rating, restricts your messaging tier, or in severe cases suspends the phone number entirely.
Symptoms: Quality rating drops to "Low" in WhatsApp Manager. Messaging tier downgrades. In severe cases, the number is flagged or suspended outright.
Common causes:
- Recipients do not recognise your number and block it
- Messages are sent too frequently, recipients feel spammed
- Unsolicited marketing sent to people who did not opt in
How to prevent:
- Send a confirmation message via WhatsApp immediately after someone opts in, while you are still fresh in their memory.
- Only message people who have actually interacted with you or explicitly opted in.
- Do not repeatedly blast the same message to the same contacts.
- Encourage inbound replies wherever you can, two-way conversations boost your number's health.
Prevention Checklist (Do This Now)
Complete every item below to prevent future emergencies.
- Pay any outstanding Meta API balance and verify the linked card has at least 12 months to expiry.
- Add a backup card to Meta Business Portfolio so the next failed charge does not become a disabled account.
- Enable Meta Auto Top-Up (Meta Business Portfolio → Billing & Payments → Payment Settings → Auto Top-Up).
- Verify your ABC Sales AI subscription payment method is active and current.
- Check your ABC Sales AI message credits balance.
- Enable Auto Top-Up for ABC Sales AI message credits so AI never stops mid-conversation.
- Save the ABC Sales AI support contact in your phone so you can reach help fast.
- Bookmark your direct WhatsApp Business Account settings URL inside Meta Business Manager for fast access during incidents.
- Document who owns the account, who owns the card, and who responds to billing alerts. Keep that document somewhere both the business owner and a backup person can access.
- Once a month, sanity-check that all three payment surfaces (Meta card, ABC subscription, ABC credits) are healthy. A two-minute monthly check prevents a two-day outage.
Quick Diagnosis Guide
When messages are not delivering, follow this flowchart. Most cases get solved in under 5 minutes.
Step 1: Check Meta Billing
- Open Meta Business Manager → WhatsApp Business Account → Billing & Payments.
- Is there an outstanding balance or a failed payment?
If YES, pay the balance and update the card. This is Issue 1.
If NO, continue to Step 2.
Step 2: Check ABC Sales AI Subscription & Message Credits
- Log in to your ABC Sales AI dashboard.
- Confirm the subscription is active and the payment method is current.
- Confirm message credits are not exhausted.
If PAYMENT FAILED or CREDITS DEPLETED, update the card, clear the balance, or top up credits. This is Issue 3.
If ACTIVE & CREDITS OK, continue to Step 3.
Step 3: Check WhatsApp Manager Quality
- Open WhatsApp Manager → Phone Numbers.
- Check your Quality Rating and Messaging Tier.
If QUALITY LOW or NUMBER RESTRICTED, stop sending new broadcasts and wait for health to recover. Inbound leads are fine, in fact encouraged, as inbound two-way conversation boosts your number's health.
If QUALITY OK, continue to Step 4.
Step 4: Check the Error Code
When a message fails to send, ABC Sales AI shows an error code next to it. Use it:
- Take a screenshot of the failed message and the error code.
- Search the error code on Google (e.g. "WhatsApp API error 131047") to understand what it means.
- If you still cannot resolve it, send the screenshot and error code to ABC Sales AI support. They will help you diagnose it.
General rule: an error code is information, not a wall. Almost every WhatsApp API error has a publicly documented cause and fix. The error code is the fastest path to that fix.
A Strategic Note on Rate 2 vs Marketing Templates
The single highest-leverage move most operators can make is to shift as many of their template messages as possible from Marketing category to Utility category. This is not just about delivery limits, utility messages are also less likely to feel like spam to the recipient, which protects your quality rating long-term.
A useful mental model: ask yourself "does this message relate to something the customer has already asked for, ordered, booked, or agreed to?" If yes, you can usually frame it as Utility. If no (it is a fresh offer, promo, or campaign push to a non-active customer), it is Marketing, and you should treat its frequency with respect.
Who to Call When It Is Urgent
If messages have completely stopped during a live campaign or event, do not wait for an email response. Use the channels in this order:
- ABC Sales AI Support WhatsApp. This is your first call for all issues (billing, technical, AI, delivery). Text for normal issues, call for urgent. There is an AI configured to answer immediately, so you should get a useful first response within seconds.
- If no response, escalate. Reach out to your assigned AIS Expert (on partner plans) or to the named escalation contact you were given during onboarding.
Keep both contacts saved in your phone before you need them. The wrong time to look for support contacts is during an outage.
The Whole Framework in One Sentence
If you only remember one thing, remember this:
Three payments must stay healthy (Meta card, ABC subscription, ABC credits). One score must stay high (quality rating). Auto top-up handles the first three. Sending mostly Utility templates and respecting opt-in protects the last one.
That is the entire account-health discipline in one sentence. The rest of this playbook is the diagnosis tree for when something goes wrong anyway.
