SMS Gateway

Release notes

Version 1.2.4 - Early deployment
  • Bugfix: Accented characters not accepted (M5084)
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.2.3 - General deployment
  • Bugfix: Special characters not accepted (M5084)
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.2.2 - General deployment
  • Bugfix: Fix start up script smsd
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.2.1 - General deployment
  • Improvement: Set up pin automatically when SMS server starts
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.2.0 - General deployment
  • Feature: Added support for baseline2
  • Improvement: Upgrade to gnokii 0.6.29
  • Bugfix: smsd crashes from time to time and send duplicated SMS
  • Bugfix: smsd not restarted automatically by defence
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.1.0 - General deployment
  • Feature: Add local SOP SMS gateway support
  • Dependency:
    • Requires net.Desktop >=2.19
    • Requires net.Desktop resource WCE5 >=1.5 to use.
    • Requires SOP API >=2.25

Version 1.0.0 - General deployment
  • Feature: (initial version) Supports sms gateways with an HTTP(S) API
  • Dependency:
    • Requires net.Desktop >=2.19 and net.Desktop resource WCE5 >=1.5 to use.

Module configuration interface

create_resource_form: .:/usr/share/escaux/glue/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib:/usr/share/escaux/glue/bin/gen_wiki_documentation/src/lib/

Gateway HTTP url (e.g.http://api.clickatell.com/http/sendmsg?user=xxx&password=yyy&api_id=zzz&to=<to>&text=<message>)
Failure detection string (e.g. ERR)
National country code (e.g. 32=belgium, 33=france etc) to add to mobile numbers not in international format
SMS Gateway support
IM Router Service Extension
IM Sender Service Extension
Gnokii device 1
Gnokii device port 1 (e.g. 00:16:4E:71:85:AA)
Device memory (SIM card or device memory)
Pin code
Custom pin code

Module configuration parameters

  • Gateway HTTP url: This is the url of your sms gateway, which will be used by the sop to send the sms. It usually contains some login and password data as well as two macros: <to> and <message>. As an example the Clickatell http api can be entered as follows: http://api.clickatell.com/http/sendmsg?user=xxx&password=yyy&api_id=zzz&to=<to>&text=<message>&;. Here <to> will be replaced by the mobile phone number in international format (without leading zeros), and <message> will contain the actual, url-encoded, message up to maximum 160 characters long.
  • Failure detection string: A string to scan for in the reply of the SMS gateway (HTTP response). If this string is found in the reply, the sending of the sms message is considered a failure. If the HTTP response is anything else than 200, the sending is also considered a failure. Leave blank if all failures are reported through HTTP return codes such as 404.

  • National country code: The country code used to prepend national mobile phone numbers in the conversion to international numbers.

Typically mobile phone numbers are stored according to the PBX dial plan. If the phone number starts with the international dialing prefix global parameter value, the value is removed. If it does not match but matches with the national dialing prefix, the country code will replace the national dialing prefix. otherwise the mobile number is left untouched.

Example for Belgium

  • International Dial Prefix: 000
  • National Dial Prefix: 00
  • Country code: 32

phone number in directory entry -> number for sms gateway
  • 32486123456 -> 32486123456
  • 00032486034238 -> 32486034238 (international prefix)
  • 00486123456 -> 32486123456 (national prefix)

  • SMS Gateway support: Choose one of the following values
    • HTTP: Remote SMS gateway triggered through an URL
    • HTTP+gnokii: Remote SMS gateway and internal SOP SMS gateway with a GSM modem connected through a serial cable
    • HTTP+gnokii(bluetooth): Remote SMS gateway and internal SOP SMS gateway with a GSM modem connected through a serial cable or a phone through bluetooth

  • IM Router Service Extension: Internal directory extension which maps to a service which route the call based on the SMS to the correct destination (Example: 900 which maps on a ImRouter profile extension)
  • IM Sender Service Extension: Internal directory extension which maps to a service which sends an IM (Example: 901 which maps on a ImSender profile extension)

Limitation:
  • When receiving a SMS from a feature phone, special characters can have their case that changes from lowercase to uppercase.
  • For smartphones, it is recommended to use the latest version of iOS or Android in order to correctly receive special characters. Older versions might not be working.
  • When receiving a SMS, it is not possible to send directly an SMS directly to an extension. (typically, the extension must be indicated within the SMS)
  • The characters | and # cannot be transmitted on asterisk-1.2. An upgrade to Communication Server 2 is needed. You will also have to adapt your callflows.
Copyright © Escaux SA