KalSMS SMS/MMS gateway for Android

Installing KalSMS

Before installing KalSMS, ensure that you have the following prerequisites:

• One or more Android phones (1.6 Donut or higher) that are registered on a mobile network.
• A way for the phones to connect to the internet, either via Wi-Fi or the mobile data service.
  (Even if using Wi-Fi, mobile data service is necessary to receive MMS messages.)
• A web server accessible from the public internet

To install the current release version of KalSMS on an Android phone, either scan the barcode below with a QR code app, or click the link from your phone's browser.

Alternatively, software developers may download the source code from GitHub and build KalSMS themselves.

Configuring KalSMS

Server Configuration

It is assumed that your organization already has an HTTP server, or has the technical expertise to set up an HTTP server.

Follow the instructions in the API Reference page to learn how to construct a resource on your HTTP server that can communicate with KalSMS.

Phone Configuration

After your server is configured, configure KalSMS on your phone to connect to your server as follows:

1. Open the KalSMS app
2. Click the Menu button, then "Settings"
3. Configure KalSMS to work with your server by entering:
• your server URL (including http:// or https://)
• your phone number
• the password shared with the server
4. Choose an interval to poll for new outgoing messages
5. Check "Enable KalSMS?"
6. Click the Back button to return to the main screen

To test if KalSMS has been configured properly and can connect to your server, open the KalSMS app, click the Menu button, then click "Test Connection".

Finally, prevent Wi-Fi from turning off when the phone sleeps, by going to Settings > Wireless & Networks > Wi-Fi settings > Menu key > Advanced > Wi-Fi sleep policy and select "Never". (Otherwise, you will get connection timeout errors when forwarding messages after the phone goes to sleep.)

Important: After KalSMS is enabled, it will forward all SMS messages regardless of whether the KalSMS app is open. If you want to use SMS normally again, return to KalSMS' settings screen and uncheck "Enable KalSMS?".

Installing Expansion Packs

By default, Android prevents KalSMS from sending more than 100 outgoing SMS messages per hour. However, that limit can be increased by installing KalSMS Expansion Packs.

Each Expansion Pack allows KalSMS to increase its sending limit by an additional 100 outgoing SMS messages per hour. For example, if you install 14 expansion packs, KalSMS will be able to send up to 1500 outgoing SMS messages per hour.

KalSMS Expansion Pack 01

With Expansion Packs, KalSMS is limited only by how fast your phone can send and receive SMS, and by your mobile provider's usage limits and terms of service.