Troubleshooting

Common issues and their solutions.

Authentication Errors

"Invalid API Key"

  • Verify the key is correct and not expired
  • Check that the X-API-Key header is set correctly
  • Ensure the key hasn't been revoked
  • Generate a new key if needed

"Insufficient Permissions"

  • Check the key's scopes in the dashboard
  • Ensure the required scope is assigned to the key

Message Errors

"Invalid Phone Number"

  • Use international format without + (e.g., 201234567890)
  • Ensure the number is a valid WhatsApp number
  • Remove spaces, dashes, and special characters

"Template Not Found"

  • Verify the template name is correct
  • Ensure the template is approved in WhatsApp Business Manager
  • Check that the template language matches

"Message Failed"

  • Check the WhatsApp number's quality rating
  • Verify the recipient has opted in to receive messages
  • Check for the 24-hour messaging window for non-template messages

Rate Limiting

"Too Many Requests"

  • Implement exponential backoff
  • Check the Retry-After header
  • Consider upgrading your plan for higher limits

Package Issues

"Class not found"

composer dump-autoload
php artisan config:clear

"Configuration not found"

php artisan vendor:publish --tag=wazera-config --force

"Connection timeout"

  • Check WAZERA_BASE_URL in your .env
  • Increase WAZERA_TIMEOUT value
  • Verify your server can reach app.wazera.com

Still Need Help?