Changes

Created page with "==Summary== The <b>SMS Gateway</b> service is used to set up various SMS related (mostly automated) functions. This chapter is a summary of the SMS Gateway service of {{{name..."
==Summary==

The <b>SMS Gateway</b> service is used to set up various SMS related (mostly automated) functions. This chapter is a summary of the SMS Gateway service of {{{name}}} routers.

==Post/Get==

The <b>Post/Get Configuration</b> section is used to turn ON and configure SMS related post/get settings. When the function is enabled, it provides you with the possibility to perform SMS related action requests by writing them in the URL field of your web browser.

The figure below is an example of the Post/Get Configuration page and the table below provides information on fields contained in that page:

[[File:{{{file_post_get}}}]]

<table class="nd-mantable">
<tr>
<th>Field name</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>yes | no; Default: <b>no</b></td>
<td>Turns SMS post/get ON or OFF</td>
</tr>
<tr>
<td>Username</td>
<td>string; Default: <b>user1</b></td>
<td>User name used for authorization when sending post/get requests</td>
</tr>
<tr>
<td>Password</td>
<td>string; Default: <b>user_pass</b></td>
<td>Password used for authorization when sending post/get requests</td>
</tr>
</table>

===SMS Post/Get usage examples===
----
Use a web browser or any other compatible software to send <b>HTTP post/get</b> strings to the router. The router must be connected to a GSM network when using the <b>Send SMS</b> feature. Below you will find a table with possible actions and examples on how to use them:

<table class="nd-othertables_2">
<tr>
<th width=300">Action</th>
<th width=852">Post/get URL examples</th>
</tr>
<tr>
<td>View mobile messages list</td>
<td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_list?username=user1&password=user_pass</td>
</tr>
<tr>
<td>Read mobile message</td>
<td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_read?username=user1&password=user_pass&number=1</td>
</tr>
<tr>
<td>Send mobile message</td>
<td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage</td>
</tr>
<tr>
<td>View mobile messages total</td>
<td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_total?username=user1&password=user_pass</td>
</tr>
<tr>
<td>Delete mobile message</td>
<td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_delete?username=user1&password=user_pass&number=1</td>
</tr>
</table>

<ul>
<li><b>192.168.1.1</b> - router's IP address. (Replace it with your [[{{{name}}}_LAN#General_Setup|LAN IP]] or [[{{{name}}}_WAN#Operation_Modes|WAN IP]] (when connecting remotely))</li>
<li>SMS related post/get commands. Possible values are:
<ul>
<li><i>sms_list</i> - view all SMS messages in storage</li>
<li><i>sms_read</i> - read a single SMS message by specified SMS index (number)</li>
<li><i>sms_send</i> - send an SMS message to specified recipient</li>
<li><i>sms_total</i> - display SMS storage statistics</li>
<li><i>sms_delete</i> - delete a single SMS message by specified SMS index (number)</li>
</ul>
</li>
<li><b>&</b> - separation symbol. After specifying the SMS command, other parameters must be separated by an <i>ampersand</i> (<i>&</i>) symbol</li>
<li><b>username</b> - SMS post/get configuration user name</li>
<li><b>password</b> - SMS post/get configuration password</li>
<li><b>number</b> - SMS message index or (depending on context) recipient's phone number. SMS message indexes can be viewed with the <i>sms_list</i> command.<br>Correct phone number format is:
<ul>
<li><i>00</i> - number must be preceded by two zeros</li>
<li><i><country_code></i> - the next following element is the number holder's country code</li>
<li><i><receivers_number></i> - phone number of the recipient</li>
</ul>
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)
</li>
<li><b>text</b> - SMS message text</li>
</ul>

==Scheduled SMS==

<b>Scheduled SMS</b> allows you to set up the router to periodically send SMS messages to a specified number. Scheduled messages are managed in rule form. Therefore, to configure a new Scheduled Message, we must first create a rule. To create a new rule, type in a phone number in the <b>Phone number</b> field located in the Scheduled Messages Configuration section and click the <b>Add</b> button located next to it.

After this you will be redirected to the <b>Scheduled Messages Configuration</b> window where you can configure all parameters related to the rule. Once you save the configuration, you will be redirected back to the Scheduled SMS page, where you will see your new rule in the <b>Messages To Send</b> section:

[[File:{{{file_scheduled_sms}}}]]

===Scheduled Messages Configuration===
----
The figure below is an example of the <b>Scheduled Messages Configuration</b> window and the table below provides information on the field contained in that window:

[[File:{{{file_scheduled_sms_conf}}}]]

<table class="nd-mantable">
<tr>
<th>Field name</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td>Enable</td>
<td>yes | no; Default: <b>no</b></td>
<td>Turns the rule ON or OFF</td>
</tr>
<tr>
<td>Recipient's phone number</td>
<td>phone number; Default: <b>none</b></td>
<td>Phone number of th erecipient that will receive the scheduled messages</td>
</tr>
<tr>
<td>Message text</td>
<td>string; Default: <b>none</b></td>
<td>The message that will be sent</td>
</tr>
<tr>
<td>Message sending interval</td>
<td>time; Default: <b>Day, hour 1, minute 1</b></td>
<td>The frequency at which scheduled messages will be sent</td>
</tr>
</table>

==Auto Reply==

<b>Auto reply</b> is a function that responds to received SMS messages with a user defined automatic response. The figure below is an example of the Auto Reply section and the figure below provides information on the fields contained in that section:

[[File:{{{file_auto_reply}}}]]

<table class="nd-mantable">
<tr>
<th>field name</th>
<th>value</th>
<th>description</th>
</tr>
<tr>
<td>Enable</td>
<td>yes | no; Default: <b>no</b></td>
<td>Turns Auto Reply ON or OFF</td>
</tr>
<tr>
<td>Reply SMS Utilities rules</td>
<td>yes | no; Default: <b>no</b></td>
<td>When enabled, the router will also reply to messages that trigger [[{{{name}}} SMS Utilities|SMS Utilities]] rules</td>
</tr>
<tr>
<td>Don't save received messages</td>
<td>yes | no; Default: <b>no</b></td>
<td>When enabled, the router deletes all received SMS messages</td>
</tr>
<tr>
<td>Mode</td>
<td>Everyone | Listed numbers; Default: <b>Everyone</b></td>
<td>Indicates whether the router should reply to messages from all recipients or just the specified numbers</td>
</tr>
<tr>
<td>Message text</td>
<td>string; Default: <b>none</b></td>
<td>Text that will be sent in the automatic response</td>
</tr>
<tr>
<td>Recipient's phone number</td>
<td>phone number; Default: <b>none</b></td>
<td>Phone number(s) that will trigger Auto Reply. To add multiple numbers, click the [[File:Green_plus.png]] symbol.<br>This field becomes visible if the chosen <i>Mode</i> is "From listed numbers only"</td>
</tr>
</table>

[[Category:{{{name}}} WebUI]]