Skip to content

FAQ - Errors ❌

"Does not have android.permission.SEND_SMS" Error 🛡️

The app requires the android.permission.SEND_SMS permission to send SMS messages. While the app requests this permission on first launch, if for any reason it wasn't granted you may need to grant it manually.

Manual Permission Setup

  1. ⚙ Open device Settings → Apps → SMS Gateway
  2. Navigate to Permissions → SMS
  3. Enable SMS permission

Hidden Permissions

On some devices:

  • Tap ⋮ menu → "All permissions"
  • Locate SMS under "Not allowed" section
  • Change to "Allow"

RESULT_ERROR_GENERIC_FAILURE Error ⚠️

The RESULT_ERROR_GENERIC_FAILURE error can occur for various reasons:

  • 💸 Low Balance: Check SIM balance
  • Network Issues: Verify signal bars, try airplane mode toggle
  • SIM Problems:
    • Reinsert SIM card.
    • Test in different device.
    • Contact carrier for activation status.

RESULT_ERROR_LIMIT_EXCEEDED Error 🚫

The RESULT_ERROR_LIMIT_EXCEEDED error occurs when:

  1. Reaching Android’s internal SMS queue limit
  2. Exceeding carrier-imposed sending limits
  3. Triggering anti-spam protections

This error indicates the system has blocked further messages to prevent abuse. Key considerations:

  • Android Queue Limit: The OS restricts sending to many messages in a short period. The limits can be adjusted via ADB, see this guide
  • Carrier Limits: Most carriers allow 30-200 SMS/hour. Exceeding may cause temporary blocks. Always consult your carrier's policy.
  • SIM Risks: High-volume sending may lead to carrier penalties or SIM blocking. Always check your carrier's Terms of Service (ToS).

See Also How can I avoid mobile operator restrictions? FAQ entry.

RESULT_RIL_MODEM_ERR Error 📶

The RESULT_RIL_MODEM_ERR error usually indicates a problem with the device's modem or the communication between the application and the modem. This error can stem from various causes:

  • SIM card not properly seated
  • Outdated modem firmware

Troubleshooting Checklist

  1. Reboot device
  2. Clean SIM contacts with alcohol swap
  3. Install latest OS updates
  4. Reset network settings

RESULT_NO_DEFAULT_SMS_APP Error 📱❌

The RESULT_NO_DEFAULT_SMS_APP error occurs when no default SMS app is set on the device or when the default SIM for sending SMS messages hasn't been configured. To resolve this issue, follow these steps:

  1. Open ⚙ Settings → Apps → Default apps
  2. Select default messaging app
  3. Choose preferred SIM for sending in the default messaging app

API Workaround

To send SMS using a specific SIM card, provide the SIM card slot number in the simNumber field of your request.

Explicit SIM Specification
{
    "message": "Test",
    "phoneNumbers": ["+1234567890"],
    "simNumber": 1
}

Can't send message: No SIMs found Error 📴

This error occurs when the app cannot detect any SIM cards on the device. There are several possible causes for this issue:

  • SIM not fully inserted
  • SIM card has poor contact
  • Damaged SIM tray
  1. For Xiaomi devices:

    • Enable Developer Options (tap Build Number 7x)
    • Disable MIUI optimizations to prevent the app from requesting permissions repeatedly
    • Reboot device
  2. Ensure the app has all required permissions in your device settings or via ADB.

    adb shell pm list permissions | grep READ_PHONE_STATE
    

Debugging

If the problem persists, try using the SIM card in another device to rule out hardware issues.