If your clients are seeing the message:
“Waiting for this message. This may take a while”
instead of the actual message content, this means that WhatsApp was not able to decrypt the message at the time of delivery.
This is not an error caused by the Whapi.Cloud API, but rather a limitation within WhatsApp itself.
🧭 Why This Happens
This issue is typically related to encryption sync problems between devices. According to , the error can occur when:
Devices are using different versions of WhatsApp
A message is received while one of the devices is temporarily offline or not fully synced
✅ What You Can Do
Here are recommended steps to resolve the issue:
Update WhatsApp
Make sure the WhatsApp app is updated to the latest version from the App Store or Google Play.
Unlink all connected devices
Go to WhatsApp → Settings → Linked Devices
Reconnect your WhatsApp number to the API (scan the QR code again)
Use WhatsApp Business
We strongly recommend using the WhatsApp Business app instead of the regular version. Based on our experience, such encryption errors are significantly less frequent with WhatsApp Business.
ℹ️ Important
This issue is not caused by the API and cannot be fixed programmatically. It depends on how WhatsApp handles encryption and session synchronization on the original device.
If the problem persists even after these steps, please contact our support team for further diagnostics.