Troubleshooting
Solutions to common issues with installation and message delivery.
Troubleshooting
Here are solutions to the most common issues users face when using WhatsCloud.
1. Permission Error (500 Internal Server Error)
If you see a "500 Error" or a white screen immediately after installation, it is usually a permission issue with the Laravel folders.
Solution: Run the following commands in your project root directory:
chmod -R 775 storage
chmod -R 775 bootstrap/cache
2. "License Invalid" Error
This usually happens when you try to use the same license key on a new domain while it is still active on another one.
Solution
- Uninstall the script from the old domain first (if possible).
- If the old domain is deleted or inaccessible, please contact support to reset your license key manually.
3. Messages Not Received (Meta Webhook)
Messages are marked as "Sent" in the panel but never arrive on the recipient’s phone.
Solution
- Go to Meta Developers → WhatsApp → Configuration.
- Locate the Webhooks section.
- Click Manage (Edit).
- Make sure the messages field is checked and saved.
4. Message Failed (24-Hour Rule)
Messages fail to deliver to customers.
Reason
WhatsApp enforces a strict 24-Hour Session Rule.
- First Message: You cannot send a plain text message to start a conversation.
You must send a Meta-approved Template Message first. - Replies: After the user replies, you can send plain text or media messages within the 24-hour window.
Solution
Always start a new conversation or campaign using a Template Message.
5. Delivery Issues (Unhealthy Quality)
Messages were delivering correctly before but suddenly stopped.
Reason
If too many users block or report your number, Meta lowers your Quality Rating.
If the rating becomes too low, Meta temporarily pauses outgoing messages.
Solution
- Open WhatsApp Manager and check your Quality Rating.
- If the status is Red, stop sending bulk campaigns for 24–48 hours.
- Only reply to incoming messages during this time to restore account health.
Need More Help?
If you are facing a different issue, please reach out to our support team.