🔧 WhatsApp API Troubleshooting

WhatsApp API Troubleshooting — Fix Common Issues Fast

Having trouble with WhatsApp API? This guide covers the most common issues businesses face and provides step-by-step solutions to get you back online quickly.

Common Issues

Most Common WhatsApp API Problems & Solutions

Here are the most frequently encountered issues with WhatsApp API and how to resolve them. Most problems can be fixed in under 5 minutes.

📵

Connection Lost / Phone Offline

Fix: Check your phone's internet connection. Open WhatsApp to confirm it's active. Regenerate QR code from dashboard and re-scan if needed.

🚫

Messages Not Delivering

Fix: Verify recipient number format (include country code without +). Confirm the recipient has WhatsApp. Check if you're within rate limits (10 req/sec for Web API).

🔑

Authentication Error (401)

Fix: Check your API key in the Authorization header. Regenerate API key from Postabi dashboard if needed. Ensure format is "Bearer YOUR_API_KEY".

🐌

Slow Message Delivery

Fix: Check your internet speed. Reduce message queue size. If using Meta API, check template status. For persistent issues, WhatsApp us.

💬 Get Troubleshooting Help

Quick Fixes

Quick Diagnosis Checklist

☐ Phone has active internet connection

☐ WhatsApp app is running (not force-closed)

☐ Dashboard shows "Connected" status

☐ API key is correct and active

☐ Recipient number has WhatsApp

☐ Not exceeding rate limits

☐ Phone battery saver not blocking WhatsApp

Solutions

Issue-Specific Solutions

📱

Phone Battery Optimization

Android/iOS battery saver can kill WhatsApp in background. Add WhatsApp to your battery optimization whitelist. Keep the app open if possible.

🌐

Network Issues

Switch between WiFi and mobile data to test connectivity. Ensure your firewall isn't blocking WhatsApp or Postabi API endpoints.

📄

Template Rejection (Meta API)

If Meta rejects your message template, check their content policy. Avoid promotional language in utility templates. We help with re-submission.

🔄

Webhook Not Receiving Updates

Verify your webhook URL is publicly accessible. Check SSL certificate. Use the webhook test tool in the Postabi dashboard to verify.

💬 Still Stuck? WhatsApp Us

FAQs

Troubleshooting FAQs

My Web API keeps disconnecting. What should I do?

This is usually caused by unstable internet on the phone. Use a reliable WiFi connection. Also check if battery optimization is killing WhatsApp in the background.

Messages show "sent" but not "delivered" — why?

This means WhatsApp received the message but the recipient hasn't received it yet (usually offline). If it persists, the recipient may have blocked the sender or changed numbers.

How quickly can Postabi support help with issues?

We typically respond within 1 hour on WhatsApp. Critical issues are prioritized and often resolved within 30 minutes. Support is 24/7.