WhatsApp API Errors and Fixes — WALoops Questions and Answers
WALoops
Chat with us

WhatsApp API Errors and Fixes

38 questions — direct answers, no fluff.

How do I check my WhatsApp account health in WALoops?

Open WhatsApp > Account in WALoops. The health card reads nine checks from Meta: Connection, Sending, Business verification, Business profile, Display name, Account review, Payment method, Quality rating, and Message limit. Results refresh every 30 minutes and each check has a button that opens the right page in Meta Business Suite to fix the problem.

More details arrow_forward

What is WhatsApp error 131026?

Error 131026 means WhatsApp accepted your request but could not deliver the message to that phone. The most common cause is a missing country code, such as saving a number without the 91 prefix for India. It can also happen if the recipient has not accepted WhatsApp's latest Terms of Service or is using an outdated app version.

More details arrow_forward

What is WhatsApp error 131042?

Error 131042 means Meta refused a paid template message because it could not collect payment from your WhatsApp Business account. Fix it by going to Billing and payments in Meta Business Suite, selecting the correct WhatsApp Business account, and adding or correcting the payment method or clearing any unpaid balance.

More details arrow_forward

What is WhatsApp error 131047?

Error 131047 means you sent a free-form message more than 24 hours after the customer last messaged you. The fix is to send an approved template instead. The 24-hour window starts from the customer's most recent message, not yours. When the customer replies to your template, a new window opens.

More details arrow_forward

What is WhatsApp error 131049?

Error 131049 means Meta chose not to deliver a marketing template to a specific recipient to protect them from too many messages. The message is not charged. Other recipients in the same campaign keep getting the message. Resending immediately is unlikely to work; include the customer in a later campaign days later.

More details arrow_forward

What is WhatsApp error 131053?

Error 131053 means WhatsApp could not download or use the media attached to your message. Common causes are an expired or private link, an unsupported file type such as HEIC, an oversized file, or a server blocking WhatsApp's download requests. Retrying with the same failing link gives the same result.

More details arrow_forward

Why can't I create a WhatsApp authentication template?

Error 2388185 usually affects new accounts trying to create an authentication template. Attach a payment method to the correct WhatsApp Business account in Meta Business Suite under Billing and payments, then get past the 250-a-day starting limit by verifying your business. Waiting for business verification alone or changing permissions does not fix it.

More details arrow_forward

Why was my WhatsApp display name rejected?

Meta rejects a display name when it cannot link the name to your business. Common reasons include the name not appearing on your website, using only generic words, using emoji or symbols, using all capitals, including a Meta brand name, or using a person's name only. Edit the name in WhatsApp Manager under Phone numbers and resubmit.

More details arrow_forward

How long does WhatsApp display name review take?

WhatsApp display name review takes 1 to 3 days. Messages can still be sent while the name is under review or rejected, but an unapproved name prevents the account from moving up the messaging limit tiers. Business verification often helps; many businesses get a rejected name approved by verifying first and resubmitting.

More details arrow_forward

What does a low WhatsApp quality rating mean?

A low quality rating means too many customers are blocking or reporting your messages in the last 7 days. It stops your messaging limit from growing and can get templates paused. Pause campaigns, identify the problem template in WhatsApp Manager, clean your list, and rewrite the message with your store name and an opt-out button.

More details arrow_forward

How do I fix a low WhatsApp quality rating?

Pause campaigns immediately, find the template causing blocks in WhatsApp Manager, clean your contact list, rewrite the message to include your store name and an opt-out button, then restart slowly with your best customers once the rating returns to green. The rating is based on the last 7 days and recovers within about a week.

More details arrow_forward

What does a restricted WhatsApp Business account mean?

A restricted account cannot start new conversations for a period. Customers can usually still message you and you can reply inside the 24-hour window. Restrictions are shown in Business Support Home in Meta Business Suite with the reason and an option to request a review. Switching to a different number does not help because the restriction follows the account.

More details arrow_forward

Can I send a WhatsApp OTP template on a new account?

New accounts may see error 2388185 when trying to create an authentication template; utility and marketing templates still work. To fix it, attach a payment method to the correct WhatsApp Business account and get past the 250-a-day limit by verifying your business. New accounts can also wait up to 24 hours for template review approval.

More details arrow_forward

How do I fix a WhatsApp number showing as Flagged?

Flagged means your quality rating has dropped to low. Sending still works during this period, but if quality does not improve within about 7 days Meta lowers your messaging limit. Pause marketing campaigns, identify the problem template in WhatsApp Manager, clean your list, and rewrite messages to include an opt-out option.

More details arrow_forward

Does WALoops show WhatsApp quality rating?

Yes. The WhatsApp quality rating in WALoops is shown as High, Medium, or Low on the WhatsApp page health card under WhatsApp > Account. On Medium it advises sending fewer marketing messages; on Low it advises pausing marketing. The rating is based on the last 7 days of customer feedback.

More details arrow_forward
arrow_back All question topics FAQ page
Join 500+ D2C Brands on WAloops

Try WALoops free for 7 days

Official WhatsApp Business API, Meta's own message rates, Shopify and WooCommerce automation.

✓ No credit card required   ✓ 7-day free trial   ✓ Cancel anytime