3.4.5 SMSSync

We are having some issues with the play store at the moment, you can download the SMS Sync app at https://github.com/ushahidi/SMSSync/releases/download/v3.1.1/smssync-withAnalyticsRelease-v3.1.1-RELEASE.apk

SMSsync is a simple, yet powerful SMS to HTTP sync utility that turns any Android phone into a local SMS gateway by sending incoming messages (SMS) to a configured URL (web service).

Please note that SMSsync works on any SMS-enabled device running Android 2.1 and above.

  • Once you have downloaded it, click on install to save it on your phone.

  • Open up the SMSSync Application on your android device, click skip or swipe left, and click done to continue.

  • On the incoming messages screen, click on the arrow at the bottom right corner to enable SMSsync.

  • Once you have enabled SMSsync, you will be redirected to the integrations screen. Start the SMSSync Service to start fetching messages in your app.

  • Click on the custom web service to configure SMSsync with your deployment.

  • Manage custom web services screen will open, you’ll note that you can manage multiple Sync URLs on the app.

  • To add a new Sync URL, tap on the Add icon on the actionbar. An input dialog should open.

Configuring SMSsync datasource on your Ushahidi Platform

  • Open your deployment i.e name.ushahidi.io, go to datasource configuration in your setting page.

  • Click on the drop down icon on the right as shown

  • Follow the instructions given to you below.

  • You will need the Sync URL to configure SMSSync.

  • Set a SMSSync secret key for security purposes.

  • Click on Save.

  • To enable/disable this datasource , simply click on the green toggle to accept survey submissions.

  • Click on the toggle to import your messages' response to a survey.

  • Select the survey you wish to import your messages to.

  • Select which field should be assigned to populate the data from SMSsync.

SMSsync setup for Ushahidi Platform SMS connectivity

  • Go back to the input dialog on your SMSsync App and add the following details;

  • Title for the custom service: This can be the name of your deployment or any title you see fit

  • Custom web service Url: Enter the Sync URL in step 2 from your deployment as shown in the 'Android settings' image above i.e "https://yourdeploymentname.api.ushahidi.io/sms/smssync".

  • Secret key: Make sure you enter the exact key as the one you entered in your deployment android setting as shown in the 'Android settings' image above.

  • Once you enter your secret key, you are done with the configuration, do not change the rest of the settings.

  • Click ADD or test integration to save the new entry.

Nb:The secret key should be presented as string of any characters without spaces. Enter a comma separated value for the keyword(s). These keywords will be used by SMSsync to filter incoming SMS and pending messages to the Sync URL you are adding. As of v2.0.2. You can now add Regular Expression code for filtering. This means, it can either be CSV or RegExp. It cannot be both.

Note: Version 2.5 or higher supports basic auth credentials in the URL, e.g. https://username:pass@example.com/api-v1/add-record/.

  • You will now need to start the SMSSync Service to start forwarding messages to the platform. To start the SMSSync service

    • Make sure that you have added and enabled(checked) the Sync URL you added above.

    • On the integration screen, tap on the Start SMSsync service to start the service if you had not enabled it.

You should be all set to work with SMSSync and Ushahidi now. Unstructured posts via SMS will now be pulled into the platform.

If you’d like to edit your SMSSync configuration, simply click on the drop down icon on the right while on the data sources list page and make your changes.

For more details on how to manage messages within SMSSync, see configuration instructions on the SMSSync Website

Last updated