Troubleshooting

This guide helps you diagnose and resolve common issues when using WSMS.

Check API Response

1. Go to SMS → Outbox
2. Look for error messages in failed SMS entries
3. Common errors include:
   • Invalid credentials
   • Insufficient balance
   • Invalid phone number format

Verify Phone Number Format

Phone number formatting issues are a common cause of delivery failures:

• Check if your gateway requires country code prefix
• Test with both formats: +49123456789 and 0123456789
• Remove spaces and special characters

Review Server Logs

Enable WordPress debugging to capture errors:

1. Add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

2. Check wp-content/debug.log for WSMS related errors

Common Issues

SMS Not Sending

• Verify gateway credentials are correct
• Check your SMS balance/credits
• Confirm the gateway is active in settings
• Test with your own phone number first

Wrong Sender ID

• Some gateways require pre-registered sender IDs
• Keep sender ID under 11 characters
• Use only alphanumeric characters

Delayed Delivery

• Check if scheduled sending is enabled
• Review server cron configuration
• Verify gateway isn’t experiencing delays

OTP Not Received

• Confirm phone number format matches gateway requirements
• Check spam/blocked message settings on the phone
• Verify OTP feature is enabled in settings

Gateway-Specific Issues

Each gateway may have unique requirements. Refer to your gateway’s documentation or contact their support for:

• IP whitelisting requirements
• API rate limits
• Regional restrictions

Related

• Gateway Configuration - Set up your gateway
• Custom Gateway Setup - Configure custom gateways