OZEKI NG SMS Gateway
"The World's most reliable SMS gateway software!"
info@ozekisms.com
Tel.: 00 36 52 532 731
Overview Quick start Download Manual How to buy FAQ Contact Us
OZEKI NG SMS Gateway - Product Guide

SMS through E-mail Contents | SearchSMS via colour protocol

Home > Product Manual > Installation Guide > Users and applications > SMS via HTTP Request

SMS Gateway SMS Gateway Home

  Product Manual
  Introduction
  SMS technology
  Installation Guide
  Prerequisites
  Download Information
  Installation Steps
  Service Provider Connections
  Users and applications
  Standard user
  SMPP user
  SMS from/to database
  Autoreply SMS from database
  Autoreply SMS using a script
  Simple autoreply SMS
  SMS from/to file
  SMS through E-mail
  SMS via HTTP Request
  SMS via colour protocol
  Application starter SMS
  SMS Voting
  SMS from MS Outlook
  SMS from/to FTP server
  PDF Request in SMS
  SMS to WCF service
  SMS Forwarder
  RSS to SMS
  Linux
  User Guide
  Developers Guide
  Examples and Solutions
  Appendix
  FAQ
  Feature list
  Commercial Information
  Search
 


Automated phone calls?
Ozeki Phone System XE VoIP PBX software is an advanced PBX built for automated voice calls and 2 way SMS messaging. It has outstanding APIs for software developers. It can be used for:

Phone calls from SQL
Phone calls from HTTP
Voice and SMS applications

Callcenter developers
If you are working on telephone solutions, please check out the Ozeki VoIP SIP SDK.
It can be used to create VoIP client and server software.

Contact Us!
If you wish to get further information, do not hesitate to contact us!

E-mail: info@ozekisms.com

If you have a technical question, please submit a support request on-line.

HTTP Client User


This chapter explains how to install and configure an HTTP Client user for SMS messaging using the graphical user interface of the Ozeki NG - SMS Gateway software.

Ozeki NG - SMS Gateway allows, among others (see the Users and Applications page), the installation and configuration of an HTTP Client user.

The HTTP Client takes incoming messages and passes them in an HTTP GET or an HTTP POST request to an external web server. The HTML page returned by the web server can contain SMS messages that will be sent by the server (Figure 1).


Figure 1 - Ozeki NG - SMS Gateway as an HTTP SMS Gateway

The HTTP client is a very convenient feature of Ozeki NG Gateway, as it can translate mobile communication into HTTP-based communication. The Ozeki NG Gateway works as both a gateway and a translator between mobile communication and the Internet. It enables you to create HTTP client connections that can forward messages to a web address (URL).

You can use the graphical user interface of Ozeki NG - SMS Gateway to install and configure any user.

To start installing and configuring an HTTP Client user, click the Add button in the top right-hand corner of the Users and Applications panel on the right of the Management Console. You can also add a user by clicking the Add user item in the Users and applications menu (Figure 2).


Figure 2 - Adding a user

This will bring up an interface consisting of two panels.
The panel on the left contains a list of users that have been installed. In the bar at the bottom of the page you can read how many users have been installed.
The panel on the right contains a list of users that can be installed.
Each user in the left-hand panel is listed with a unique name (and the user type stated in brackets).
Each user in the right-hand panel is listed with the name of its type and a brief description of what it can be used for.

To add an HTTP user, click the Install link in the respective entry in the list (Figure 3).


Figure 3 - Installing an HTTP Client user

When installing a user (type), you need to give it a unique username. Clicking the Install link will bring up the HTTP Client user installation panel. Here, you need to enter a unique username in the Username field.

Once you have installed an HTTP Client user, you can start to configure it. After you have provided a unique name for the HTTP Client user and clicked OK, the Configuration panel will open.

The first tab that will show up is the Incoming tab.
In this panel you need to specify HTTP Client settings. This information is provided by the SMS service provider when you subscribe to the service (Figure 4).


Figure 4 - The Incoming tab

In the Target URL template you can specify the URL of the HTTP server. This URL can contain certain keywords that will be replaced before the URL is called. The following keywords can be used:

KeywordDescription
$originatorThis denotes the sender telephone number.
$recipientThis denotes the recipient telephone number.
$messagetypeThis the text containing the SMS message format.
$messagedataThis contains the message text.
$receivedtimeThis is the timestamp, denoting when the message was received.
$receivedtime12The time when the message was received in 12 hour format.
$senttimeThis is the timestamp, denoting when the message was sent.
$senttime12The time when the message was sent in 12 hour format.
$messageidThis is the unique identifier string of the message. This identifier
is generated by Ozeki NG - SMS Gateway.
$dcsThe SMS data coding scheme.
$pidThe protocol identifier.
$operatorThe instance name of the service provider connection that received the message.

Below this template, you can specify the HTTP request method by selecting the GET or the POST radio button.

The HTTP transaction is initiated by the SMS Gateway and is served by a web based application. ASP, PHP, JSP are good options to create a web based application that can process the incoming messages. These applications can optionally return one or more response SMS messages in the HTTP response. The format for the HTTP response is discussed on the SMS Message format page. An example of the response your application can return is:

{SMS:TEXT}{Vodafone}{+447778888888}{+447779999999}{Hello world}

In Outgoing tab you can specify the URL from which outgoing messages can be downloaded. A webpage can be checked periodically for messages to be sent. In Polling period you can set this period in seconds (Figure 5).


Figure 5 - Outgoing tab

In Delivered to network section of Delivery reports tab you can specify the HTTP URL to be called when a message is successfully delivered to the network. In Delivered to handset section the HTTP URL to be called when a message is successfully delivered to the handset can be defined. In Delivery error section you can set the HTTP URL to be called on message delivery errors (Figure 6).


Figure 6 - Delivery reports tab

To configure logging related to the HTTP user, 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 5).


Figure 5 - Logging options

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 text box. By default, the access path to the logfiles is: C:\Program Files\Ozeki\OzekiNG - SMS Gateway\Logs

In the Maximum log file size text box in the Logfile settings section, 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 box, 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 4 (see Figure 5 above).

If you are content with the default specifications, leave the text boxes unchanged.

To modify the configuration or to view server events related to an HTTP Client user, open the panel of the user's account. To do this, click the name of the user in the Users and Applications panel of the Management Console. In the panel of the user's account, click the link of the task you wish to perform (Figure 6).


Figure 6 - Clicking a user-related task link

Dig deeper!
People who read this also read...





Next page: SMS via colour protocol
Copyright © 2000 - 2014 Ozeki Informatics Ltd.
All rights reserved

Software PBX for Windows | VoIP SDK   |   Legal information   |   Privacy policy   |   Terms of use
Please, address your inquiries to info@ozekisms.com