Headwind SMS software products

About | Contact us

 
 

Integration of SMS in your applications

Headwind GSM Modem Driver may be used by third-party applications both for sending and receiving SMS. It provides the following interfaces:

  • COM interface for integration with Windows applications and scripts;
  • HTTP interface for integration with web sites;
  • Command-line interface for integration with databases and Windows scripts.

Integration of Headwind GSM Modem Driver with Windows applications

The description of COM interface may be found in the help file for Headwind GSM Modem Driver (Start - Programs - Headwind SMS - Headwind GSM Modem Driver - Help).

View COM interface description online

The VB.NET example of COM application may be found in the installation package of Headwind GSM Modem Driver. On our website you can download C# SMS example.

Receiving SMS and delivery reports. SMS handlers

SMS handler is the action which should be done when SMS or delivery report is received. The handler is the DOS command or HTTP GET request which gets variables _FROM_ (phone number related to SMS), _BODY_ (message body) and others. To create the SMS handler, you need to open Headwind GSM Modem Driver control panel, then open the "Handlers" tab and click "Add".

Sending SMS. SMS source

Third-party applications and websites may send SMS via the interface of SMS sources. SMS source is a file, DOS command or HTTP GET request which is periodically (once per some seconds) called by Headwind GSM Modem Driver. If the SMS source returns SMS to be sent, they are being sent by Headwind GSM Modem Driver.

SMS source must return text in XML format:

To create the SMS source, you need to open Headwind GSM Modem Driver control panel, then open the "Sources" tab and click "Add".

Note: default encoding is UTF-8!

Where to find integration examples and manuals?

If you need...

... to save received SMS in a file or database, send SMS from the database or from the file, you need this manual! >>>

... to integrate Headwind GSM Modem Driver with a website, you need this manual! >>>

... to use SMS in your .NET application, you need this manual! >>>

How to debug?

Both SMS sources and SMS handlers have two debug flags. To set these flags, open the tab "Sources" or "Handlers", select the desired command and click "Edit"..

SMS source (handler) is active - uncheck this flag if you need to turn off the SMS source or SMS handler but do not want to delete it and lose all changes.

View output in log - if you check this flag, you can see the output of SMS handler or SMS source in a log file. To view log, open the "SMS" tab and click the button "Port log" (right bottom corner).

Emulation mode

Emulation mode allows to debug the SMS application without real SMS, thus saving money. To turn on the emulation mode, double click the icon if Headwind GSM Modem Driver icon in tray, then open the "Application" tab and set the checkbox "Emulation mode". Then click the application icon in tray by right mouse button, select "Exit", then start the program again.

To emulate sending SMS, click Headwind GSM Modem Driver icon in tray by right mouse button and select "Send SMS", or click "Send SMS" in the control panel.

To emulate receiving SMS, type the text SEND [number] [SMS] in the SMS sending window. For example, SEND 79111992948 Test Message will emulate receiving SMS with the text Test Message from phone number 79111992948.

Request help from us

If you have problems with integrations, please request help from us. To get help, please identify the e-mail for backfeed and describe the problem as detailed as possible. Paste Headwind GSM Modem Driver log file in the support form if it is necessary.

If you need to integrate SMS in your systems, we can propose you various SMS solutions. Please contact us and describe the task as detailed as possible. Do not forget to give us your e-mail.