The cannot_be_served error occurs when a WhatsApp Flow message cannot be sent or opened by recipients. This issue often stems from incorrect Flow settings, business account restrictions, or missing properties in the Flow JSON.
What Causes cannot_be_served?
The error usually happens due to one of the following reasons:
Flow is in an Invalid State – The Flow must be in either DRAFT or PUBLISHED state.
Business Account Issues – If the WhatsApp Business Account (WABA) is blocked due to integrity violations, messages cannot be sent.
Incorrect Flow JSON Configuration – Missing version or data_api_version properties in the Flow JSON file can trigger the error.
How to Fix the cannot_be_served Error
Follow these steps to resolve the issue:
1. Verify Flow State
Go to Meta Business Manager and check the status of the Flow.
Ensure it is set to DRAFT or PUBLISHED.
2. Check Business Account Status
Visit the Business Account Quality page.
Look for any integrity violations or restrictions.
Resolve any flagged issues to restore messaging capabilities.
3. Fix Flow JSON Properties
Open the Flow JSON file.
Ensure the version and data_api_version properties are correctly defined.
Example of a properly formatted JSON snippet:
{
"version": "1.0",
"data_api_version": "v16.0"
}Save and re-upload the corrected JSON file.
By following these steps, you can troubleshoot and fix the cannot_be_served error, ensuring your Flow messages are successfully delivered to recipients. For more troubleshooting tips related to WhatsApp API, check out heltar.com/blogs.