Troubleshooting Guide

Try these quick solutions first before diving into specific issues:

Device Won't Connect

Solutions:

• Ensure your phone and PC are on stable internet connections
• Update WhatsApp to the latest version on your phone
• Clear WhatsApp cache on your phone
• Try using a different WhatsApp account
• Disable VPN or proxy if enabled
• Check firewall settings - allow MetjetBot through Windows Firewall

Device Keeps Disconnecting

Solutions:

• Check if your phone's internet connection is stable
• Ensure your phone isn't in battery saver mode
• Keep WhatsApp running in background on your phone
• Don't log out of WhatsApp on your phone
• Restart your router if WiFi is unstable

QR Code Not Appearing

Solutions:

• Refresh the page or restart MetjetBot
• Check if you've reached device limit for your license
• Clear browser cache if using web version
• Disable ad blockers or browser extensions

Messages Not Sending

Solutions:

• Verify device is connected (green status indicator)
• Check if phone number format is correct (+country code)
• Ensure recipient hasn't blocked your number
• Verify recipient's number is active on WhatsApp
• Check if you've exceeded daily sending limits
• Reduce message sending speed (increase delays)

High Message Failure Rate

Solutions:

• Clean your contact list - remove invalid numbers
• Increase delay between messages (minimum 5 seconds)
• Reduce daily sending volume
• Distribute campaign across multiple devices
• Check if your WhatsApp account is restricted

Media Files Not Sending

Solutions:

• Check file size limits (Images: 5MB, Videos: 16MB, Documents: 100MB)
• Verify file format is supported
• Compress large files before sending
• Ensure stable internet connection for uploads
• Try sending without media first to test connection

Application Running Slow

Solutions:

• Close unnecessary applications to free up RAM
• Clear MetjetBot cache and temporary files
• Reduce number of connected devices
• Archive old campaigns and messages
• Restart your computer
• Check if antivirus is scanning MetjetBot files

High CPU/Memory Usage

Solutions:

• Limit concurrent campaigns to 2-3 at a time
• Reduce message sending speed
• Close other resource-intensive applications
• Update to latest version of MetjetBot
• Upgrade RAM if consistently maxing out

Contacts Not Importing

Solutions:

• Verify Excel/CSV file format is correct
• Ensure column headers match required fields
• Check for special characters in contact data
• Remove empty rows from import file
• Try importing smaller batches (500-1000 at a time)

Missing Data or Contacts

Solutions:

• Check if data was accidentally deleted
• Restore from backup if available
• Re-sync contacts from WhatsApp device
• Check database file isn't corrupted
• Contact support for data recovery assistance

Database Errors

License Key Not Working

Solutions:

• Copy-paste license key to avoid typos
• Ensure no extra spaces before/after the key
• Verify license hasn't expired
• Check if license is already used on another PC
• Contact support to verify license status

License Expired Message

Solutions:

• Check license expiration date in settings
• Renew license if expired
• Verify system date/time is correct
• Contact support if license should still be valid

Account Temporarily Banned

Prevention:

• Never send more than 500-1000 messages per day per device
• Always use minimum 3-5 second delays between messages
• Only message contacts who opted in
• Provide clear opt-out instructions
• Avoid spam trigger words and excessive emojis
• Don't send identical messages to many people

If Restricted:

• Wait for the restriction period to end (usually 24-48 hours)
• Review and improve your messaging practices
• Use different WhatsApp account for future campaigns
• Contact WhatsApp support if you believe it's a mistake

"Failed to initialize database"

• Run MetjetBot as administrator
• Check if database file is locked by another process
• Verify installation directory has write permissions
• Restore database from backup

"Network error" or "Connection timeout"

• Check internet connection
• Disable VPN or proxy temporarily
• Add MetjetBot to firewall exceptions
• Try different network (mobile hotspot)

"Missing DLL" errors

• Reinstall Microsoft Visual C++ Redistributable
• Update Windows to latest version
• Reinstall MetjetBot

Before Contacting Support

Please gather the following information:

• MetjetBot version number (found in Settings → About)
• Windows version and build number
• Detailed description of the issue
• Steps to reproduce the problem
• Screenshots or error messages
• When the issue started occurring

Contact Support