HTTP client plugin

The HTTP Client plugins has the ability to post an incoming SMS message to a webserver. Each incoming message generates an HTTP request (GET or POST) to a URL that can point to any webserver. The response to this HTTP post can contain one or more SMS messages that will be delivered by the Ozeki Message Server (Figure 1.)

ozeki message server as an http sms gateway
Figure 1 - Ozeki Message Server (Ozeki Gateway) as an HTTP SMS Gateway

To install the HTTP Client plugin, please go to the Plugins menu and click on the Installed Plugins menu item.In the "Available plugins for installation" window click on the HTTP Client plugin install link and the installation process will start (Figure 2 ).

Available plugins for installation
Figure 2 - Available plugins for installation

After installation you'll see the HTTP Client plugin 1 appearing on the list of plugins in the "Currently installed plugins" screen. On this form you can start the configuration by clicking on the Configure link. After this HTTP Client plugin 1 configuration screen pops up. In the HTTP Client tab, you have to specify the URL of the HTTP server in the text box (Figure 3 ).

Settings in the HTTP Client tab
Figure 3 - Settings in the HTTP Client tab

This URL can contain certain keywords, that will be replaced before the URL is called. The following keywords can be used:

Keyword Description
$SENDER The sender telephone number
$RECEIVER The receiver telephone number
$MSG The first 1024 characters of the message text
$RECEIVEDTIME The timestamp, the message was received on
$OPERATOR The name of the driver that received the message
$ID The unique identifier string of the message. This identifier is generated by the Ozeki Message Server
$DATA The message text
$KEYWORD The first word of the message text
$TYPE The message type. For a list of possible message types please visit the following page: Ozeki Message Types

It is important to mention, that the value of each keyword is urlencoded. When the HTTP URL is called a server side application can be used to handle the incoming messages. This application can create one or more automatic response messages (see example code). After installation you can test this functinality by using the demo application hosted at http://www.ozeki.hu

Important Note: After you have tested the functinality, it is strongly recommended to modify the URL to point to your service instead of the demo application a http://www.ozeki.hu!

In the Special tab you have to specify Send parameters and operator name (Figure 4).

Settings in the Special tab
Figure 4 - Settings in the Special tab

If you have finished a necessary configuration, you click on Connect link (Figure 5).

HTTP Client connection to the server
Figure 5 - HTTP Client connection to the server

More information