Fork me on GitHub

EnvayaSMS SMS gateway for Android

Testing EnvayaSMS

If you don't yet have an Android phone, you can test EnvayaSMS in an emulated phone on your computer.

With this method, you can test EnvayaSMS for free and figure out if EnvayaSMS will work for your project without needing to get an actual phone or subscribe to mobile service.

The following steps explain how to set up EnvayaSMS on an Android Virtual Device:

  1. Install the Android SDK on your computer
  2. Create a new Android Virtual Device with a target of Android 1.6 or higher. Specify a size for the SD card (necessary to download EnvayaSMS via the browser)
  3. Start the virtual device
  4. Open the Browser app and go to sms.envaya.org/install
  5. Click on the EnvayaSMS-release.apk link to download EnvayaSMS.
    Note: Android Market does not work in the emulator.
  6. Install EnvayaSMS
  7. Configure EnvayaSMS with the settings of your development server.
    Note: Do not enter localhost as the Server URL (since this would refer to the AVD itself). Instead, use your computer's IP address on the local network, as shown by the ipconfig or ifconfig utilities.
  8. To simulate incoming SMS on the emulator:
    • using a telnet client (on your computer), connect to localhost:5554
      Note: on Windows, you can install puttytel.
    • type sms send [phonenumber] [text message] to send messages to the emulator.
      Note: the emulator cannot receive MMS messages.

EnvayaSMS Request Simulator

The EnvayaSMS Request Simulator is a standalone HTML file that allows you to simulate EnvayaSMS's HTTP requests entirely in your browser via JavaScript.

This may be helpful when developing and testing your server implementation. For example, you could write automated tests in Selenium that use EnvayaSMS Request Simulator to make sure that your server implementation works correctly.

To use EnvayaSMS Request Simulator, just copy the HTML file somewhere on your site, and open it in a web browser. The URL of the EnvayaSMS Request Simulator must be on the same domain as the Server URL.

Using a Real Phone with a Development Server

Of course, you can also test EnvayaSMS by connecting a real Android phone to your development web server. For more information, see the FAQ.