By connecting WhatsApp Cloud API with 
iClosed, every text conversation, customer reply, and media file maps instantly under the Contact Journey in iClosed.
This way, sales reps can easily keep all communication in one place and ensuring no follow-up is ever missed.
Integration is available with Growth and Business subscription plans - check out full breakdown here.
The phone number linked to your WhatsApp Cloud API container cannot be logged into a standard or business mobile app at the same time.
Meta caps your unique daily outreach limits based on account verification records and automated flag health. New numbers typically debut at Tier 1 (1,000 unique target recipients per rolling 24-hour cycle).
Meta requires you to use pre-approved structures called Templates.
Step-By-Step Guide
Navigate to All Integrations ➔ WhatsApp Cloud API and click on the Integrate button to initialize the setup modal.
Integration super simple and takes two steps:
Connection → Login with Facebook and business account selection
Post-connection configuration
Step 1 - Connecting Meta Business Account
iClosed utilizes Meta's native embedded Signup flow for an automated, secure data handshake:
Click the blue Login with Facebook button inside the popup wizard and enter the Facebook account credentials holding full Admin ownership over your company's Meta Business account
Authorize access to your WhatsApp Business Account (WABA) account
We'll automatically capture your phone number ID and WABA ID for you to register
Select your WhatsApp Business account to connect
Click Connect to finish integration
The page will refresh and display a green checkmark confirming that the account is Connected next to your designated number.
Step 2 - Post-Connection Configuration
Once the integration is finished, you will access additional configuration options, separated into two tabs:
Configuration - Create chats for non-contacts
Templates - Creating Templates for automated outreach to leads
Configuration - Create chats for non-contacts
When ON (Highly Recommended)
Any time an unrecognized user messages your phone line, iClosed automatically maps their profile fields into a fresh contact card and spins up a live chat ticket inside your Unified Inbox.
When OFF
Unrecognized incoming user threads are ignored by the incoming routing pipeline.
Remember to hit Save Changes once you make changes in the configuration.
Templates - Creating Templates for automated outreach to leads
Unlike standard text messages, you cannot send arbitrary free-form texts to a customer over the WhatsApp Business API if you are initiating the contact or reaching out after 24 hours.
Instead, Meta requires you to use pre-approved structures called Templates. Meta enforces an approval process for two major reasons:
To eliminate spam:
WhatsApp’s global appeal is built on user trust.
By requiring businesses to register their message frameworks, Meta prevents companies from blasting automated, generic spam or buying cold numbers to mass-text random users.
To enforce correct billing categories:
Meta charges different delivery rates depending on what the message is about (Marketing, Utility, or Authentication).
Forcing templates through an approval process ensures businesses are billed correctly (e.g., preventing you from hiding a promotional sale inside a cheaper "shipping update" template).
If a customer messages your business line first, it means that a lead has opted in and the service window will open. For the next 24 hours, you can text back and forth freely without any templates or restrictions.
Pro Tips
WhatsApp Business channel will be available for Inbox Automations as well, but without the option to write a message as it's available for any other channel.
Instead, you will be able to choose a previously approved template.
Disconnecting WhatsApp Business Integration
Should you ever need to migrate your active business number configurations or link a different Meta asset path:
Click the red Delete Channel button located on the top right
Confirm your action in the pop-up warning modal
Important Notes
What happens when you disconnect the channel
All previously synchronized message strings and media logs remain perfectly safe inside your contact journeys - no customer records are deleted.
Your dashboard will instantly lose the ability to fetch incoming service messages or dispatch outbound text responses through this line.
Automated workflow action cards tied to this WhatsApp pipeline will hit a processing pause state until a replacement communication channel is selected.
WhatsApp Business Templates
Templates are only strictly required when you initiate a conversation with a lead, or when you reply to a lead after the 24-hour window has completely closed.
Sender will be defined by your Meta Business account settings.
Template Approval Process
Click on the "Submit template" button and new window will open:
Create template by completing following steps:
Template name
Add a name to your template, not just something that will be easily recognizable to your team members but also for the Meta team to understand better as their naming engine is very rigid.
Spaces and capital letters are not allowed, as the system will reject the template before it even goes to review.
But do not worry, we got you covered. We've prevented entering text in caps, and with every space added to the template name, we will automatically place underscore "_" instead.
Pro Tips
Organize your names by their function - e.g. [category]_[specific_intent]_[version]
Always Include a Version Number - e.g. (_v1, _v2)
Update template - don't delete
If you delete a template, Meta locks that exact template name.
You cannot reuse that specific name string for the next 30 days.
Updating the template will resubmit the template for approval process - make sure to add version at the end
Category
iClosed provides both user engaging template categories:
Marketing
Utility
The 3rd template category Meta provides, Authentication template, is not included as it's exclusively used for sending 2-Factor Authentication (2FA) tokens or security pin codes.
Important Notes
Meta has strict enforcement policy regarding Utility vs. Marketing content:
Don't try to tag a promotional text as a "Utility" message to secure the cheaper rate as Meta has completely closed this loophole using real-time AI scanning tools.
If you submit a template as a Utility message, but Meta’s AI detects even a single marketing hook, an enthusiastic exclamation, or an upsell link, Meta will automatically approve the template but force change its category to Marketing.
You won't get a warning block, and the message will be sent and billed as per higher marketing rate, which can cause unexpected spikes in your iClosed credit usage.
Marketing Templates
Marketing templates cover any message designed to build awareness, drive sales, or re-engage a contact. By default, Meta classifies any template that doesn't strictly fit into Utility or Authentication as Marketing.
Best used for: Promotional offers, discount codes, product launches, abandoned cart reminders, or friendly sales follow-ups to cold leads.
The Tone: Warm, enthusiastic, or persuasive.
Cost: Highest rate tier.
Utility Templates
Utility templates are strict, non-promotional messages triggered by a user's action or an explicit update regarding their account.
Best used for: Order confirmations, shipping tracking numbers, appointment confirmations, billing invoices, or follow-up feedback forms directly related to a recent call.
The Tone: Factual, dry, and neutral.
Cost: Very low (roughly 80% to 90% cheaper than Marketing messages).
Pro Tips
To prevent Meta from overriding your templates and charging you per marketing prices, follow these best practices for Utility messages:
Remove All Promotional Keywords: Avoid sales-heavy words like offer, discount, gift, exclusive, coupon, or special choice.
Include a Direct Transaction Reference: To prove to Meta that the text is transactional, always anchor the body text with a hard identifier variable, like an Order ID, Booking Reference, or Invoice Number (e.g., "Your appointment for reference {{1}} has been confirmed").
Banish Upsells and Cross-Sells: Do not add secondary pitches. For example, writing "Your order has shipped! By the way, check out our new arrivals here..." will instantly trigger a marketing reclassification.
Keep the message strictly about the single action the user took.Keep Links Neutral: If you use call-to-action buttons, ensure the destination URL points to a dead-intent tracking page, account dashboard, or help document - never to a product catalogue, sign-up offer, or homepage.
Language
When creating a new WhatsApp template, you must specify its native language. This ensures Meta processes the template under the correct regional rules and displays special characters properly.
As shown in the template creation drawer, your iClosed dashboard natively supports direct dropdown selection for major global sales languages:
English
Spanish
French
German
The most critical thing your team needs to know about languages is that Meta does not automatically translate your templates. If there's any discrepancy, Meta's automated AI scanner will flag the contradiction and reject the template instantly.
Pro Tips
Multi-language templates will be rejected - If you have a multilingual audience, you must submit a separate template for each language, using a clear naming convention to tell them apart.
Grammar - make sure the surrounding text naturally matches the target language's sentence structure and grammar rules.
Keep emojis universally appropriate - While emojis work across all language settings, certain symbols carry different cultural meanings depending on the country. Keep your emoji choices neutral and professional.
Special accents - When typing in French (
é,ç,à), Spanish (ñ,¿,í), or German umlauts (ä,ö,ü), type them out fully and cleanly within the message body. Meta's system handles these perfectly as long as the correct language option is selected from the dropdown menu first.
Message body
The Message body is the primary text of your template. This is the actual message your leads and customers will read on their phones when you initiate outreach.
You'll be adding the message in the composer on the left while you will be able to see the preview of the message on the right.
To ensure your template passes Meta's automated AI screening on the first try, the iClosed text composer enforces a clean, distraction-free environment with specific structural rules:
The text box is explicitly built for plain text entry. You cannot paste rich text formatting, custom HTML, or complex external code snippets into the canvas.
DOUBLECHECK
All bolding, italics, or strikethroughs should rely strictly on native WhatsApp markdown punctuation (like wrapping a word in asterisks*like this*to make it bold).Message Composer is doesn't support dynamic variables as Meta insists on seeing your complete, exact message block before approving it.
Your entire message body copy cannot exceed Meta's rigid limit of 1,024 characters.
You can freely add emojis directly into your text stream to make your copy feel warm and approachable. Just remember that Meta's system automatically flags and rejects message frames containing more than 10 emojis.
Additional options available are Undo button for instant step backward and restoring your previous text state and Redo button for instant re-apply of the latest text changes.
Pro Tips
As the message body is strictly limited to flat text and emojis, you can include images, media files, or clickable hyperlinks with additional layout options.
If you want to include an eye-catching image, attach a resource document, or add quick-action links to your message, use the Header, Footer, and Button features explained in the article sections below.
Message Header, Message Footer, and Buttons
To make your static broadcasts highly engaging, you can activate optional formatting containers below the main message body.
Message Header
The Header acts as the visual anchor of your message, appearing in bold font directly above your main message body text block.
When you check Message header, you can select one of four types from the dropdown menu to match your campaign style:
Text - Enter a static, punchy heading line (up to 60 characters maximum) to immediately summarize your broadcast intent.
Image - Upload a clear, high-quality image format (JPEG or PNG) to display product imagery, brand logos, or visual reminders at the very top of the smartphone screen.
Video - Attach an MP4 video file to provide rich sales teasers or platform walk-throughs natively inside the chat thread.
Document - Attach an enterprise-grade PDF file, such as a price book, contract draft, or a free promotional business blueprint download.
Message Footer
The Footer places a subtle, clean row of micro-text directly below the main message body.
The footer supports clean text inputs up to a maximum length of 60 characters.
Emojis and variables are not allowed in the footer text area by Meta.
Footer is best used for professional legal sign-offs, company copyright tags, or helpful brand taglines.
Buttons
Activating Buttons adds interactive tap-to-execute elements to the very bottom of your WhatsApp block.
You can build up to 10 custom buttons to drive micro-conversions and If your layout features more than three buttons, they will automatically bundle neatly into an on-screen customer list modal.
Click the "+ Add button" to select from four powerful, hard-coded actions:
Quick Reply - A quick-response bubble containing preset text (e.g., "I'm interested!" or "Talk to an agent"). When clicked, it automatically types and fires that message text back to your team, opening up the live conversation.
Visit website - Directs the user instantly to a designated link. Unlike standard body links, this renders as a highly professional web button to drive traffic to your calendar page or landing view safely.
Call Phone Number - Instantly triggers a dialer on your phone to call your specific office sales desk or support line when tapped.
Copy offer code - Adds a one-tap copy shortcut string to the user's mobile clipboard (e.g., a special checkout code or reference ID), making it seamless for them to paste the asset during checkouts.
Button cap of 25 characters is the absolute maximum limit allowed by Meta for a button label.
Pro Tips
WhatsApp interactive buttons solve friction by allowing leads to trigger instant actions with a single tap natively inside the chat thread. Here're few tips:
Use direct commands starting with clear, action-oriented verbs (like
Book Free CallorClaim Blueprint) to capitalize on the tight 25-character maximum limit.Use a Custom Reply button labeled with an easy, positive action step (like
Reply back to get blueprintorSend me the code). This gives cold leads a frictionless, single-tap way to opt into the conversation.Stick to one unified logical next step per broadcast template rather than stacking scattered calls-to-action, as clean layouts with single-button focuses consistently capture higher click-through rates.
Template Review and Pending State
Once you hit submit inside the iClosed template builder, your template is instantly sent to Meta’s global operations network for official compliance screening.
Every single template must be explicitly authorized by Meta before your team can blast it out to your lead pipelines. Until the template is approved, it will show on the Templates section in "Pending" status.
Here's what you should know on the review process:
Meta uses a combination of automated AI language models and rapid human moderation to check your copy for spammy text patterns, appropriate category tagging, and formatting violations.
While Meta officially states that approvals can take anywhere from a few minutes up to 24 hours, the vast majority of clean, compliant static templates submitted through iClosed are fully approved within less than 10 minutes.
If a template contains borderline language, it is routed for a human manual review, which can take anywhere from 24 to 48 hours.
Once the template is approved, the status on the Templates section will change to green "Approved" and you will be able to use it from that moment on.
Pro Tips
You can edit a template that was already approved, but keep in mind that saving any update triggers a brand-new review process.
While Meta reviews your new changes, the template is locked. Your team cannot use it for live messages or automated workflows until it gets approved again.
If your sales team needs that template right now, don’t edit it.
Instead, create a copy as a brand-new template draft. This keeps your original message active and working on the sales floor while your new version waits for approval in the background.
Template Rejection Reasons
If your template returned a "Rejected" status, it is almost always due to one of these rigid formatting rules:
Miscategorization - If you label a template as a transaction-based Utility message, but the text includes persuasive marketing hooks or a discount code, Meta will either reject the submission or automatically override your selection and force it into the higher-priced Marketing category.
URL Shorteners - Meta explicitly blocks hidden tracking links like
bit.lyortinyurlto prevent phishing. Its advisable to use full, secure, brandedhttps://yourdomain.comweb links.Strict Character or Emoji Overuse - Formatting rules automatically reject any template body that exceeds 1,024 characters, uses more than 10 emojis, or contains more than 4 consecutive blank spaces or lines.
DOUBLECHECK
iClosed will show you rejection reason OR NOT
Messaging Costs and Conversation Cap
Your monthly active conversation allowance and chat history retention scale directly with your subscription tier.
Channels like WhatsApp Private or WhasApp Business are exclusively available on the Growth and Business tiers. Your monthly active conversation limits (300 on Growth / 1,000 on Business) and history retention lengths are determined strictly by your active plan.
A conversation is counted as active once it registers messaging activity within that calendar month.
Closing or deleting a chat will not lower your count for the current month. Once a contact messages you (or you message them) and uses up one of your monthly slots (e.g., 300 on Growth or 1,000 on Business), that slot is locked in until the counter resets next month.
It does not operate like a phone line where you can just hang up on one person to talk to another. It tracks the total unique volume of conversations handled across the entire month and rollover of unused converstations is not available.
Extra monthly conversations available upon inquiry to the support team.
How to Use WhatsApp Business Inside the Composer
Once connected, executing a WhatsApp message inside the live feed takes moments:
Open any lead thread inside the Unified Inbox.
Look at the selector tabs at the top or bottom of your Smart Message Composer.
Select Whatsapp Cloud API as your active channel.
Type in messsage, or use your
#shortcut to pull up a high-converting message preset or predefined Whatsapp templates.Press Send
Pro Tips
When a lead or customer messages your business, they open a strict 24-hour timer. During this window, your team is allowed to send free-form, casual chat messages (like standard text, voice notes, or quick replies).
But when this window expires, and a lead doesn't reply back, Meta will be forcing you to use a pre-approved templates, to ensure your re-engagement messages remains professional, structured, and compliant with Meta's anti-spam guidelines.
Troubleshooting and WhatsApp Error Codes
Managing the WhatsApp Business API requires navigating strict rate limits, template guidelines, and authentication rules. The API relies on specific error codes to indicate when a request has failed.
The following details a comprehensive list of WhatsApp API error codes, categorized in relevant buckets and with suggested troubleshooting steps. WhatsApp also lists a set of technical error codes for their cloud API service here.
Error Codes
Error Codes
Authorization Errors
Auth errors occur when the WhatsApp API system cannot verify the credentials or permissions of the user or application making requests.
Code | Description | Possible Solution |
0 | AuthException Meta is not able to authenticate the application user: Expired token changed access to data could be possible reasons . | Re-verify the app permissions or generate the access token here or check with your Solution Provider on the steps. |
3 | API Method Lack of necessary permissions to perform the API call or a misconfigured API call | Review API configuration or regenerate the access token. Contact your solution provider if using one. |
10 | Permission Denied Insufficient permissions to your application are not given,n or the access has been removed. Unapproved Phone Number: The phone number is not approved or allowed listed for the WhatsApp API account |
Re-verify the API token for necessary app permission here. Refer to your solution provider for the necessary steps if you are using one.Check that the phone number is properly registered and approved in your WhatsApp Business Account. Complete registration and approval if not done by your solution provider |
190 | Permission Denied The access token has expired, and access to the API is blocked | Obtain a new access token for the relevant app to ensure all permissions are taken. Your solution provider can guide you on the steps. |
200-299 | API Permission Errors Permission missing or revoked: Access to specific API features restricted | Verify the API token for obtaining the necessary app permission here. Refer to your Solution Provider for necessary steps if using their solution. |
Throttling Errors
When your application exceeds the allocated API call rate limit designated for your account.
Code | Description | Possible Solution |
4 | API has too many calls The application has exceeded the rate limit of API calls | Proactively monitor and optimize your API call rates. Proactively plan for API rate limit handling |
80007 | Rate limit issues WhatsApp API account reached its rate limit | Try later again or reduce #API Calls. |
130429 | Rate limit hit The message throughput limit has been breached. | You need to reduce the frequency at which messages are being sent, or you can retry again later |
131048 | Spam rate limit hit This is possible due to message volume restrictions on the phone number in the API account. This could be due to the previous history of spam flagging and messages being blocked by the recipient. | Check quality status in WhatsApp Manager and reduce message frequency. |
131056 | Pair rate limit hit A high number of messages in a short span of time that is sent from the sender’s phone number to a recipient with a particular phone number. | Wait and retry sending messages to the same recipient’s phone number. Sending messages to other phone numbers is not restricted.
|
133016 | Phone number register/deregister limit breached WhatsApp limits #attempts to register or deregister to 10 in a 72-hour window | Wait for a while and try again after the blocked 72-hour window. |
Integrity Errors
This is related to a WhatsApp Platform policy violation that temporarily restricted certain actions for the business account.
Code | Description | Possible Solution |
368 | Temporarily Blocking due to policy violations The WhatsApp Business Account associated is restricted or blocked for violating a platform policy. | Review WhatsApp policies to understand and resolve violations, or consult your WhatsApp solution provider for resolution. |
130497 | Messaging restrictions in some countries: The WhatsApp Business Account is prohibited from messaging users in specific countries due to category restrictions or local policy | Check WhatsApp Geography and country-wise messaging restriction policy here. Consult WhatsApp support or solution provider for more details. |
131031 | Account Locked WhatsApp Business Account is restricted or completely disabled for violating the platform or commerce policy. It could be due to insufficient verification of messaging content or data. | Check messaging health guidelines or platform policy around spam enforcement. |
Message Template Errors
Issues related to the predefined structured message templates due to factors such as policy violation, prohibited content, rate limit, or formatting issues.
Code | Description | Possible Solution |
132000 | Template Param Count Mismatch The number of variable parameters in the message does not match the defined variable in the approved template | Review the message and refer to the template guidelines, ensuring all variable parameters are defined |
132001 | The template does not exist Either the template is not Approved, or it does not exist in the specific language. | Ensure that the message template is approved and the message name and language locale are correct. For more details, check details on the messaging template policy |
132005 | Translated Template exceeds the character limit Interactive templates with all the buttons, quick replies, and other string characters exceed the limits when translated. | Review the template content, simplify and reduce the character limit, and preferably use concise content. Review the template status for more action. |
132007 | Template Format Policy Violation The error occurs if the content includes non-supported characters, incorrect formatting, or other elements that do not comply with WhatsApp's guidelines. | Review the rejection reason and edit the template content again. |
132012 | Template parameter format mismatch Sending incorrect parameters (like image instead of video) in the template message that don’t match with the approved template format. | Ensure template parameters match the approved template format. Take the help of your WhatsApp solution provider if needed. |
132015 | Template Paused The Template has been paused due to poor quality rating, and the API account cannot send such template messages to their users. | Edit the template, improve the quality, and then try sending it again.
|
132016
| Template Disabled If the template has been paused multiple times due to low quality, WhatsApp has disabled it. | It is suggested to create a new template, make changes in the content, and ensure quality content. |
Message Delivery Error
This relates to the failure of message delivery to the recipient due to content, configuration, or recipient-side issues.
Code | Description | Possible Solution |
131026 | Message Undeliverable Reasons could be -No Valid WhatsApp Number of the recipient -Recipient using an older version of the WhatsApp app -Recipient has not accepted WhatsApp new terms of service and privacy policy | The recipient has to accept WhatsApp T&Cs for service, register a WhatsApp account, or update the app version. |
131047 | Re-engagement Message Over 24 hours have passed since the recipient’s last reply. | Use a business-initiated message template to start a fresh conversation with the user again. |
131049 | Meta did not deliver the message Meta chose not to deliver the message to maintain healthy ecosystem engagement.
| This may be due to the per-user marketing message limit (read more details here). Retry after a certain time period. |
131051 | Unsupported message type Trying to send messages with a template format (media or other payload) not supported by WhatsApp. | Check supported message types in WhatsApp documentation. |
Media Errors
Errors in handling media files
Code | Description | Possible Solution |
131052 | Media download error WhatsApp is unable to download media included in the WhatsApp user's message. | It is suggested that the user is requested to send the media file on a channel other than WhatsApp. |
131053 | Media Upload Error WhatsApp was not able to upload the media for reasons such as
| Check the list of media file formats supported by WhatsApp |
WhatsApp Flows error
Issues related to the WhatsApp Flows feature
Code | Description | Possible Solution |
100 | A possible reason could be one of the many encountered during flow management
| Provide a valid and unique name, and confirm the specific ID, and valid URL as applied. Read more about Flows specific error handling |
139000 | Block by IntegrityWhatsApp may have identified integrity issues with the Business Account preventing the creation or publishing of your flows | Contact Whatsapp support or your solution provider for resolution. |
139001 | Flows cannot be updated Attempts to update the flows after publishing are not possible and will give you this error. |
Clone the Flow, update the flow, and republish it. Use the new flow instead of the older one. |
139002 | Publishing Flows with incomplete details Publishing of flows with incomplete or improper details will result in this error. The reason could be one of the many
|
Identify the missing details in the flows. Add the relevant details using the appropriate solution and then try publishing again. |
139003 | Deprecating a Flow Error encountered while attempting to deprecate a flow could be due to the below reasons
| Refer to this guide on deprecating a flow |
139004 | Cannot Delete a Published Flow Error while deleting a published flow as this is not allowed | |
139006 | Flows Metrics Threshold There is not enough data to provide flow metrics | Wait for enough data in the flows to create metrics |
132068 | Flow Blocked Execution of the Whatsapp flows is blocked due to policy violations or user reports. | Review the flow and check for policy violations or excessive user reports. |
132069 | Flow throttled A specific WhatsApp flow has been temporarily limited in its ability to process messages, as 10 messages have already been sent in 1 hour | Monitor flow performance and correct the flow. Get assistance from WhatsApp support or your solution provider. |
Other Miscellaneous Errors
Here's the list of other errors that don't fit in any of the buckets above:
Code | Description | Possible Solution |
131000 | Something went wrong Message sending failed due to an unknown error | Retry the request or contact support. Engage your WhatsApp Solution Provider if needed |
131005 | Access Denied WhatsApp has not given permission or revoked it
| Try troubleshooting using this guide. |
131008 | The required parameter is missing:
| See the endpoint's reference to determine which parameters are required.
|
131009 | Parameter Value is invalid | Provide only supported parameters. Refer to this for reviewing the supported parameter types. |
131016 | Service Unavailable A WhatsApp service is temporarily unavailable | Contact your WhatsApp Solution Provider for more details or try to check the status of your WhatsApp Business Platform Status here |
131021 | The recipient cannot be the sender The sender and recipient have the same number | Use different numbers to send the message |
131037 | Display Name Missing An approved display name in the WhatsApp API is needed to send messages. Message cannot be sent if the display name is not approved | Try changing the display name and getting to approved using this guide |
131042 | Business Eligibility Payment Issue This was an error in the payment method linked to your WhatsApp Business Account. Possible reasons could include–Credit limit breach, No payment account, Payment or Credit line not set, etc. | Verify billing details and payment method in WhatsApp Manager to ensure the billing is set up properly. |
131045 | Incorrect Certificate Message sending is failing due to a business phone registration error | Try registering the phone number again and then retry |
131057 | Account in maintenance mode
| Contact WhatsApp support or your solution provider for more details. |
WhatsApp Business API - Best Practices
WhatsApp Business API - Best Practices
To ensure your automated campaigns run smoothly and your messages consistently reach your users' inboxes, implement these foundational best practices.
Maintain a High Quality Rating
WhatsApp monitors user feedback (such as blocks and spam reports) to assign a quality rating to your phone number and templates.
Implement Strict Opt-ins: Never purchase contact lists or message cold leads. Ensure users have explicitly opted in to receive messages from you via your website, email, or a previous interactive session.
Provide an Easy Way to Opt-out: Include a clear opt-out option (like a "Stop" or "Unsubscribe" quick-reply button) in your introductory or promotional templates. Allowing users to opt out within the chat prevents them from using the native "Block" or "Report" buttons, which directly damages your quality score.
Monitor Your Metrics: Regularly check your WhatsApp Manager dashboard for template quality updates. If a template’s quality rating drops, pause sending it immediately and refine the content.
Manage Rate Limits & Queue Spikes
To prevent triggering automated rate limit flags (such as Code 4 or Code 80007):
Implement Exponential Backoff: Set up your API integration to detect throttling error codes and automatically retry failed requests after a short delay, gradually increasing the wait time if errors persist.
Batch Large Broadcasts: Instead of sending tens of thousands of API requests simultaneously, space out your message delivery in smaller batches over several hours.
Respect Single-Recipient Limits: Avoid sending rapid bursts of messages to the same phone number in a short span to prevent triggering the Code 131056 (Pair Rate Limit).
Optimize Your Message Templates
Every business-initiated message must use an approved template. To keep your templates compliant and effective:
Match Parameter Types Accurately: Double-check that your API calls inject the exact number of variables expected by your approved template to avoid Code 132000.
Design with Translation in Mind: If translating templates into multiple languages, keep the text concise. Button text and quick replies can easily exceed character limits when translated, triggering Code 132005.
Focus on Utility and Value: Ensure your template text is highly relevant, personalized, and expected. Spammy, overly aggressive sales language is much more likely to be reported by users and subsequently disabled by WhatsApp (Code 132016).
Manage the 24-Hour Window
Automate Session Checks: Before sending a standard free-form text or media message, verify if the user has messaged you within the last 24 hours.
Fallback to Templates: If the 24-hour window has expired, configure your system to automatically pivot to a business-initiated template (Code 131047) to re-engage the customer.
FAQs
Is the messaging working as a 2-way sync?
Is the messaging working as a 2-way sync?
Yes! The moment a lead engages your line or your agent replies from the Smart Message Composer interface, the backend webhook infrastructure mirrors the conversation state instantly across platforms.
What do the Green, Yellow, and Red flags mean in my WhatsApp Business account?
What do the Green, Yellow, and Red flags mean in my WhatsApp Business account?
This represents your Meta Phone Number Quality Rating. Green indicates healthy line delivery. If your rating drops to Yellow or Red, it means users are flagging your messages as spam. To protect your line from being blocked, pause your active marketing broadcasts and audit your template content immediately.
Can my phone number get instantly banned?
Can my phone number get instantly banned?
No. Unlike standard personal lines where automated AI filters drop sudden, permanent bans, the official WhatsApp Business API uses a dynamic Quality Rating system (graded as High/Green, Medium/Yellow, or Low/Red) inside your Meta Business Manager.
Meta monitors customer feedback loops (such as manual blocks, "Report Spam" actions, and template opt-out rates). If your quality rating falls to Red, your number enters a "Flagged" state, but it is not instantly banned.
Meta will only restrict or suspend your account if it sits at a Low/Red rating for a sustained period or directly violates Meta’s core Commerce and Business Policies (e.g., attempting to sell prohibited goods).
What are the messaging limits, and how do I scale them?
What are the messaging limits, and how do I scale them?
Outbound, business-initiated messaging limits are shared at the Business Portfolio level across all your connected numbers, rather than being isolated to individual lines.
Tier 0 (New/Unverified): Capped at 250 unique customer-initiated conversations per rolling 24-hour cycle.
Tier 1: 1,000 unique recipients per 24 hours.
Tier 2: 10,000 unique recipients per 24 hours.
Tier 3: 100,000 unique recipients per 24 hours (up to Unlimited).
To scale up to the next WhatsApp tier you must maintain a Green or Yellow quality status and utilize at least 50% of your current daily cap within a single day at least once over a rolling 7-day period.
Why did my message fail with "Error 131026: Message Undeliverable"?
Why did my message fail with "Error 131026: Message Undeliverable"?
This is Meta's generic "bucket error" designed to protect user privacy. It means the message reached Meta's servers but could not be delivered to the recipient's handset. The most common causes are:
The destination phone number does not have a registered WhatsApp account.
The customer has manually blocked your business.
The recipient has not accepted Meta's latest global Privacy Policy updates.
The recipient is using a highly outdated version of the WhatsApp mobile app that cannot render interactive buttons or media templates.
What causes "Error 131042: Business Eligibility / Payment Issue"?
What causes "Error 131042: Business Eligibility / Payment Issue"?
This error means Meta has completely frozen your outbound messaging capability due to a billing failure inside your Meta Business Suite.
This happens if the credit card on file has expired, your pre-paid Meta wallet balance is entirely exhausted, or your Meta Business Portfolio is unverified and has exceeded its initial free conversation thresholds.
Messaging will resume as soon as your payment method is updated and active in Meta Business Manager.
Why am I getting "Error 131049: Per-User Marketing Frequency Cap"?
Why am I getting "Error 131049: Per-User Marketing Frequency Cap"?
To preserve ecosystem health, Meta dynamically restricts how many marketing broadcasts an individual user can receive from any business within a short timeframe.
If you see this error, it means Meta blocked your message because the recipient has already been heavily targeted by other brands that day. To prevent this, focus on sending highly relevant content to engaged users, or use lower-cost Utility templates when applicable
How can I proactively keep my account quality rating "Green"?
How can I proactively keep my account quality rating "Green"?
The single most effective way to protect your account health is to build interactive Quick Reply Opt-Out Buttons (e.g., "Stop Messages" or "Unsubscribe") directly into your outbound Marketing templates.
Providing an easy, frictionless way for users to opt out prevents them from using Meta's native "Block & Report Spam" buttons, which heavily penalizes your sender score.
Additionally, maintain clean data hygiene by validating lists before running automated outreach campaigns.
What are the benefits of using WhatsApp Business channel over other channels?
What are the benefits of using WhatsApp Business channel over other channels?
Unrivaled Open & Read Rates: WhatsApp completely bypasses cluttered email inboxes and spam folders, delivering an incredible 98% open rate with over 85% of messages read within the first 5 minutes.
Instant Trust & Credibility: Unlike anonymous, risky-looking SMS shortcodes, WhatsApp displays your branded business name and profile directly in the chat window, immediately validating your identity and giving leads the confidence to reply.
Frictionless, One-Tap Actions: By utilizing interactive UI buttons natively in the chat (like scheduling links or custom responses), you eliminate the conversion-killing friction of forcing leads to copy-paste URLs or exit the messaging app.
Seamless Transition to Active Sales: A template blast doesn't just broadcast information - it acts as a door-opener. The split second a customer interacts or clicks a button, a live, human-to-human sales conversation instantly unlocks inside your dashboard.
Learn More