- Quick start guide
- System requirements
- Installation guide
- Mobile networks
- User guide
- Developers guide
- Service providers
Quick Start Guide - SMS Gateway
This Quick start guide is about to explain that how to send your first SMS in just a few steps with Ozeki 10 SMS Gateway. This guide provides you the capability to configure your SMS modem to send or receive an SMS message successfully. The following steps will guide you through the process of login, creating users or connections and routing your text messages.
SIM card: To use all the functionality of Ozeki 10 SMS Gateway, first you need a mobile subscription that comes with a SIM card. This SIM card will provide you a telephone number, that is crucial to send and receive SMS messages with Ozeki 10 SMS Gateway.
GSM modem: A special type of modem, that accepts SIM cards. That modem can be connected to your PC via a data cable and use it as a broadcaster for your messages. The GSM modem is available directly from Ozeki Ltd.
Data cable: To connect your GSM modem to the PC, you just need a simple USB data cable that is provided for each modems that has been ordered from Ozeki Ltd.
Ozeki 10 SMS Gateway: You need to download Ozeki 10 SMS Gateway from
|Ozeki 10 SMS Gateway can be obtained by from the download page:
Download Ozeki 10 SMS Gateway!
|Setup instructions for the modem are available at:
Installation of an SMS modem
Step 1: Log in to your account
The first thing that you need to do after the installation to log in to your account that you created during the installation. For that just click on the Ozeki Desktop icon and your Ozeki 10 SMS Gateway will open up in your web browser (Figure 1).
In the login window just enter the username which is 'admin' by default and your password that you specified during the installation. After you pressed OK, the SMS Gateway starts automatically with an opening window as Figure 2 demonstrates it. Here there are four main panels that collect all the main features of the SMS Gateway you need to handle SMS messages. If you want to change the password of the default 'admin' user, you can easily do that by following the quick guide on the link.
Figure 2 - Opening window of the SMS Gateway
Step 2: Set up your mobile network connection
The next step is to connect your system to the mobile network. To do this there are two options. You can connect to the mobile network like any other mobile phone does, in this case you need to connect a GSM modem or you need to connect through an Androi mobile phone. The other option is to connect to the Short Message Service Center (SMSC) of a mobile network operator over the Internet. In this case you would setup an SMPP connection, an UCP connection a CIMD2 connection or an HTTP SMS connection.
The most simple option is to connect your computer to the mobile network using an GSM/SMS modem. An SMS modem is s simplified mobile phone. You can put a SIM card in it and it has an antenna. In this case Ozeki 10 SMS Gateway will communicate with you modem over a data cable and will receive incoming SMS and will send outgoing messages through the wireless link provided by the modem. The way you will do that is very simple, you only need to create a connection that can manage the GSM modem and use to send and receive SMS messages. To create that connection just select Add new connection... like in Figure 3.
Figure 3 - Choose Add new connection to create one
Next, as Figure 4 shows that, you can choose from numerous connections since Ozeki 10 SMS Gateway supports many protocol types. But now, to follow this guide you need to create a wireless connection, more specifically an SMS modem connection that can be performed by clicking on the Install button.
Figure 4 - Available connections in Ozeki 10 SMS Gateway
Before finishing the creation of the connection, you can give a name to the connection and select the port, where you connected the SMS modem. If you are not sure about specific number of the port, just click on the Autodetect button (Figure 5), and a few moments later, the system finds that for you. Lastly you have to enter the telephone number of the SIM card that you plugged into the SMS modem. To finish the creation just click on OK.
Figure 5 - Autodetect the port where you plugged the GSM modem
Step 3: Create new user or application
Ozeki 10 SMS Gateway provides you the functionality of handling multiple users, so the messages can be separated by the different users. To add a new user just select the Add new user/application... or click on the Add button on the top of the Users and applications panel as you can see in Figure 6.
Figure 6 - Two ways of entering to the creation of a new user or application
Next, you can choose between various types of users and applications. Here you can create a general or a network user, select from numerous application interfaces and also you can create services that can handle the incoming messages. If you follow this guide you will create a standard user by selecting the Standard user like in Figure 7.
Figure 7 - List of creatable users and applications
In the installation menu you can name the user at the General panel. This name will show up in the list of users. In the Authentication tab (Figure 8) you can secure the account by entering a unique username and a password. The rules of the password are the same as it was at the creation of the 'admin' account. To finish the creation just click on OK.
Figure 8 - Select a username and password for the account
Now, you can see the created user in the Users and applications panel. To modify the parameters of the account, just select the user, and you will be able to do that in Configure tab (Figure 9). To view the events related to the user, select the Events tab.
Figure 9 - Configuration menu of the Standard user
Step 4: Routing your messages
With the installation and the creation of the default 'admin' account, Ozeki 10 SMS Gateway also created a default routing rules for the incoming and outgoing messages that can be seen in the Incoming and the Outgoing panels like in Figure 10. But of course, you have the opportunity to define your own routing protocols.
Figure 10 - Routing tables in Ozeki 10 SMS Gateway
Inbound routing: The incoming messages can be destined to one or more users. There is a default route that was created at the installation process, but you can easily set your own routing rules. For that, just select the Add new route... option and now you will be able to add a new route or configure the existing routes as well. If you would like to create a new route, first of all you have to define which user or connection send the message to which user or connection. The other main feature that you need to setup, is the mode of the route. There are three options to choose from: Move, Copy or Drop (Figure 11). Now, if you click on OK, the freshly created route will appear in the list of the routes.
Figure 11 - Select a mode for the routing rule
Now, if you take a look at your routing table you will be able to see that your routes list up in order. So, that means in case of an incoming messages, the program tries to activate a first route of the table. If there is a match of the rules, the messages will be delivered to the user specified in the rule. But if the parameters do not meet the criteria the program will go on to the next rule. If a rule matched with the criteria, there are two ways the routing can continue. If the matched rule has the mode Copy, the program will continue going through the subsequent routing rules. The other option is that the rule is in Move mode. In that case the routing will finish and the subsequent rules will be ignored. The order of the rules can be easily changed as Figure 12 shows by clicking on the icons in the Order column.
Figure 12 - Change the order of the routing rules
Outbound routing: An outgoing message can be sent using one of the service providers you are connected to. With the outbound routing you can configure the rules for the program to decide which service provider connection to use to send out a message. The routing rules are the same as it was at the inbound routing, so the program goes through the routing table from top to bottom. To create a new route, just select the Add new route... on the Outgoing panel (Figure 13).
Figure 13 - Routing table of the outgoing messages
Here in the creation panel (Figure 14), the setting up of the route is pretty much the same as at the creation of the inbound route. That means the main parameter that you have to define is the two endpoints of the route. With that you can set the connection or user where the messages will be sent from, and also the recipient user or connection that will receive the message. The other main thing that can be modified is the mode which can be Move, Copy or Drop. When you finished with the setting up, just click on OK to create your own route for the outgoing messages.
Figure 14 - Creation of route for outgoing messages
Step 5: Send your first SMS using the connection
Now with the previous steps you prepared to send and receive SMS messages with Ozeki 10 SMS Gateway and in that last step you can write and send your first SMS using the created connection. So, to enter the Message composer just click on the New icon as Figure 15 shows, or select File and next click on Compose.
Figure 15 - Write a new message by Clicking on the New icon
Here in Message composer, you have to specify that who is going to be the recipient of your message (Figure 16). For that you can select the option Use routing table or select a connection that will send your message to the specified address that you have to enter in the Address field. In the Message field just type the message and if you click on OK you just sent your first SMS message using Ozeki 10 SMS Gateway.
Figure 16 - Message composer in Ozeki 10 SMS Gateway