mirror of
https://github.com/cwinfo/envayasms.git
synced 2024-11-15 04:40:26 +00:00
109 lines
3.6 KiB
Twig
Executable File
109 lines
3.6 KiB
Twig
Executable File
layout: default.twig
|
|
---
|
|
<h2>Installing EnvayaSMS</h2>
|
|
|
|
Before installing EnvayaSMS, ensure that you have the following prerequisites:
|
|
|
|
<ul>
|
|
<li>One or more Android phones (1.6 Donut or higher) that are
|
|
registered on a mobile network. </li>
|
|
<li>A way for the phones to connect to the internet, either via Wi-Fi
|
|
or the mobile data service. <br />
|
|
(Even if using Wi-Fi, mobile data
|
|
service is necessary to receive MMS messages.) </li>
|
|
<li> A web server accessible from the public internet </li>
|
|
</ul>
|
|
|
|
To install the current release version of EnvayaSMS on an Android phone,
|
|
either scan the barcode below with a QR code app,
|
|
or click the link from your phone's browser. <br />
|
|
|
|
<div style='text-align:center'>
|
|
<img src='media/qr.png' width='175' height='175' style='vertical-align:middle' />
|
|
<em>or</em>
|
|
<span style='font-size:20px;font-weight:bold'>
|
|
<a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms.apk">Install EnvayaSMS</a>
|
|
</span>
|
|
|
|
</div>
|
|
|
|
<p>
|
|
Alternatively, software developers may <a href="https://github.com/youngj/EnvayaSMS">download the source code from GitHub</a>
|
|
and build EnvayaSMS themselves.
|
|
</p>
|
|
|
|
<h2>Configuring EnvayaSMS</h2>
|
|
|
|
<h3>Server Configuration</h3>
|
|
|
|
<p>
|
|
It is assumed that your organization already has an HTTP server, or has the technical expertise to set up an HTTP server.
|
|
</p>
|
|
|
|
<p>
|
|
Follow the instructions in the <a href='serverapi.html'>API Reference</a> page to learn how to construct a
|
|
resource on your HTTP server that can communicate with EnvayaSMS.
|
|
</p>
|
|
|
|
<h3>Phone Configuration</h3>
|
|
|
|
<div style='float:right;padding-left:10px;padding-bottom:10px'>
|
|
<img src='media/screenshot-settings.png' width='211' height='347' />
|
|
</div>
|
|
|
|
|
|
<p>
|
|
After your server is configured, configure EnvayaSMS on your phone to connect to your server as follows:
|
|
</p>
|
|
|
|
<ol>
|
|
|
|
<li>Open the EnvayaSMS app</li>
|
|
<li>Click the Menu button, then "Settings"</li>
|
|
<li>Configure EnvayaSMS to work with your server by entering:</li>
|
|
<ul>
|
|
<li>your server URL</li>
|
|
<li>your phone number</li>
|
|
<li>the password shared with the server</li>
|
|
</ul>
|
|
<li>Choose an interval to poll for new outgoing messages</li>
|
|
<li><em>Recommended:</em> under Wi-Fi sleep policy, select "always stay connected".
|
|
(Otherwise, EnvayaSMS will be unable to forward messages after the phone goes to sleep.)
|
|
</li>
|
|
<li>Check "Enable EnvayaSMS"</li>
|
|
<li>Click the Back button to return to the main screen</li>
|
|
</ol>
|
|
|
|
<p>
|
|
To test if EnvayaSMS has been configured properly and can connect
|
|
to your server, open the EnvayaSMS app, click the Menu button,
|
|
then click "Test Connection".
|
|
</p>
|
|
|
|
<p>
|
|
<strong>Important:</strong> After EnvayaSMS is enabled, it will forward all SMS messages regardless of whether the
|
|
EnvayaSMS app is open. If you want to use SMS normally again, return to EnvayaSMS' settings screen
|
|
and uncheck "Enable EnvayaSMS".
|
|
</p>
|
|
|
|
<h3>Installing Expansion Packs</h3>
|
|
|
|
<p>
|
|
By default, Android prevents EnvayaSMS from sending more than 100 outgoing SMS messages per hour.
|
|
However, that limit can be increased by installing EnvayaSMS Expansion Packs.
|
|
</p>
|
|
<p>
|
|
Each Expansion Pack allows EnvayaSMS to increase its sending limit by an additional 100 outgoing SMS messages
|
|
per hour. For example, if you install 14 expansion packs, EnvayaSMS will be able to send up to 1500 outgoing SMS messages
|
|
per hour.
|
|
</p>
|
|
<p>
|
|
TODO add download links
|
|
</p>
|
|
<p>
|
|
With Expansion Packs, EnvayaSMS 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.
|
|
</p>
|
|
<p>
|
|
|
|
</p> |