Magpi Sync

Similar to SMS sync, Magpi Sync is Magpi's SMS forwarding app made to work as a local gateway. 


How it works 

Magpi Sync reduces SMS costs by downloading messages from your Magpi account and forwarding them to a number. Here are the steps involved:

  1. A number is assigned on your Magpi SMS settings. This number acts as a gateway and will be used to forward Magpi questions to other numbers.
  2. When Magpi's gateway app (installed on the gateway device) is turned on, the app downloads questions from your Magpi form in form of a message, through a working internet connection.
  3. The message is synced in your gateway device.
  4. The message is then forwarded to the number the form has been shared with as an SMS


Getting Started

Before getting started, ensure that you have these requirements:

  1. Messaging credits on your Magpi account
  2. An android device which should run the gateway app
  3. Active GSM - The sim card in your gateway device must be connected to the network
  4. A working data connection on your gateway device
  5. Active airtime/SMS bundles on your gateway device


To get started, download Magpi's Structured SMS gateway app here.  


Note: This app is only available in the Android Platform.


Setting up your Local Gateway


These steps will guide you in setting up Magpi Sync on your gateway device.

  1. First, ensure that you have set up your iSMS gateway in your SMS settings screen on the website. To set up, Navigate to your account settings by Selecting your username, and then go to the 'SMS' View.
  2. Install Magpi Sync on the phone that will be used as the Local gateway.
  3. Log in to the app with the same credentials you configured your SMS settings on the website. On log in, the website's settings are automatically picked up by the app, so no further configuration is required.
  4. When the app is open, select the options menu at the top left of the app and go to Settings.
  5. In the settings screen, Turn on structured SMS endpoint and Enable Sync Service . Under other Settings, enter the number in your local gateway as the 'Unique Device ID' . This should match the number your entered in step 1.    


  6. Save the setting.


If the settings are correct, you should get a response 'Integration test passed'  from the server each time you select the 'SAVE SETTINGS' button.


The next step after this is to initiate your SMS session by sharing your form with the destination number. The first time you initiate a session, a pop up will appear on your screen asking you to allow SMSsync to send and view mesages. Select 'Allow'


You're all set. On initiating the session, your survey's questions will be sent to the destination number through the gateway number. On replying to the gateway number, the messages are then uploaded to Magpi Server by the app.