I've uploaded an early version of OpenVPMS 1.5-beta-3 with SMS support to: http://repository.openvpms.org/snapshots/org/openvpms/openvpms-release/1.5-beta-3-SNAPSHOT/openvpms-release-1.5-beta-3-20111012.002530-3.zip Two email-to-SMS gateways are supported out of the box:

* SMSGlobal Email2SMS gateway (http://www.smsglobal.com )

To sign up, go to: http://www.smsglobal.com/en-au/solutions/signup_page.php SMSGlobal allows you to send a small number if test messages for free after you register.  

* Clickatell mail-to-SMS gateway (http://www.clickatell.com )

Clickatell allows you to send a small number of test messages for free after you register but sends a preformatted SMS until you pay $. To sign up:

* go to: http://www.clickatell.com/register/account_signup.php * select the "clickatell central (api)"

After signing up, go to: https://www.clickatell.com/central/manage_products.php and select "SMTP" from the "Add Connection" drop down. Click "Submit and Get API ID". The API ID is needed when configuring OpenVPMS.  

Other gateways can be added, with some knowledge of the gateway message format requirements and xpath expressions.  

.. Configuring SMS

1. reload archetypes to pick up the new SMS configuration archetypes. 2. create an SMS configuration for the SMS provider

To create a configuration for SMSGlobal:

* go to Administration -> Organisation and select New -> SMS Configuration: SMSGlobal Email2SMS. * Populate the Country Prefix and Area Prefix as required (e.g, 61 and 0 for Australia). * Enter the From address. This must be the same as that entered in the Email to SMS settings in the Preferences page at https://www.smsglobal.com/mobileworks/preferences.php

To create a configuration for Clickatell:

* go to Administration -> Organisation and select New -> SMS Configuration: Clickatell SMTP Connection * Populate the Country Prefix and Area Prefix as required (e.g, 61 and 0 for Australia). * Enter the User and Password. These are the same as those used to sign in to the Clickatell website * Enter the API ID. Set this to be that of the API ID obtained as described above. * Enter a valid From email address. * Optionally enter a Reply To email address. If specified, responses from the gateway will be sent here.

3. link the SMS configuration to the practice:

* edit the Practice in Administration -> Organisation * select the SMS tab * select the followed by the SMS configuration created above

4. optionally configure the mail server:

* edit the Practice Location(s) in Administration -> Organisation * enter the Mail Host, Mail Port, Mail Username and Mail Password as required

.. Sending SMS messages

SMS messages can be sent to any customer that has a Phone Number Contact with "Allow SMS" ticked. SMS messages can be sent by clicking the Send SMS button in the Customer Summary. If a customer has multiple phones, the preferred one will be pre-selected in a dropdown. Alternatively, the Send SMS button in the customer's Phone Number contact can be used to send a message. For this release, only messages up to 160 characters may be sent. A description of the implementation can be found in the JIRA: https://openvpms.atlassian.net/browse/OVPMS-902?focusedCommentId=12531&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-12531 This includes instructions for adding support for other SMS gateways. A description of the Clickatell SMTP API can be found at http://www.clickatell.com/downloads/smtp/Clickatell_SMTP.pdf A description of the SMSGlobal SMTP API can be found at http://www.smsglobal.com/docs/Email-2-SMS.pdf

_______________________________________________ OpenVPMS Developers Mailing List developers@lists.openvpms.org To unsubscribe or change your subscription visit: http://lists.openvpms.org/listinfo/developers Posts from this mailing list can be viewed online and replied to in the OpenVPMS Developer's forum- http://tinyurl.com/openvdf