Integrity Errors

Integrity errors are returned when the WhatsApp Business Account (WABA) associated with your app has been restricted, disabled, or locked due to a policy violation or a data verification mismatch. These errors are returned as HTTP 403 Forbidden responses.

Integrity issues are serious and typically require direct resolution with Meta. Chakra Chat will surface these errors in the platform's notification dashboard to alert account administrators.

⚠️⚠️ Note: Businesses using Chakra Chat solution may not be able to resolve the issue directly.
Reach out to Chakra team to troubleshoot this issue via a Chakra Ticket.

Error 368 - Temporary Block

Temporarily Blocked for Policy Violations

ERROR CODE

368

ERROR SUMMARY

Temporarily Blocked for Policy Violations

ERROR DESCRIPTION

The WhatsApp Business Account associated with your app has been restricted or disabled because it violated a WhatsApp platform policy. This may include sending prohibited content categories, messaging users who have not opted in, exceeding quality thresholds, or violating the WhatsApp Business Policy.

HTTP Status: 403 Forbidden. This error blocks all outbound messaging until the policy issue is resolved.

RESOLUTION & TROUBLESHOOTING STEPS

1. Review the Policy Enforcement documentation at https://developers.facebook.com/documentation/business-messaging/whatsapp/policy-enforcement to understand the specific violation.

2. Log in to Meta Business Suite and navigate to the WhatsApp Manager to view any enforcement notices or warnings.

3. Correct the behaviour that triggered the violation. This may involve auditing your message templates, opt-in flows, or content policies.

4. Submit an appeal through Meta Direct Support at https://business.facebook.com/direct-support if you believe the restriction was applied in error.

5. If the account has been disabled (not just restricted), you may need to submit a formal reinstatement request.

OTHER NOTES

Prevention is critical. Maintain high template quality ratings, ensure all recipients have explicitly opted in to receive WhatsApp messages, and never send spam or deceptive content.

In Chakra Chat, you can monitor your account's quality rating and policy status from the Account Health section under Settings → WhatsApp Account.

Error 130497 - Account Restricted

Business Account Restricted from Messaging in Certain Countries

ERROR CODE: 130497

ERROR SUMMARY: Business Account Restricted from Messaging in Certain Countries

ERROR DESCRIPTION

The WhatsApp Business Account is not permitted to send messages to users located in specific countries. This restriction is applied based on the business category or industry type of the WhatsApp Business Account, as defined in the WhatsApp Business Messaging Policy.

HTTP Status: 403 Forbidden. Messages sent to users in restricted countries will fail with this error.

RESOLUTION & TROUBLESHOOTING STEPS

1. Review the WhatsApp Business Messaging Policy at https://business.whatsapp.com/policy for the list of countries where messaging is restricted for your specific business category.

2. Filter your recipient lists to exclude phone numbers from restricted countries before sending campaigns or automated messages.

3. If you believe your business category has been incorrectly assigned, contact Meta Support to request a category review.

4. Consider implementing a country-code validation layer in your message dispatch logic in Chakra Chat to prevent sending to blocked regions.

OTHER NOTES

Country restrictions are enforced at the platform level and cannot be overridden by the business or by Chakra Chat. You must comply with the geographic restrictions tied to your business category.

This is especially relevant for financial services, healthcare, and regulated industries, which have more geographic messaging restrictions than other business types.

Error 131031 - Account Lock

Account Has Been Locked

ERROR CODE: 131031

ERROR SUMMARY: Account Has Been Locked

ERROR DESCRIPTION:WhatsApp Business Platform error 131031 means the WhatsApp Business Account (WABA) connected to your API setup has been locked by Meta. While locked, no messages can be sent and no new numbers can be added until the lock is cleared. This error has two distinct root causes, and they require different fixes:

(a) WhatsApp flagged your account for breaking a rule (spam, banned products, too many user complaints, etc.)

(b) something in a verification step didn't match what's on file (most commonly a wrong 2-step PIN).

RESOLUTION & TROUBLESHOOTING STEPS

Step 0 — Find out which of the two it is

Sign into Meta Business Suite and go to Business Support Home. You can use the request a review guide for your reference.
Meta posts details for any specific violation: a summary of the policy violated, examples of what is and isn't allowed, whether there's an active restriction, and how to appeal.

Note: If nothing shows up in Business Support Home, the lock is more likely the verification/PIN type rather than a policy violation.

Step 1 — If it's a genuine policy violation

If Business Support Home shows a specific violation, you have two options: fix whatever caused it (prohibited products, spammy messaging patterns, missing details etc.) and wait, or file an appeal if you believe the flag was wrong.

Step 2 — If it's a PIN/verification mismatch

Have whoever manages the number reset the two-step verification PIN (turn it off, then set a fresh one), then re-register the number in Chakra Chat.

This is the standard fix when the lock is caused by Meta failing to match submitted verification data rather than an actual rule violation.

Note: Not every violation is appealable; some spam-related restrictions just require waiting out the restriction period before messaging resumes.

Step 3 — For Business Verification and Business Info Update

• If your WhatsApp Business Account is available for Business Verification, please verify this. Use this guide for Meta Business verification.
• If your WhatsApp business account profile has missing business info like website, business category, description etc, pleaase update the details in meta Business Manager or directly from the WhatsApp Business app setting in case of Coexistence accounts. Follow the guide to update the Business Information

Step 4 — If neither applies, or the appeal didn't resolve it

Open a ticket with Meta's Direct Support and reference error code 131031 explicitly, along with your WABA ID. This is the route to take if the account looks clean but remains locked.