Error and Status Messages
Understanding WhatsApp Business API Error Codes in Zylu
Error 100 - Invalid App ID
Meaning: The App ID provided is incorrect or does not exist.
Solution: Verify the App ID in the Zylu settings and ensure it's correctly linked to WhatsApp.
Error 101 - Invalid Access Token
Meaning: The access token has expired or is incorrect.
Solution: Refresh the access token in the WhatsApp Business Manager.
Error 103 - Permission Denied
Meaning: The API request lacks the required permissions.
Solution: Ensure the necessary permissions are granted in the WhatsApp Business Manager.
Error 131026 - Invalid Message Type
Meaning: The message format is incorrect or unsupported.
Solution: Use only supported message formats (text, images, documents, etc.).
Error 131030 - Message Failed to Send
Meaning: The recipient's number is invalid, or the phone is not registered with WhatsApp.
Solution: Verify the phone number and ensure the recipient has an active WhatsApp account.
Error 131051 - Rate Limit Exceeded
Meaning: Too many messages have been sent in a short time.
Solution: Reduce the frequency of messages and implement proper sending intervals.
Error 131008 - Message Blocked by User
Meaning: The recipient has blocked your number.
Solution: Respect user privacy and avoid sending messages to blocked contacts.
Error 132000 - Phone Number Not Registered
Meaning: The sender’s phone number is not linked to WhatsApp Business.
Solution: Register the phone number in WhatsApp Business Manager.
Error 132005 - Contact Not Opted In
Meaning: The recipient has not opted in to receive messages.
Solution: Ensure that customers have opted in before sending messages.
Error 500 - Internal Server Error
Meaning: A problem occurred on WhatsApp’s servers.
Solution: Wait and try again later. If the issue persists, check the WhatsApp Business Status page.
Error 502 - Bad Gateway
Meaning: A temporary issue in the network.
Solution: Retry the request after a few minutes.
Error 503 - Service Unavailable
Meaning: WhatsApp servers are overloaded or under maintenance.
Solution: Wait and try again later.
Error 131042 - Template Not Approved
Meaning: The message template is not approved by WhatsApp.
Solution: Submit the template for approval in the WhatsApp Business Manager.
Error 131048 - Unsupported Language
Meaning: The message template uses an unsupported language.
Solution: Use only WhatsApp-approved languages for message templates.
Error 200 - Business Verification Required
Meaning: The business account is not verified.
Solution: Complete the business verification process in the WhatsApp Business Manager.
Error 202 - Account Restricted
Meaning: WhatsApp has restricted the account due to policy violations.
Solution: Review WhatsApp’s policies and appeal the restriction.
Check the error code: Identify the exact issue using the above list.
Review the WhatsApp Business Manager: Ensure settings, permissions, and templates are correctly configured.
Retry after some time: Temporary issues (5xx errors) usually resolve automatically.
Contact Support: If the issue persists, reach out to Zylu Support or WhatsApp Business API support for assistance.
By understanding these error codes, you can quickly diagnose and resolve issues, ensuring smooth WhatsApp communication through Zylu.
Account Restricted:
Meta by default restricts the business account if just created. In such a case, you must raise a ticket or resolve issues by submitting additional information.
You should be able to see the reason behind the restriction. You can Request Review here and follow the steps.
Usually the restriction removed within 24 hours with the right documentations.
Popular Articles
Billing Process (Walk-In Customer)
<br> Introduction: Learn the step-by-step process to handle walk-in customers and complete a sale in Zylu. Adding a New Customer If the customer is already in the system, you can search for them directly. For new customers, click on Add ...Zylu Quick Start Guide in Under 4 Minutes
<br>Introduction Welcome to Zylu! This quick and easy guide will walk you through the essential steps to set up and start using Zylu to run your salon efficiently. We’ve designed this to make sure you’re set up in no time so that you ...Reports of Booking, Expenses, and Tips
<br> Introduction: Reports help you track and analyze your salon's performance. In this module, you’ll learn how to view reports for bookings, expenses, and tips. Accessing Reports From the Main Menu, go to Reports. Here, you will see ...Understanding Navigation
<br> Introduction: Zylu’s interface is designed to be simple and intuitive. In this module, you'll learn how to navigate the main sections of Zylu and access key features easily. Main Navigation: The Main Navigation section gives you ...Bookings
How to manage appointments and Bookings <br>Introduction Welcome to the Booking Module! This section will guide you through managing your salon’s appointments. Let’s dive into the features and functionality of the Booking ...