Difference between revisions of "Template:Networking rut manual sms gateway"

From Teltonika Networks Wiki
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{Template: Networking_rutos_manual_fw_disclosure
 +
| fw_version = {{#switch: {{{series}}}
 +
  | RUT2XX = {{{series}}}_R_00.01.13
 +
  | RUT9XX = {{{series}}}_R_00.06.07}}
 +
| series    = {{{series}}}
 +
}}
 
==Summary==
 
==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.
+
The <b>SMS Gateway</b> service is used to set up various SMS related functions, such SMS control via HTTP Post/Get and automated operations such as Scheduled SMS, Email to SMS and SMS Forwarding to HTTP, Email, SMS.
  
==Post/Get Configuration==
+
This chapter of the user manual provides an overview of the SMS Gateway page for {{{name}}} devices.
 +
 
 +
==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 <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.
Line 9: Line 17:
 
The figure below is an example of the Post/Get Configuration page and the table below provides information on fields contained in that page:
 
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}}}]]
+
[[File:Networking_device_manual_sms_gateway_post_get_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>Field name</th>
+
         <th>Field</th>
 
       <th>Value</th>
 
       <th>Value</th>
 
       <th>Description</th>
 
       <th>Description</th>
Line 19: Line 27:
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: <b>no</b></td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMS post/get ON or OFF</td>
+
       <td>Turns SMS post/get on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>Username</td>
+
       <td>User name</td>
       <td>string; Default: <b>user1</b></td>
+
       <td>string; default: <b>user1</b></td>
       <td>User name used for authorization when sending post/get requests</td>
+
       <td>Username used for authorization when sending post/get requests.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Password</td>
 
     <td>Password</td>
         <td>string; Default: <b>user_pass</b></td>
+
         <td>string; default: <b>user_pass</b></td>
         <td>Password used for authorization when sending post/get requests</td>
+
         <td>Password used for authorization when sending post/get requests.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 +
  
 
===SMS Post/Get usage examples===
 
===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:
+
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">
 
<table class="nd-othertables_2">
 
     <tr>
 
     <tr>
         <th width=300">Action</th>
+
         <th width="300">Action</th>
       <th width=852">Post/get URL examples</th>
+
       <th width="852">Post/get URL examples</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>View mobile messages list</td>
 
       <td>View mobile messages list</td>
       <td>http://<span style="color: black;"><b>192.168.1.1</b></span>/cgi-bin/<b>sms_list</b>?<b>username</b>=user1&<b>password</b>=user_pass</td>
+
       <td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_list?username=user1&password=user_pass</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Read mobile message</td>
 
       <td>Read mobile message</td>
       <td>http://<span style="color: black;"><b>192.168.1.1</b></span>/cgi-bin/<b>sms_read</b>?<b>username</b>=user1&<b>password</b>=user_pass&<b>number</b>=1</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>
 
     <tr>
 
     <tr>
     <td>Send mobile message</td>
+
     <td>Send mobile message to a single number</td>
         <td>http://<span style="color: black;"><b>192.168.1.1</b></span>/cgi-bin/<b>sms_send</b>?<b>username</b>=user1&<b>password</b>=user_pass&<b>number</b>=0037060000001&<b>text</b>=testmessage</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>Send mobile message to a group</td>
 +
        <td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_send?username=user1&password=user_pass&group=group_name&text=testmessage</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>View mobile messages total</td>
 
     <td>View mobile messages total</td>
         <td>http://<span style="color: black;"><b>192.168.1.1</b></span>/cgi-bin/<b>sms_total</b>?<b>username</b>=user1&<b>password</b>=user_pass</td>
+
         <td>http://<span style="color: black;">192.168.1.1</span>/cgi-bin/sms_total?username=user1&password=user_pass</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Delete mobile message</td>
 
     <td>Delete mobile message</td>
         <td>http://<span style="color: black;"><b>192.168.1.1</b></span>/cgi-bin/<b>sms_delete</b>?<b>username</b>=user1&<b>password</b>=user_pass&<b>number</b>=1</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>
 
     </tr>
 
</table>
 
</table>
  
 
<ul>
 
<ul>
     <li>192.168.1.1 - 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><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:
 
     <li>SMS related post/get commands. Possible values are:
 
         <ul>
 
         <ul>
 
             <li><i>sms_list</i> - view all SMS messages in storage</li>
 
             <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_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_send</i> - send an SMS message to specified number</li>
 
             <li><i>sms_total</i> - display SMS storage statistics</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>
 
             <li><i>sms_delete</i> - delete a single SMS message by specified SMS index (number)</li>
 
         </ul>
 
         </ul>
 
     </li>
 
     </li>
     <li>username - SMS post/get configuration user name</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>password - SMS post/get configuration password</li>
+
    <li><b>username</b> - SMS POST/GET configuration user name</li>
     <li>number - 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>Phone number format is:
+
     <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>
 
         <ul>
 
             <li><i>00</i> - number must be preceded by two zeros</li>
 
             <li><i>00</i> - number must be preceded by two zeros</li>
Line 84: Line 100:
 
             <li><i><receivers_number></i> - phone number of the recipient</li>
 
             <li><i><receivers_number></i> - phone number of the recipient</li>
 
         </ul>
 
         </ul>
For example, a valid number would be <b>0037012345678</b> (370 is country code and 12345678 is the receiver's phone number)
+
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>
     <li>text - SMS message text</li>
+
     <li><b>text</b> - SMS message text</li>
 
</ul>
 
</ul>
<!--
+
 
 
==Email to SMS==
 
==Email to SMS==
  
Email to SMS is a function that checks your email’s inbox at the specified frequency and, if it finds any new received emails with a specific subject, it converts them to SMS messages.
+
<b>Email to SMS</b> is a function that connects to your email account and checks its inbox at the specified frequency. If it finds any new received emails with a specific subject (phone number in email subject), it sends the body of the email as an SMS message(s) to the recipient specified in the email subject field.
  
'''NOTE''': all POP3 server email messages from inbox will be deleted.
+
<b>Important note</b>: all POP3 server email messages from inbox will be deleted when using this service.
  
 
+
[[File:Networking_device_manual_sms_gateway_email_to_sms_v1.png]]
[[Image: Services sms gateway emailtosms.PNG]]
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles Email to SMS ON or OFF</td>
+
       <td>Turns Email to SMS on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>POP3 server</td>
 
       <td>POP3 server</td>
       <td>host | ip; Default: " "</td>
+
       <td>host | ip; default: <b>none</b></td>
       <td>Your email service provider's POP3 server address. If you don't know this address, simply look it up online</td>
+
       <td>Email service provider's POP3 server address (can be looked up online).</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Server port</td>
 
     <td>Server port</td>
         <td>integer [0..65535]; Default: " "</td>
+
         <td>integer [0..65535]; default: <b>none</b></td>
         <td>Server authentication port. As with POP3 server, your email service provider's POP3 port can be looked up online</td>
+
         <td>Email service provider's POP3 server port (can be looked up online).</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>User name</td>
 
     <td>User name</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>Your email account’s user name</td>
+
         <td>Email account username, used in authentication when connecting to the email client.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Password</td>
 
       <td>Password</td>
       <td>string; Default: " "</td>
+
       <td>string; default: <b>none</b></td>
       <td>Your email account’s password</td>
+
       <td>Email account password, used in authentication when connecting to the email client.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Secure connection (SSL)</td>
 
     <td>Secure connection (SSL)</td>
         <td>yes | no; Default: '''no'''</td>
+
         <td>yes | no; default: <b>no</b></td>
         <td>'''SSL''' is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message</td>
+
         <td><b>SSL</b> is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message.</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Max. email symbol count</td>
 +
        <td>integer; default: <b>160</b></td>
 +
        <td>Limit of symbols that can be contained in the email body of text. Emails that contain more symbols than it is specified in this field will be ignored.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Check email every</td>
 
     <td>Check email every</td>
         <td>time; Default: '''1 minute'''</td>
+
         <td>time [1 minute to 15 days]; default: <b>1 minute</b></td>
         <td>Time interval to check email inbox</td>
+
         <td>Email inbox check interval.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
You may have noticed that there is no option where you can specify recipient's phone number. The reason for that is that '''Email to SMS''' doesn't forward all emails, only the ones that are meant to be forwarded. Only emails with the recipient's phone number in the subject will be forwarded (to the number specified in the subject). Phone number must contain country code. Phone number format is: 00{COUNTRY_CODE} {RECEIVER_NUMBER}, e.g., 0037062312345 (370 is country code and 62312345 is receiver's phone number)
+
<b>Additional note</b>: you may have noticed that there is no option where you can specify  
 +
the recipient's phone number. As mentioned earlier, <b>Email to SMS</b> doesn't forward all  
 +
emails, just the ones that are meant to be forwarded. Only emails with the recipient's  
 +
phone number in the subject will be forwarded to SMS.
 +
 
 +
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>0037000000000</b> (370 is country code and 00000000 is the receiver's phone number, all preceded by 00).
  
 
==Scheduled SMS==
 
==Scheduled SMS==
  
'''Scheduled SMS''' allows you to periodically send automated SMS messages to a specified number. Scheduled messages are managed in rule form, i.e., similar to '''SMS Utilities'''. 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 '''Phone number''' field located in the '''Scheduled Messages Configuration''' section and press the '''Add''' button located next to it.
+
<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:
  
After this you will be redirected to the '''Scheduled Messages Configuration''' window.
+
[[File:Networking_device_manual_sms_gateway_scheduled_sms_v2.png]]
  
 
===Scheduled Messages Configuration===
 
===Scheduled Messages Configuration===
 
----
 
----
'''Scheduled messages''' provides you with the possibility to set up a rule that sends SMS messages to specified recipients periodically. To create a new rule, enter the recipient's Phone number and Message sending interval and click the "Add" button. The new rule will appear in the "Messages to send" table, but will be disabled and unconfigured. To configure your rule, simply click the "Edit" button located next to it.
+
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:Networking_device_manual_sms_gateway_scheduled_sms_configuration_v1.png]]
[[Image:Services sms gateway scheduled.PNG ]]
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles the rule ON or OFF</td>
+
       <td>Turns the rule on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Recipient's phone number</td>
 
       <td>Recipient's phone number</td>
       <td>phone number; Default: " "</td>
+
       <td>phone number; default: <b>none</b></td>
       <td>Phone number that will receive the scheduled messages</td>
+
       <td>Phone number of the recipient that will receive the scheduled messages.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Message text</td>
 
     <td>Message text</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>The message that will be sent</td>
+
         <td>The message that will be sent.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Message sending interval</td>
 
     <td>Message sending interval</td>
         <td>time; Default: '''Day, hour 1, minute 1'''</td>
+
         <td>time; default: <b>Day, hour 1, minute 1</b></td>
         <td>The frequency at which scheduled messages will be sent</td>
+
         <td>The frequency at which scheduled messages will be sent.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
Line 186: Line 219:
 
==Auto Reply==
 
==Auto Reply==
  
'''Auto reply''' allows you to configure automatic replying to SMS messages that the router receives from everyone or from listed numbers only.
+
<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:
  
[[Image:Services sms gateway auto reply.PNG]]
+
[[File:Networking_device_manual_sms_gateway_auto_reply_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles Auto Reply ON or OFF</td>
+
       <td>Turns Auto Reply on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Reply SMS Utilities rules</td>
 
       <td>Reply SMS Utilities rules</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>If enabled, the router will auto reply even SMS Utilieties rules</td>
+
       <td>When enabled, the router will also reply to messages that trigger [[{{{name}}} SMS Utilities|SMS Utilities]] rules.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Don't save received messages</td>
 
     <td>Don't save received messages</td>
         <td>yes | no; Default: '''no'''</td>
+
         <td>yes | no; default: <b>no</b></td>
         <td>If enabled, the router will delete received SMS messages</td>
+
         <td>When enabled, the router deletes all received SMS messages.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Mode</td>
+
     <td>Message text</td>
         <td>Everyone | From listed number only; Default: '''Everyone'''</td>
+
         <td>string; default: <b>none</b></td>
         <td>Specifies whether to auto reply to every phone number or just just specified phone numbers</td>
+
         <td>Text that will be sent in the automatic response.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Message text</td>
+
     <td>Mode</td>
         <td>string; Default: " "</td>
+
         <td>Everyone | Listed numbers; default: <b>Everyone</b></td>
         <td>The message that will be sent in reply</td>
+
         <td>Indicates whether the router should reply to messages from all recipients or just the specified numbers.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Recipient's phone number</td>
 
     <td>Recipient's phone number</td>
         <td>phone number; Default: " "</td>
+
         <td>phone number; default: <b>none</b></td>
         <td>Phone number(s) that will qualify for Auto Reply. To add more numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol. This field only becomes visible if the chosen Mode is '''From listed numbers only'''</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>
 
     </tr>
 
</table>
 
</table>
  
 
==SMS Forwarding==
 
==SMS Forwarding==
 +
 +
The <b>SMS Forwarding</b> tab contains three sections:
 +
 +
<ul>
 +
    <li>[[{{{name}}} SMS Gateway#SMS_Forwarding_To_HTTP|SMS Forwarding To HTTP]]</li>
 +
    <li>[[{{{name}}} SMS Gateway#SMS_Forwarding_To_SMS|SMS Forwarding To SMS]]</li>
 +
    <li>[[{{{name}}} SMS Gateway#SMS_Forwarding_To_Email|SMS Forwarding To Email]]</li>
 +
</ul>
 +
 +
Each of which can be used to set up forwarding of incoming SMS message to either HTTP, email or another phone number.
  
 
===SMS Forwarding To HTTP===
 
===SMS Forwarding To HTTP===
 
----
 
----
The SMS Forwarding To HTTP functionality forwards SMS messages to HTTP, using either POST or GET methods.
+
The <b>SMS Forwarding To HTTP</b> function forwards received SMS messages to HTTP by using either Post or Get methods. The figure below is an example of the SMS Forwarding To HTTP section and the table below provides information on the configuration fields contained in that section:
  
[[Image:Services sms gateway forwarding http.PNG]]
+
[[File:Networking_device_manual_sms_gateway_sms_forwarding_http_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMS Forwarding To HTTP ON or OFF</td>
+
       <td>Turns SMS Forwarding To HTTP on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Forward SMS Utilities rules</td>
 
       <td>Forward SMS Utilities rules</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>If enabled, the router will also forward SMS Utilities rules to HTTP</td>
+
       <td>When checked, the router will also forward SMS Utilities rules. By default router will not forward SMS messages which are SMS Utilities rules.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Use HTTPS</td>
 
     <td>Use HTTPS</td>
         <td>yes | no; Default: '''no'''</td>
+
         <td>yes | no; default: <b>no</b></td>
         <td>ses the HTTPS protocol instead of HTTP</td>
+
         <td>Check to use the HTTPS protocol instead of HTTP.</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Encode message text to Base64</td>
 +
        <td>yes | no; default: <b>no</b></td>
 +
        <td>Message text will be encoded to a Base64 string. Enable this to preserve Unicode characters in the message text.</td>
 +
    </tr>
 +
    <tr>
 +
    <td>HTTPS Certificate verification</td>
 +
        <td>Ignore | Verify; default: <b>Ignore</b></td>
 +
        <td>Indicates whether the server's certificate will be ignored or verified.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Method</td>
 
     <td>Method</td>
         <td>Post | Get; Default: '''Get'''</td>
+
         <td>Post | Get; default: <b>Get</b></td>
         <td>Defines the HTTP transfer method</td>
+
         <td>Defines the HTTP transfer method.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>URL</td>
 
       <td>URL</td>
       <td>host | ip; Default: " "</td>
+
       <td>host | ip | host:port | ip:port; default: <b>none</b></td>
       <td>URL address to forward messages to</td>
+
       <td>URL or IP address to which the messages will be forwarded. By default, the router forward messages to the default HTTP port (port 80). To specify a different port add a <b>colon</b> (<b>:</b>) symbol followed by the port number (for example, 192.168.1.1:81).</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Number value name</td>
 
       <td>Number value name</td>
       <td>string; Default: " "</td>
+
       <td>string; default: <b>none</b></td>
       <td>Name to assign to sender’s phone number value in query string</td>
+
       <td>Name to assign the sender’s phone number value in query string.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Message value name</td>
 
     <td>Message value name</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>Name to assign to message text value in query string</td>
+
         <td>Name to assign the message text value in query string.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Extra data pair 1 / Extra data pair 2</td>
 
     <td>Extra data pair 1 / Extra data pair 2</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>If you want to transfer some extra information through the HTTP query, enter variable name on the left field and its value on the right</td>
+
         <td>Transfers extra information through the HTTP request. Enter variable name on the left field and its value on the right.<br>For example, when using the Post method, one may enter some static information about the device, like 'Router name' on the left and '{{{name}}}' on the right.<br>This can also be utilized when using the Get method to request data from an HTTP server.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Mode</td>
 
     <td>Mode</td>
         <td>All messages | From listed numbers; Default: '''All messages'''</td>
+
         <td>All messages | From listed numbers; default: <b>All messages</b></td>
         <td>Specifies which messages to forward</td>
+
         <td>Specifies whether all messages should be forwarded or only those received from specific numbers.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Sneder's phone number</td>
+
     <td>Sender's phone number</td>
         <td>phone number; Default: " "</td>
+
         <td>phone number; default: <b>none</b></td>
         <td>Phone number(s) that will qualify for forwarding. To add more numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol. This field only becomes visible if the chosen Mode is '''From listed numbers'''</td>
+
         <td>Phone number(s) that will qualify for forwarding. To add multiple numbers, click the [[File:Services sms gateway auto reply plus symbol.PNG]] symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
===SMS Forwarding To SMS Configuration===
+
====Forwarding To HTTP example====
 
----
 
----
The '''SMS Forwarding To SMS''' function forwards SMS messages to one or several recipients.
+
This example will atempt to explain how to use the data fields in SMS forwarding to HTTP configuration. The fields in question are <i>Number & Message value name</i> and <i>Extra data pair 1 & 2</i> fields. The figure below is the configuration we'll be using for this example:
 +
 
 +
[[File:Networking_{{lc:{{{name}}}}}_manual_sms_gateway_sms_forwarding_http_example_v1.png]]
  
[[Image:Services sms gateway forwarding sms.PNG]]
+
If you configure the router as seen in the image above and send an SMS message to the router containing the text <i>Hello!</i>, from the number <i>+37000000000</i>, the specified server should reiceve an encoded query string that looks like this:
 +
 
 +
Sender=%2B37000000000&Text=Hello%21&Name={{{name}}}&Code={{{code_encoded}}}
 +
 
 +
The <i>&</i> symbol separates the the key-value pairs, while certain characters (like <i>+</i>, <i>!</i> and the <i>space</i> symbol) are encoded in UTF-8. When decoded it might look something like this:
 +
 
 +
Sender: +37000000000
 +
Text: Hello!
 +
Name: {{{name}}}
 +
Code: {{{code_decoded}}}
 +
 
 +
===SMS Forwarding To SMS===
 +
----
 +
The <b>SMS Forwarding To SMS</b> function forwards received SMS messages to one or several other
 +
phone numbers. The figure below is an example of the SMS Forwarding To SMS section and the
 +
table below provides information on the configuration fields contained in that section:
 +
 
 +
[[File:Networking_device_manual_sms_gateway_sms_forwarding_sms_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMS Forwarding To SMS ON or OFF</td>
+
       <td>Turns SMS Forwarding To SMS on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Forward SMS Utilities rules</td>
 
       <td>Forward SMS Utilities rules</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>If enabled, the router will also forward SMS Utilities rules to SMS</td>
+
       <td>When checked the router will also forward SMS Utilities rules. By default router will not forward SMS messages which are SMS Utilities rules.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Add sender number</td>
+
     <td>Add sender's number</td>
         <td>yes | no; Default: '''no'''</td>
+
         <td>yes | no; default: <b>no</b></td>
         <td>Adds original sender’s number of the forwarded message</td>
+
         <td>Adds the original sender’s number to the forwarded message.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Mode</td>
 
     <td>Mode</td>
         <td>All messages | From listed numbers; Default: '''All messages'''</td>
+
         <td>All messages | From listed numbers; default: <b>All messages</b></td>
         <td>Specifies which messages to forward</td>
+
         <td>Specifies whether all messages should be forwarded or only those received from specific numbers.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Sender's phone number(s)</td>
+
     <td>Sender's phone number</td>
         <td>phone number; Default: " "</td>
+
         <td>phone number; default: <b>none</b></td>
         <td>Phone number(s) that will qualify for forwarding. To add more numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol. This field only becomes visible if the chosen Mode is '''From listed numbers'''</td>
+
         <td>Phone number(s) that will qualify for forwarding. To add multiple numbers, click the [[File:Services sms gateway auto reply plus symbol.PNG]] symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Recipient's phone number(s)</td>
 
     <td>Recipient's phone number(s)</td>
         <td>phone number; Default: " "</td>
+
         <td>phone number; default: <b>none</b></td>
         <td>Phone number(s) to which messages are going to be forwarded to. To add more numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol</td>
+
         <td>Phone number(s) to which messages are going to be forwarded to. To add multiple numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
===SMS Forwarding To Email Configuration===
+
===SMS Forwarding To Email===
 
----
 
----
The '''SMS Forwarding To Email''' function forwards SMS messages to email.
+
The <b>SMS Forwarding To Email</b> function forwards received SMS messages to one or several
 +
email addresses. If this service is enabled and configured correctly, when the router receives
 +
an SMS message it will automatically login to the specified email account and send the
 +
text message as an email to another specified recipient(s).
 +
 
 +
The figure below is an example of the SMS Forwarding To Email section and the table
 +
below provides information on the configuration fields contained in that section:
  
[[Image:Services sms gateway forwarding email.PNG]]
+
[[File:Networking_device_manual_sms_gateway_sms_forwarding_email_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMS Forwarding To SMS ON or OFF</td>
+
       <td>Turns SMS Forwarding To Email on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Forward SMS Utilities rules</td>
 
       <td>Forward SMS Utilities rules</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>If enabled, the router will also forward SMS Utilities rules to Email</td>
+
       <td>When checked the router will also forward SMS Utilities rules (the default action is to not forward SMS messages that are SMS Utilities rule).</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Add sender number</td>
+
    <td>Add sender's number</td>
      <td>yes | no; Default: '''no'''</td>
+
        <td>yes | no; default: <b>no</b></td>
      <td>Adds original sender’s number of the forwarded message</td>
+
        <td>Adds the original sender’s number to the forwarded message.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Subject</td>
 
     <td>Subject</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>Text that will be inserted in the email’s Subject field</td>
+
         <td>Text that will be inserted into the email's Subject field.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>SMTP server</td>
 
     <td>SMTP server</td>
         <td>host | ip; Default: " "</td>
+
         <td>host | ip; default: <b>none</b></td>
         <td>Your email service provider's SMTP server’s address. If you don't know this address, you can look it up online</td>
+
         <td>Your email service provider's SMTP server address. If you don't know this address, you can look it up online.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>SMTP port</td>
 
       <td>SMTP port</td>
       <td>integer [0..65535]; Default: " "</td>
+
       <td>integer [0..65535]; default: <b>none</b></td>
       <td>Your email service provider's SMTP server’s port. If you don't know the port number, you can look it up online</td>
+
       <td>Your email service provider's SMTP server port. If you don't know the port number, you can look it up online.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Secure connection</td>
 
       <td>Secure connection</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Enables the use of cryptographic protocols. Enable only if your SMTP server supports SSL or TLS</td>
+
       <td>Enables the use of cryptographic protocols. Enable only if your SMTP server supports SSL or TLS.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>User name</td>
 
     <td>User name</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>Your email account's login user name</td>
+
         <td>Your email account's login user name.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Password</td>
 
     <td>Password</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>none</b></td>
         <td>Your email account's login password</td>
+
         <td>Your email account's login password.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Sender's email address</td>
 
       <td>Sender's email address</td>
       <td>email; Default: " "</td>
+
       <td>email address; default: <b>none</b></td>
       <td>The address that will be used to send emails from</td>
+
       <td>The address that will be used to send emails from.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Recipient's email address</td>
 
     <td>Recipient's email address</td>
         <td>email; Default: " "</td>
+
         <td>email address; default: <b>none</b></td>
         <td>Address to which messages will be forwarded to</td>
+
         <td>The address(es) to which incoming SMS messages will be forwarded. To add multiple addresses, click the [[File:Services sms gateway auto reply plus symbol.PNG]] symbol.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Mode</td>
 
     <td>Mode</td>
         <td>All messages | From listed numbers; Default: '''All messages'''</td>
+
         <td>All messages | From listed numbers; default: <b>All messages</b></td>
         <td>Specifies which messages to forward</td>
+
         <td>Specifies whether all messages should be forwarded or only those received from specific numbers.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
     <td>Sender's phone number(s)</td>
+
     <td>Sender's phone number</td>
         <td>phone number; Default: " "</td>
+
         <td>phone number; default: <b>none</b></td>
         <td>Phone number(s) that will qualify for forwarding. To add more numbers, click the [[Image:Services sms gateway auto reply plus symbol.PNG]] symbol. This field only becomes visible if the chosen Mode is '''From listed numbers'''</td>
+
         <td>Phone number(s) that will qualify for forwarding. To add multiple numbers, click the [[File:Services sms gateway auto reply plus symbol.PNG]] symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
 +
  
 
==SMPP==
 
==SMPP==
  
The Short Message Peer-to-Peer ('''SMPP''') is a protocol used for exchanging SMS messages between Short Message Service Centers (SMSC) and/or External Short Messaging Entities (ESME).
+
<b>Short Message Peer-to-Peer</b> (<b>SMPP</b>) is a protocol used for exchanging SMS messages between Short Message Service Centers (SMSC) and/or External Short Messaging Entities (ESME). The figure below is an example of the SMPP section and the table below provides information on the configuration fields contained in that section:
  
[[Image:Services sms gateway smpp.PNG]]
+
[[File:Networking_device_manual_sms_gateway_smpp_v1.png]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th>Field</th>
       <th>value</th>
+
       <th>Value</th>
       <th>description</th>
+
       <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>Enable</td>
 
       <td>Enable</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>no</b></td>
       <td>Toggles SMPP ON or OFF</td>
+
       <td>Turns SMPP on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
       <td>User name</td>
 
       <td>User name</td>
       <td>yes | no; Default: '''no'''</td>
+
       <td>yes | no; default: <b>admin</b></td>
       <td>User name used for authentication on the SMPP server</td>
+
       <td>User name used for authentication on the SMPP server.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Password</td>
 
     <td>Password</td>
         <td>string; Default: " "</td>
+
         <td>string; default: <b>admin01</b></td>
         <td>Password used for authentication on the SMPP server</td>
+
         <td>Password used for authentication on the SMPP server.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
     <td>Server port</td>
 
     <td>Server port</td>
         <td>integer [0..65535]; Default: " "</td>
+
         <td>integer [0..65535]; default: <b>7777</b></td>
         <td>SMPP server's port</td>
+
         <td>SMPP server port.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
  
[[Category:{{{name}}} WebUI]]
+
[[Category:{{{name}}} Services section]]
-->
 

Revision as of 15:05, 4 March 2021

Template:Networking rutos manual fw disclosure

Summary

The SMS Gateway service is used to set up various SMS related functions, such SMS control via HTTP Post/Get and automated operations such as Scheduled SMS, Email to SMS and SMS Forwarding to HTTP, Email, SMS.

This chapter of the user manual provides an overview of the SMS Gateway page for {{{name}}} devices.

Post/Get

The Post/Get Configuration 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:

Networking device manual sms gateway post get v1.png

Field Value Description
Enable yes | no; default: no Turns SMS post/get on or off.
User name string; default: user1 Username used for authorization when sending post/get requests.
Password string; default: user_pass Password used for authorization when sending post/get requests.


SMS Post/Get usage examples


Use a web browser or any other compatible software to send HTTP POST/GET strings to the router. The router must be connected to a GSM network when using the Send SMS feature. Below you will find a table with possible actions and examples on how to use them:

Action Post/get URL examples
View mobile messages list http://192.168.1.1/cgi-bin/sms_list?username=user1&password=user_pass
Read mobile message http://192.168.1.1/cgi-bin/sms_read?username=user1&password=user_pass&number=1
Send mobile message to a single number http://192.168.1.1/cgi-bin/sms_send?username=user1&password=user_pass&number=0037060000001&text=testmessage
Send mobile message to a group http://192.168.1.1/cgi-bin/sms_send?username=user1&password=user_pass&group=group_name&text=testmessage
View mobile messages total http://192.168.1.1/cgi-bin/sms_total?username=user1&password=user_pass
Delete mobile message http://192.168.1.1/cgi-bin/sms_delete?username=user1&password=user_pass&number=1
  • 192.168.1.1 - router's IP address, replace it with your [[{{{name}}}_LAN#General_Setup|LAN IP]] or [[{{{name}}}_WAN#Operation_Modes|WAN IP]] (when connecting remotely)
  • SMS related post/get commands. Possible values are:
    • sms_list - view all SMS messages in storage
    • sms_read - read a single SMS message by specified SMS index (number)
    • sms_send - send an SMS message to specified number
    • sms_total - display SMS storage statistics
    • sms_delete - delete a single SMS message by specified SMS index (number)
  • & - separation symbol. After specifying the SMS command, other parameters must be separated by an ampersand (&) symbol
  • username - SMS POST/GET configuration user name
  • password - SMS POST/GET configuration password
  • number - SMS message index or (depending on context) recipient's phone number. SMS message indexes can be viewed with the sms_list command.
    Correct phone number format is:
    • 00 - number must be preceded by two zeros
    • <country_code> - the next following element is the number holder's country code
    • <receivers_number> - phone number of the recipient

    For example, a valid number would be 0037012345678 (370 is country code and 12345678 is the receiver's phone number, all preceded by 00)

  • text - SMS message text

Email to SMS

Email to SMS is a function that connects to your email account and checks its inbox at the specified frequency. If it finds any new received emails with a specific subject (phone number in email subject), it sends the body of the email as an SMS message(s) to the recipient specified in the email subject field.

Important note: all POP3 server email messages from inbox will be deleted when using this service.

Networking device manual sms gateway email to sms v1.png

Field Value Description
Enable yes | no; default: no Turns Email to SMS on or off.
POP3 server host | ip; default: none Email service provider's POP3 server address (can be looked up online).
Server port integer [0..65535]; default: none Email service provider's POP3 server port (can be looked up online).
User name string; default: none Email account username, used in authentication when connecting to the email client.
Password string; default: none Email account password, used in authentication when connecting to the email client.
Secure connection (SSL) yes | no; default: no SSL is a protocol for transmitting private documents via the Internet. SSL uses a cryptographic system that uses two keys to encrypt data − a public key known to everyone and a private or secret key known only to the recipient of the message.
Max. email symbol count integer; default: 160 Limit of symbols that can be contained in the email body of text. Emails that contain more symbols than it is specified in this field will be ignored.
Check email every time [1 minute to 15 days]; default: 1 minute Email inbox check interval.

Additional note: you may have noticed that there is no option where you can specify the recipient's phone number. As mentioned earlier, Email to SMS doesn't forward all emails, just the ones that are meant to be forwarded. Only emails with the recipient's phone number in the subject will be forwarded to SMS.

Correct phone number format is:

  • 00 - number must be preceded by two zeros
  • <country_code> - the next following element is the number holder's country code
  • <receivers_number> - phone number of the recipient

For example, a valid number would be 0037000000000 (370 is country code and 00000000 is the receiver's phone number, all preceded by 00).

Scheduled SMS

Scheduled SMS 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 Phone number field located in the Scheduled Messages Configuration section and click the Add button located next to it.

After this you will be redirected to the Scheduled Messages Configuration 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 Messages To Send section:

Networking device manual sms gateway scheduled sms v2.png

Scheduled Messages Configuration


The figure below is an example of the Scheduled Messages Configuration window and the table below provides information on the field contained in that window:

File:Networking device manual sms gateway scheduled sms configuration v1.png

Field Value Description
Enable yes | no; default: no Turns the rule on or off.
Recipient's phone number phone number; default: none Phone number of the recipient that will receive the scheduled messages.
Message text string; default: none The message that will be sent.
Message sending interval time; default: Day, hour 1, minute 1 The frequency at which scheduled messages will be sent.

Auto Reply

Auto reply 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:

Networking device manual sms gateway auto reply v1.png

Field Value Description
Enable yes | no; default: no Turns Auto Reply on or off.
Reply SMS Utilities rules yes | no; default: no When enabled, the router will also reply to messages that trigger [[{{{name}}} SMS Utilities|SMS Utilities]] rules.
Don't save received messages yes | no; default: no When enabled, the router deletes all received SMS messages.
Message text string; default: none Text that will be sent in the automatic response.
Mode Everyone | Listed numbers; default: Everyone Indicates whether the router should reply to messages from all recipients or just the specified numbers.
Recipient's phone number phone number; default: none Phone number(s) that will trigger Auto Reply. To add multiple numbers, click the Green plus.png symbol.
This field becomes visible if the chosen Mode is "From listed numbers only".

SMS Forwarding

The SMS Forwarding tab contains three sections:

  • [[{{{name}}} SMS Gateway#SMS_Forwarding_To_HTTP|SMS Forwarding To HTTP]]
  • [[{{{name}}} SMS Gateway#SMS_Forwarding_To_SMS|SMS Forwarding To SMS]]
  • [[{{{name}}} SMS Gateway#SMS_Forwarding_To_Email|SMS Forwarding To Email]]

Each of which can be used to set up forwarding of incoming SMS message to either HTTP, email or another phone number.

SMS Forwarding To HTTP


The SMS Forwarding To HTTP function forwards received SMS messages to HTTP by using either Post or Get methods. The figure below is an example of the SMS Forwarding To HTTP section and the table below provides information on the configuration fields contained in that section:

Networking device manual sms gateway sms forwarding http v1.png

Field Value Description
Enable yes | no; default: no Turns SMS Forwarding To HTTP on or off.
Forward SMS Utilities rules yes | no; default: no When checked, the router will also forward SMS Utilities rules. By default router will not forward SMS messages which are SMS Utilities rules.
Use HTTPS yes | no; default: no Check to use the HTTPS protocol instead of HTTP.
Encode message text to Base64 yes | no; default: no Message text will be encoded to a Base64 string. Enable this to preserve Unicode characters in the message text.
HTTPS Certificate verification Ignore | Verify; default: Ignore Indicates whether the server's certificate will be ignored or verified.
Method Post | Get; default: Get Defines the HTTP transfer method.
URL host | ip | host:port | ip:port; default: none URL or IP address to which the messages will be forwarded. By default, the router forward messages to the default HTTP port (port 80). To specify a different port add a colon (:) symbol followed by the port number (for example, 192.168.1.1:81).
Number value name string; default: none Name to assign the sender’s phone number value in query string.
Message value name string; default: none Name to assign the message text value in query string.
Extra data pair 1 / Extra data pair 2 string; default: none Transfers extra information through the HTTP request. Enter variable name on the left field and its value on the right.
For example, when using the Post method, one may enter some static information about the device, like 'Router name' on the left and '{{{name}}}' on the right.
This can also be utilized when using the Get method to request data from an HTTP server.
Mode All messages | From listed numbers; default: All messages Specifies whether all messages should be forwarded or only those received from specific numbers.
Sender's phone number phone number; default: none Phone number(s) that will qualify for forwarding. To add multiple numbers, click the Services sms gateway auto reply plus symbol.PNG symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.

Forwarding To HTTP example


This example will atempt to explain how to use the data fields in SMS forwarding to HTTP configuration. The fields in question are Number & Message value name and Extra data pair 1 & 2 fields. The figure below is the configuration we'll be using for this example:

[[File:Networking_{{{name}}}_manual_sms_gateway_sms_forwarding_http_example_v1.png]]

If you configure the router as seen in the image above and send an SMS message to the router containing the text Hello!, from the number +37000000000, the specified server should reiceve an encoded query string that looks like this:

Sender=%2B37000000000&Text=Hello%21&Name={{{name}}}&Code={{{code_encoded}}}

The & symbol separates the the key-value pairs, while certain characters (like +, ! and the space symbol) are encoded in UTF-8. When decoded it might look something like this:

Sender: +37000000000
Text: Hello!
Name: {{{name}}}
Code: {{{code_decoded}}}

SMS Forwarding To SMS


The SMS Forwarding To SMS function forwards received SMS messages to one or several other phone numbers. The figure below is an example of the SMS Forwarding To SMS section and the table below provides information on the configuration fields contained in that section:

Networking device manual sms gateway sms forwarding sms v1.png

Field Value Description
Enable yes | no; default: no Turns SMS Forwarding To SMS on or off.
Forward SMS Utilities rules yes | no; default: no When checked the router will also forward SMS Utilities rules. By default router will not forward SMS messages which are SMS Utilities rules.
Add sender's number yes | no; default: no Adds the original sender’s number to the forwarded message.
Mode All messages | From listed numbers; default: All messages Specifies whether all messages should be forwarded or only those received from specific numbers.
Sender's phone number phone number; default: none Phone number(s) that will qualify for forwarding. To add multiple numbers, click the Services sms gateway auto reply plus symbol.PNG symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.
Recipient's phone number(s) phone number; default: none Phone number(s) to which messages are going to be forwarded to. To add multiple numbers, click the Services sms gateway auto reply plus symbol.PNG symbol.

SMS Forwarding To Email


The SMS Forwarding To Email function forwards received SMS messages to one or several email addresses. If this service is enabled and configured correctly, when the router receives an SMS message it will automatically login to the specified email account and send the text message as an email to another specified recipient(s).

The figure below is an example of the SMS Forwarding To Email section and the table below provides information on the configuration fields contained in that section:

Networking device manual sms gateway sms forwarding email v1.png

Field Value Description
Enable yes | no; default: no Turns SMS Forwarding To Email on or off.
Forward SMS Utilities rules yes | no; default: no When checked the router will also forward SMS Utilities rules (the default action is to not forward SMS messages that are SMS Utilities rule).
Add sender's number yes | no; default: no Adds the original sender’s number to the forwarded message.
Subject string; default: none Text that will be inserted into the email's Subject field.
SMTP server host | ip; default: none Your email service provider's SMTP server address. If you don't know this address, you can look it up online.
SMTP port integer [0..65535]; default: none Your email service provider's SMTP server port. If you don't know the port number, you can look it up online.
Secure connection yes | no; default: no Enables the use of cryptographic protocols. Enable only if your SMTP server supports SSL or TLS.
User name string; default: none Your email account's login user name.
Password string; default: none Your email account's login password.
Sender's email address email address; default: none The address that will be used to send emails from.
Recipient's email address email address; default: none The address(es) to which incoming SMS messages will be forwarded. To add multiple addresses, click the Services sms gateway auto reply plus symbol.PNG symbol.
Mode All messages | From listed numbers; default: All messages Specifies whether all messages should be forwarded or only those received from specific numbers.
Sender's phone number phone number; default: none Phone number(s) that will qualify for forwarding. To add multiple numbers, click the Services sms gateway auto reply plus symbol.PNG symbol. This field becomes visible when the "Mode" field value is set to 'From listed numbers'.


SMPP

Short Message Peer-to-Peer (SMPP) is a protocol used for exchanging SMS messages between Short Message Service Centers (SMSC) and/or External Short Messaging Entities (ESME). The figure below is an example of the SMPP section and the table below provides information on the configuration fields contained in that section:

Networking device manual sms gateway smpp v1.png

Field Value Description
Enable yes | no; default: no Turns SMPP on or off.
User name yes | no; default: admin User name used for authentication on the SMPP server.
Password string; default: admin01 Password used for authentication on the SMPP server.
Server port integer [0..65535]; default: 7777 SMPP server port.

[[Category:{{{name}}} Services section]]