SEND SMS ALERT FROM YOUR SYSTEM: Twitter Joomla HP Openview WhatsUp Gold Sharepoint Notes
    
Home Solutions Applications Industries Products About Us
    
SMS from Ozeki NG http interface solution presentation
MS Powerpoint presentation (.ppt) 62Kb
SMS from Ozeki NG http interface solution overview
Adobe PDF file (.pdf) 220Kb
Menu
  Welcome page
  Solutions
  SMS from CRM
  SMS from Communication Softwares
  System Monitoring
  SMS from CMS
  Helpdesk Softwares
  OTP
  Ozeki NG Interface
  HTTP
  SMS API
  E-mail
  Command line
  Database
  RSS to SMS
  SMS from Cloud
  Applications
  SMS Examples
  Products
  Contact
  Sitemap

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

E-mail: info@sms-integration.com

Useful information
How to send SMS with a GSM modem attached to your PC?


This solution is best if you are planning to send or receive up to 4000 SMS per day. Read more:
  • Prerequisites
  • Setup instructions
  • Video tutorial


    How to send SMS through the Internet?


    If you wish to send more then 4000 SMS per day, it is a good idea to use an Internet SMS service provider. Read more:
  • Prerequisites
  • Setup instructions
  • Automate phone calls!

    Ozeki Phone System XE - VoIP PBX Software is an excellent tool for making automated phone calls.

    Request parameters for SMS sending

    This page provides you a complete list of the parameters that needs to be specified if you wish to send or receive SMS message using HTTP requests.
    Parameter Description Possible values Example M/O*
    action Specifies the HTTP API command sendmessage action=
    sendmessage
    M
    username Specifies the username. The username and password parameters are used to authenticate the user. When you send an message it will be sent in the name of the authenticated user. The value must be urlencoced. string value, maximum length is 16 characters username=
    admin
    M
    password Specifies the password. The username and password parameters are used to authenticate the user. When you send an message it will be sent in the name of the authenticated user. The value must be urlencoced. string value, maximum length is 16 characters password=
    abc123
    M
    originator Specifies the sender address. This information will be displayed on the mobile phone, that receives the message. This is the sender address. This can be a telephone number, a short code or an alphanumeric sender address. The telephone number must can be formatted in local number format (e.g.06201234567) or in international number format (e.g.+36201234567). If you use an alphanumeric sender address (e.g.ozeki), the characters must be encoded in UTF8 and the value must be urlencoded. string value, maximum length is 16 characters originator=
    %2B36201112222
    O
    recipient Specifies the recipient phone number. The message will be sent to this telephone number. The telephone number can be specified in local number format (e.g.06201234567), or in international number format (e.g.+36201234567).
    More then one recipient addresses can be separated by a colon (e.g.: +36201234567,+36202222222)
    The value must be urlencoded.
    string value, maximum length is 16 characters recipient=
    %2B36201234567
    M
    messagetype Specifies the message type. The type of the SMS message data based on the Mobile Message Type Specification. For text messages the message data will be plain text, for other message types it will be an XML document.
    SMS:TEXT
    SMS:WAPPUSH
    ...
    Possible values can be found in the
    Mobil Message Type Specification
    messagetype=
    SMS:TEXT
    O
    messagedata Specifies the text or the data of the SMS message. The value must be encoded in UTF8 and must be urlencoded. string value, maximum length is
    32768 characters
    messagedata=
    Hello+World
    M
    _charset_ Specifies the charset of the encoded data (if not specified utf-8 will be assumed). Newer browsers should set the value of _charset_ automatically. If your browser doesnt support this feature you can set is manually to:
    utf-8
    windows-1250
    iso-8859-1
    iso-8859-2
    ...
    _charset_=
    iso-8859-2
    O
    serviceprovider Specifies the name of the GSM Modem or IP SMS service provider connection to use to send the message.

    The value must match the string specified on the configuration form of the service provider connection.
    string value, maximum length is 16 characters serviceprovider
    =Vodafone
    O
    sendondate Specifies the date and time, when the message should be sent.

    The value must use the following date format: YYYY-MM-DD hh:mm:ss. The value must be url encoded
    date value in YYYY-MM-DD hh:mm:ss format sendondate=
    2009-12-12%
    2010:00:00
    O
    responseformat After the gateway submits the SMS message, the gateway will return a web page indicating that the message was submitted successfully. The content of the webpage is formatted according to the responseformat parameter. You can have html text response to make it easy for humans to read it or you can have xml format to make it easy for software to process the response. xml (default)
    html
    urlencoded
    responseformat=
    xml
    O
    continueurl After the gateway submits the SMS message, the gateway will return a web page indicating that the message was submitted successfully. The content of the webpage is formatted according to the responseformat parameter. If the responseformat parameter is set to html, the webpage can contain a "Continue" link. If you specify the URL in this parameter the continue link will be displayed and it will point to the specified URL. The value of the URL must be urlencoded.

    The URL you specify can contain keywords that will be replaced to state information corresponding to the submitted message.
    string value, maximum length is
    1024 characters
    continueurl=
    www.ozekisms.com

    or

    continueurl=
    http%3A%2F%2F
    www.ozekisms.
    com%2Findex.
    php%3Fowpn%
    3D159

    Note:
    the second example
    contains an
    urlencoded URL.
    O
    redirecturl After the gateway submits the SMS message, by default the gateway will return a web page indicating that the message was submitted successfully. Optionally you can ask the gateway to automatically redirect the browser to an URL you specify. If you specify an URL in the redirect parameter, the HTTP response returned by the SMS gateway will contain a redirect URL in the HTTP header. This will instruct the webbrowser to follow the link you have specified. The value of the URL must be urlencoded.

    The URL you specify can contain keywords that will be replaced to state information corresponding to the submitted message. More information about possible keywords can be found in the "Submit URL keywords" guide.
    string value, maximum length is
    1024 characters
    redirecturl=
    www.ozekisms.com

    or

    redirecturl=
    http%3A%2F%2F
    www.ozekisms.
    com%2Findex.php%
    3Fowpn%3D159

    Note:
    the second example
    contains an
    urlencoded URL.
    O
    reporturl You can setup a webpage to process information about "delivered to network" and "delivered to handset" events. If you specify an URL in the reporturl parameter, your webpage will be called when these events happen. The value of the URL you specify in the reporturl parameter must be > urlencoded

    The URL you specify can contain keywords that will be replaced to state information corresponding to the submitted message. More information about possible keywords can be found in the "Submit URL keywords" guide.

    Please also note, that if you want the reporturl parameter to work, you must create a "HTTP server user" account and use it's username and password. The "Standard user" account does not support this option.
    string value, maximum length is 1024 characters reporturl=
    http%3A%2F%2F
    www.ozekisms.com
    %2Fproc.php%3F
    reporttype%3D%24
    reporttype
    %26messageid
    %3D%24
    messageid

    Note: this is
    the urlencoded
    version of
    the following URL.
    Before this URL
    is called by
    the SMS gateway,
    the $reporttype
    and $messageid
    parameters
    will be replaced
    to the appropriate
    values:

    http:
    //www.ozekisms.com/
    proc.php?reporttype
    =$reporttype
    &messageid=
    $messageid

    will be called as:
    http://
    www.ozekisms.com/
    proc.php?reporttype
    =deliveredtone
    twork&
    messageid=ERFAV23D
    O


    Response parameters

    Parameter Description Possible values Example
    acceptreport Contains the response for the submit request for a single recipient address. If many recipients were specified, an acceptreport will be included in the response for each recipient. The order of acceptreports will match the order of the recipient addresses.   <acceptreport> <statuscode>0</statuscode> <statusmessage>Message accepted for delivery</statusmessage> <messageid>ERFAV23D</messageid> <recipient>06203105366</recipient> </acceptreport>
    acceptreport.statuscode Contains an integer value to indicate success or failure. If the value is 0, it means the message was accepted for delivery. If the value is greater then 0 it means there was an error, the message was not accepted for delivery. Integer value, greater then or equal to 0. Less the 32768. <statuscode>0</statuscode>
    acceptreport.statusmessage Contains a textual representation of the status code. If the message was accepted the value will be "Message accepted for delivery". If the message was not accepted for delivery, you can find the error message in this field. string value, maximum length is 1024 characters <statusmessage>Message accepted for delivery</statusmessage>
    acceptreport.messageid Contains a message reference that can be used to track the message in the SMS gateway. This message reference is also used to identify delivered to network and delivered to handset reports or to query information about the message. string value, maximum length is 16 characters <messageid>ERFAV23D</messageid>
    acceptreport.recipient Contains the recipient address. string value, maximum length is 16 characters <recipient>06203105366</recipient>

    Ozeki NG HTTP interface

    Home > Solutions > Ozeki NG Interface > HTTP > SMS API
    Feel free to contact us for additional information. Tel: +36 1 371 0150, E-mail: info @ ozekisms.com
    Copyright © 2000 - 2017 Ozeki Informatics Ltd. - All rights reserved.