SMTP (E-mail to SMS) Connection
This chapter provides detailed instructions on how to install and configure and SMTP (E-mail to SMS)
service provider connection to send SMS messages through E-mail to SMS services using Ozeki NG - SMS Gateway
As you can read on the Service Provider Connections page, you need to install and configure one or
more service provider connections for SMS messaging using Ozeki NG - SMS Gateway. One of the service
provider connections supported by the software is the SMTP (E-mail to SMS) connection.
The SMTP (E-mail to SMS) connection can be used to send SMS messages through E-mail to SMS services. E-mail
to SMS connectivity is provided by many mobile network operators and multichannel IP based GSM gateways. If
you install this connection, you can connect to these services.
You can install and configure this connection using the graphical user interface of Ozeki NG - SMS Gateway.
To start installing and configuring an SMTP (E-mail to SMS) connection, click the Add button in the top
right-hand corner of the Service providers panel on the left of the Management Console interface. (To
find out how to open this interface, check out the Quickstart Guide.).
You can also add a service provider connection by clicking the Add service provider item in the
Service providers menu.
After you have clicked on of these, the Add service provider panel will show up on the right of the
interface. The panel contains a list of protocols you can install and use for communication with an SMS service provider.
To select the SMTP (E-mail to SMS) connection, click the Install link in the respective entry in the list (Figure 1).
Figure 1 - Starting to install the SMTP (E-mail to SMS) connection
When you have installed the SMTP (E-mail to SMS) connection, the Configuration panel will show
up on the right of the interface. The first tab of the panel is the General tab, which consists of an
E-mail parameters (outgoing messages) and an SMTP server settings section.
In the E-mail parameters (outgoing messages) section, specify the outgoing e-mail messages' parameters (Figure 2).
These areFrom, To, Subject and Body. You can use keywords in these parameter values, these are:
$recipient (the SMS message's recipient) and $messagetext (the SMS message's text).
Figure 2 - The General settings tab
In the SMTP server settings section, provide the hostname or IP address of the SMTP server you will use to
send outgoing e-mail messages. This can be the same e-mail server you have configured in Outlook.
Type in the hostname to the SMTP server host field and the port to the SMTP server port field.
Note that the above values are mandatory to have the SMTP connection working correctly.
Under the Advanced tab, you can specify advanced parameters. There are three sections here: Optional SMTP Settings,
Charset encoding and Identification (Figure 3).
Figure 3 - The Advanced settings tab
In the Optional SMTP Settings section, you can specify your SMTP username and password if you have an SMTP server that
requires authentication. For this case, check My SMTP server requires authentication checkbox and fill in SMTP Username
and SMTP Password fields.
If your SMTP server requires SSL connection, then check My SMTP server requires SSL connection checkbox too.
In the Charset encoding section, you can specify the charset encoding used to encode your messages' body and subject by
selecting the appropriate values for the Body encoding and Subject encoding fields.
In the Identification section, you can specify the telephone number assigned to this connection and the
service provider connection name. Enter these values in the Telephone number and Service provider name fields.
Note, that you must add the telephone number in international format: starting with "+". You can check the overridable
checkbox to the right of the Telephone number. This ensures that you can replace the
phone number specified in the Telephone number field with a different one to be displayed as the sender of an outgoing message.
You can also replace the number with (alphanumeric) text consisting of a maximum of eleven (11) characters. Therefore, when a message
is sent out, e.g. using the Database
user, you can specify any different phone number or a name to be displayed as the sender of the message.
To configure logging, click the Logging tab in the Configuration panel.
The tab has a Logging and a Log file settings section. Here, you
can choose whether to make the program write log entries about sent and received
messages in human readable format and/or log low level communication. Choosing the
latter option will make the program produce logfiles containing binary codes representing the communication data.
You should check at least the Log sent and received messages in human readable format
checkbox, as logfiles can be useful in debugging communication problems (Figure 4).
Figure 4 - The Logging tab
In the Log file settings section of the tab, you can make specifications
for the size and the number of available logfiles. Log rotation saves disk
space, as it ensures that older (and probably no longer needed) logfiles will be
automatically deleted from the log directory, which is specified in the Log directory field.
By default, the access path to the logfiles is: C:\Program Files\Ozeki\OzekiNG - SMS Gateway\Logs.
In the Maximum log file size text field you can specify the maximum size
of a logfile. Once this size is reached, a new logfile will be created. Specify
the number of kilobytes for the size of a logfile by entering a positive whole number.
By default, the maximum logfile size is 8000 kB.
In the Number of rotated files text field, specify the maximum number of
rotated logfiles that are saved. Specify this number by entering a positive whole number.
By default, the number of logfiles that are saved is 8 (see Figure 4 above).
By checking the Compress rotated files with zip option you can save rotated
fields compressed in a zip file.
To initiate the connection manually, click the Connect link in the panel
of the service provider connection (Figure 5).
Figure 5 - Links to operations
You can open the panel of a service provider connection by
clicking its name in the Service providers panel in the Management
The panel of a service provider connection consists of
- In the upper section you can find the name of the service provider
connection (with the name of its protocol in brackets).
- You can see an icon showing if the service provider connection
is connected. If it is not, the icon is marked with an "x".
To the right of the icon you can find links to perform
- Configure: to configure or modify the configuration
of an installed service provider connection. Clicking this link will
take you back to the Configuration panel.
- Events: to view the logging of the latest server events related
to the service provider connection. Clicking it will bring up the Events
panel containing the logging of the latest server events.
- Connect: to connect the service provider connection with the SMS
- Disconnect: to disconnect the service provider connection from
the SMS Center.
- Uninstall: to uninstall the service provider connection.
In the middle section of the panel you can see some of
the most important configuration information.
- The options that have been (re)activated
during the configuration are marked with a tick.
- The options that have not been
activated or those that have been deactivated during the
configuration are marked with an "x".
For more information please contact us at email@example.com.
HTTP SMS Service Provider