WhatsApp Business 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.
Related Articles
Configure WhatsApp Payment Settings
Setting Up Payment Methods for Your WhatsApp Business Account To ensure your WhatsApp Business account can accept payments, you need to configure your payment settings. Follow these straightforward steps: 1. Navigate to WhatsApp Account Settings: Go ...WhatsApp Signup Preparation
This article outlines the necessary preparations for customers before they begin the WhatsApp onboarding process. Before you begin, ensure you have the following ready: Phone Number for WhatsApp API This number should not have an existing WhatsApp ...Complete Business Verification
Verifying Your WhatsApp Business Account To fully utilize the features of your WhatsApp Business account, it's essential to complete the business verification process. Follow these simple steps to get started: Initiate Business Verification: If you ...Completing the Embedded Signup Form
Step-by-Step Guide to Onboarding To successfully complete the embedded signup process for WhatsApp API integration, follow these steps: <br> 1. Access the Signup Form: Start by clicking on this link to open the embedded signup form: ...Verification Code Submission
Ensure Smooth Onboarding by Sending Your Verification Code After you submit the WhatsApp onboarding form, you will receive a unique verification code. This code is crucial for completing your onboarding process with Zylu. Access the Code: Once your ...
Popular Articles
Getting Started with Bookings & Sales on Zylu: A Step-by-Step Guide
How to Get Started with Bookings & Walk-Ins in Zylu . This guide will walk you through managing bookings, walk-ins, adding new customers, selling services and products, and sending invoices through Zylu. By following these steps, you’ll streamline ...How to send a WhatsApp Campaign for Holiday Discount
Step-by-Step Guide to Engaging Customers with Festive Offers WhatsApp Campaign In this tutorial, we'll walk you through the process of creating and sending a WhatsApp campaign to promote your holiday discounts. <br> Steps: Log into your Zylu ...Billing Process (Walk-In Customer)
A step-by-step guide to efficiently handle transactions for walk-in clients. In this tutorial, you'll discover how to bill walk-in customers using the Zylu salon management app. Whether it’s a first-time visitor or a regular client, we’ll walk you ...Zylu Quick Start Guide in Under 4 Minutes
&lt;br&gt;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
&lt;br&gt; 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 ...