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.)
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 ).
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 ).
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).
If you have finished a necessary configuration, you click on Connect link (Figure 5).
More information