IceWarp Unified Communications SMS Service Reference Version 10.4 Printed on 16 April, 2012 Contents SMS Service 1 About .............................................................................................................................................................................. 3 Why Do I Need SMS Service? ............................................................................................................................. 3 What Hardware Will I Need? ............................................................................................................................. 3 Why Would I Want More Than One SMS Gateway? .......................................................................................... 4 GSM Service ................................................................................................................................................................... 5 Tested and Supported Products ........................................................................................................................ 5 HTTP Gateway ................................................................................................................................................................ 6 Tested Products ................................................................................................................................................. 6 Reference ....................................................................................................................................................................... 7 General .............................................................................................................................................................. 7 Users ................................................................................................................................................................ 10 Authentication ..................................................................................................................................... 10 SMS Account Setup ............................................................................................................................. 11 Outgoing Messages .......................................................................................................................................... 13 Applications ......................................................................................................................................... 14 Non-Delivery Reports .......................................................................................................................... 16 Incoming Messages .......................................................................................................................................... 17 Reply-To Feature ................................................................................................................................. 19 HTTP SMS Service Setup ............................................................................................................................................... 20 Configuring Clickatel HTTP Gateway ................................................................................................................ 22 Compatibility ....................................................................................................................................... 22 Special Variables .................................................................................................................................. 22 UDH (Universal Data Header) .............................................................................................................. 23 ii Contents Prerequisities ....................................................................................................................................... 23 Configuration of Binary/Text Message Gateway ................................................................................. 25 Text Messages Only ............................................................................................................................. 27 Troubleshooting .................................................................................................................................. 27 Delivery Reports .................................................................................................................................. 27 SMS Server Log .................................................................................................................................... 27 HTTP Gateway with Client Certificates ............................................................................................................ 28 Sending SMS from Server ............................................................................................................................................. 29 sms: Protocol ................................................................................................................................................... 29 sms: Protocol Examples ....................................................................................................................... 30 HTTP Request ................................................................................................................................................... 30 HTTP Request Examples ...................................................................................................................... 31 HTTP Request – Delivery Script ........................................................................................................... 31 Available Parameters ....................................................................................................................................... 32 Scenario Example ............................................................................................................................................. 33 Technical Specifications ............................................................................................................................................... 35 Sending SMS from Email Clients ................................................................................................................................... 38 Outlook and Other Desktop Clients ................................................................................................................. 39 Directly from Outlook Contact Lists ................................................................................................................. 40 Directly from WebClient .................................................................................................................................. 40 1 C H A P T E R 1 SMS Service The SMS Service incorporated into IceWarp Server is a gateway to mobile networks allowing IceWarp Server to: . send and receive SMS messages. use SyncML SMS PUSH technology to instantly synchronize server data to mobile devices. be a bridge between email and SMS - using IceWarp Server's sms: protocol. extend CRM and other custom applications by text messaging capabilities Multiple SMS gateways can be configured within IceWarp Server, allowing a greater throughput of messages as IceWarp Server will automatically balance the workload between them. 2N Voiceblue GSM Gateway. An example of a hardware gateway which can communicate over USB as a locally connected modem or over Ethernet as an HTTP remote gateway. 2 SMS Service Reference Legend Icon Description Warning – very important! Note or tip – good to know. Note within a table. Figure link – click the link to reveal the figure. Click it again to close it. (Works only in the CHM format.) In This Chapter About ..................................................................................................... 3 GSM Service ........................................................................................... 5 HTTP Gateway ........................................................................................ 6 Reference ............................................................................................... 7 HTTP SMS Service Setup ........................................................................ 20 Sending SMS from Server ....................................................................... 29 Technical Specifications ......................................................................... 35 Sending SMS from Email Clients ............................................................ 38 About 3 About In This Chapter Why Do I Need SMS Service? ................................................................. 3 What Hardware Will I Need? ................................................................. 3 Why Would I Want More Than One SMS Gateway? ............................. 4 Why Do I Need SMS Service? You need a working SMS service if you want to: . send or receive SMS . use SyncML SMS PUSH technology . send bulk text messages . extend web applications by SMS functionality . enhance the WebClient/Outlook user experience with mobile communication SMS is the best communication channel for direct marketing campaigns, social services, consumer competitions, market research and other applications. Immediate and cost-effective at the same time, text messaging offers retailers a highly effective medium to deliver an attractive, personalized content with a greater reach and response than