WhatsApp Business API Troubleshooting Guide
Overview
This comprehensive guide addresses common issues encountered when using the WhatsApp Business API with Resayil platform, organized into three main categories.
Integration & Setup Errors
Number Already Registered If your phone number is linked to another provider or WhatsApp mobile app, you must disconnect it first. The platform offers migration assistance or manual support at [email protected].
Verification Code Issues Check browser console for validation errors regarding business profile settings. Alternatively, try the "first-time setup" path instead of migration, or wait 5-10 minutes before requesting a new code.
Permission Authorization Problems "Re-run the embedded signup process and ensure all checkboxes for permissions are selected."
Account ID Confusion Ensure you're using the WhatsApp Business Account (WABA) ID, not the Business Manager ID, found in Meta Business Settings under 'WhatsApp Accounts.'
Migration Failures Verify the number is fully approved in Meta Business Suite and no longer active on mobile devices. Screenshot verification may be required for support assistance.
Two-Factor Authentication Conflict Disable 2FA in WhatsApp app settings before connecting to the platform, as it prevents security certificate generation.
Stalled Permission Propagation Refresh your browser and wait 2–5 minutes for Meta approval synchronization.
Message Template Issues
Templates Not Appearing Verify templates use only supported media types, match account language settings, and allow up to 24 hours for Meta approval processing.
Variable Formatting Requirements
"WhatsApp Cloud API requires numerical placeholders (e.g., {{1}}, {{2}})", rather than named variables.
Marketing Reclassification Prevention Use neutral language, avoid emojis in transactional updates, and be specific about service purpose during submission.
Message Delivery Issues
Undeliverable Messages Recipients may lack WhatsApp accounts, haven't accepted Terms of Service, or use outdated app versions. Request users send a message first to establish conversation.
Frequency Limits "Meta has capped the number of marketing templates this specific user can receive in a short period to prevent spam." Wait 24 hours before resending.
24-Hour Conversation Window "You can only send free-form messages if the user has replied within the last 24 hours." Template messages reopen this window.
Unsupported Media Verify file sizes comply with Meta limits and formats (.jpg, .pdf, .mp4) are WhatsApp-supported.
Account Restrictions Check Meta Business Suite Support Inbox for policy violation notifications and follow appeal instructions.
Support Resources
For unresolved issues, contact the support team at the provided link or submit a support ticket through the platform.