mirror of
https://github.com/cwinfo/envayasms.git
synced 2024-11-15 04:40:26 +00:00
206 lines
8.7 KiB
HTML
Executable File
206 lines
8.7 KiB
HTML
Executable File
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta charset='utf-8'>
|
|
<meta http-equiv="cache-control" content="no-cache, must-revalidate" >
|
|
<title>EnvayaSMS: Installing EnvayaSMS</title>
|
|
<link rel='stylesheet' type='text/css' href='/styles/site.css' />
|
|
</head>
|
|
|
|
<body>
|
|
<a href="http://github.com/youngj/EnvayaSMS"><img style="position: absolute; top: 0; right: 0; border: 0;" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
|
|
|
|
<div id="container">
|
|
|
|
<a style='float:left' href="/"><img src='/media/icon.png' height='72' width='72' style='margin-right:10px' /></a>
|
|
<h1 style='padding-top:13px'><a href="/">EnvayaSMS</a>
|
|
|
|
<span class="small">
|
|
SMS gateway for Android
|
|
</span>
|
|
|
|
</h1>
|
|
|
|
<div class='menu' style='clear:both;padding-top:5px'>
|
|
<a href='/'>Home</a>
|
|
·
|
|
<a class='active' href='/install/'>Install</a>
|
|
·
|
|
<a href='/test/'>Test</a>
|
|
·
|
|
<a href='/how/'>How it Works</a>
|
|
·
|
|
<a href='/serverapi/'>API Reference</a>
|
|
·
|
|
<a href='/faq/'>FAQ</a>
|
|
·
|
|
<a href='/history/'>History</a>
|
|
·
|
|
<a href='/community/'>Community</a>
|
|
</div>
|
|
|
|
<h2>Installing EnvayaSMS</h2>
|
|
|
|
In order to install and deploy EnvayaSMS, you will need the following prerequisites:
|
|
|
|
<ul>
|
|
<li>An Android phone (1.6 or higher), registered on a mobile network
|
|
</li>
|
|
<li>A way for the phone to connect to the internet, either via Wi-Fi
|
|
or mobile data service<br />
|
|
(Even with Wi-Fi, mobile data service is necessary to receive MMS messages.)</li>
|
|
<li>A web server accessible from the public internet</li>
|
|
</ul>
|
|
|
|
<p>
|
|
Note: If you don't have an Android phone yet, you can <a href='/test/'>test EnvayaSMS on your computer</a>.
|
|
</p>
|
|
|
|
To install EnvayaSMS on an Android phone, open EnvayaSMS on Android Market by clicking the link below from your phone's browser, or scanning the barcode with a QR code app.<br />
|
|
|
|
<div style='float:left;padding-right:10px;padding-top:20px'>
|
|
<div style='font-size:16px;font-weight:bold; text-align:center'>
|
|
<a href="https://market.android.com/details?id=org.envaya.sms">Open Android Market</a>
|
|
</div>
|
|
<a href="https://market.android.com/details?id=org.envaya.sms">
|
|
<img src='/media/qr.png' width='175' height='175' />
|
|
</a>
|
|
</div>
|
|
|
|
<div style='float:left;padding-top:10px'>
|
|
<img src='/media/screenshot-market.png' style='border:1px solid black' width='440' height='218' />
|
|
</div>
|
|
|
|
<div style='clear:both;padding-top:10px'>
|
|
|
|
<p>
|
|
In order to download from Android Market, you will need a Google account and the Market app on your phone.
|
|
Alternatively, you can also install download EnvayaSMS directly from the link below:
|
|
</p>
|
|
<strong><a href='https://github.com/downloads/youngj/EnvayaSMS/EnvayaSMS-release.apk'>EnvayaSMS-release.apk</a></strong>
|
|
<p>
|
|
Software developers may also <a href="https://github.com/youngj/EnvayaSMS">download the source code from GitHub</a>
|
|
and build EnvayaSMS themselves.
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<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/'>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='212' height='350' />
|
|
</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><em>Optional:</em> enable Network Failover so that the phone will automatically switch
|
|
to mobile data if the Wi-Fi network stops working.
|
|
</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>
|
|
|
|
<p>If you're testing EnvayaSMS with an Android phone that you're also using for normal communication,
|
|
you can enable "Test mode" on the settings screen. When Test mode is enabled, EnvayaSMS will only handle SMS messages
|
|
from the phone numbers you specify.</p>
|
|
|
|
<h3 id='expansion'>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 8 expansion packs, EnvayaSMS will be able to send up to 900 outgoing SMS messages
|
|
per hour.
|
|
</p>
|
|
<p>
|
|
<strong><a href="https://market.android.com/details?id=org.envaya.sms.pack01">Install EnvayaSMS Expansion Pack 01</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack01.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://market.android.com/details?id=org.envaya.sms.pack02">Install EnvayaSMS Expansion Pack 02</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack02.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack03.apk">Install EnvayaSMS Expansion Pack 03</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack03.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack04.apk">Install EnvayaSMS Expansion Pack 04</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack04.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack05.apk">Install EnvayaSMS Expansion Pack 05</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack05.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack06.apk">Install EnvayaSMS Expansion Pack 06</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack06.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack07.apk">Install EnvayaSMS Expansion Pack 07</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack07.apk'>(apk)</a></small><br />
|
|
<strong><a href="https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack08.apk">Install EnvayaSMS Expansion Pack 08</a></strong>
|
|
<small><a style='text-decoration:none' href='https://github.com/downloads/youngj/EnvayaSMS/envayasms-pack08.apk'>(apk)</a></small><br />
|
|
|
|
</p>
|
|
<p>
|
|
With Expansion Packs, EnvayaSMS is limited only by how fast your phone can send and receive SMS (likely about 1000 messages/hour),
|
|
and by your mobile provider's usage limits and terms of service.
|
|
</p>
|
|
<p>
|
|
</p>
|
|
|
|
<div class="footer">
|
|
get the source code on GitHub : <a href="http://github.com/youngj/EnvayaSMS">youngj/EnvayaSMS</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<script type="text/javascript">
|
|
|
|
var _gaq = _gaq || [];
|
|
_gaq.push(['_setAccount', 'UA-25868450-2']);
|
|
_gaq.push(['_trackPageview']);
|
|
|
|
(function() {
|
|
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
|
|
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
|
|
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
|
|
})();
|
|
|
|
</script>
|
|
|
|
</body>
|
|
</html> |