SMS Provider Setup

NEMO/ELMO needs to be synced with an SMS provider in order to use the SMS feature. Three options are available:

FrontlineSMS

You can turn your Android smartphone or tablet into a gateway using FrontlineSMS. For this you need to sign up for a FrontlineCloud account.

Synchronize FrontlineSMS with your Android device

  1. Download FrontlineSync from the Play Store.
  2. Open FrontlineSync app from your Android device.
  3. Enter your FrontlineCloud email and password and press CONNECT.
  4. Make sure Send messages using this Androis and Upload incoming messages from FrontlineSync are checked then press UPDATE.
  5. Then press DONE! START USING FRONTLINESYNC.

To test your setup:

  1. Open your FrontlineCloud account.
  2. Click settings on the top right then click Connections to mobile networks.

You should now be able to see the device you have previously set up.

Configure connections

Note

For more details check Frontline documentation.

Synchronize FrontlineSMS with NEMO/ELMO

Now that you have synchronized your Android device with FrontlineCloud, you will need to synchronize FrontlineCloud with NEMO/ELMO.

Set up a new activity

  1. On FrontlineCloud click Activities.
  2. Click Create an Activity.
  3. Select Forward to URL.
  4. Type a name for your activity.
  5. Select All inbound SMS.
  6. To get the Target URL, get back to your NEMO/ELMO mission, click Settings then in the Incoming SMS Token section click How do I use this? and copy the URL that shows up in the dialog.
  7. Make sure HTTP Method is set to POST.
  8. Now set the following key-value pairs:
Key Value
from ${trigger.sourceNumber}
frontlinecloud 1
sent_at ${trigger.date.time}
body ${trigger.text}
  1. Click Save.
Frontline NEMO/ELMO config

Generate an API Key

  1. Click settings on the top right then click API web services and Integrations.
  2. Click Connect a web service.
  3. Select Connect an external web service to your workspace.
  4. Enter a name for the web service.

A new row will appear on the screen with an API Key in the Details. We will need this API Key for the next step.

NEMO/ELMO setup

  1. Click Settings menu.
  2. Add the SIM card number to the Incoming Number(s) field. If adding more than one number, separate the numbers with a comma.
  3. Set Default Outgoing Provider to FrontlineCloud.
  4. In FrontlineCloud Settings click Change API Key.
  5. Paste the API Key that you previously generated in FrontlineCloud.

Twilio

If you are using Twilio as your SMS provider you need to set the following settings:

Twilio settings

Once you have created your Twilio account you will need to:

Create a new Twilio project

To create a new Twilio project:

  1. Click on the top left menu .
  2. Select Create New Project.
Create a new Twilio project
  1. Select Products then choose Programmable SMS.
  2. Click Continue.

Set up a Twilio phone number

  1. Click on the left navigation to see the list of products and services.
  2. Select Phone Numbers.
Create a new phone number
  1. Once in the Phone Numbers menu, you have three options:
  • Get a free number from Twilio by going to Getting Started section.
  • Buy a Twilio Number by going to Buy a Number section.
  • Use your own Number by going to Use Your Number section.

Create a new Messaging service

You need to create a new messaging service in order to forward all incoming SMSes to NEMO/ELMO, for this:

  1. Click Programmable SMS on the left navigation.
  2. Click SMS on the left menu.
  3. Click to create a new messaging service.
  4. Choose a name for the service and set the use case to Mixed.
  5. Click Create.
  6. Under Inbound Settings, check PROCESS INBOUND MESSAGES.
  7. To get the REQUEST URL, get back to your NEMO/ELMO mission, click Settings then in the Incoming SMS Token section click How do I use this? and copy the URL that shows up in the dialog.
  8. Under Outbound Settings, set STATUS CALLBACK URL with the same URL used in the previous step.

At the end you should have a configuration similar to this one:

Programmable SMS Configuration
  1. Click Save.
  2. Now you need to add a number to this messaging service, for this, Click Numbers on the left menu.
  3. Click to add a number.

NEMO/ELMO setup for Twilio

In your NEMO/ELMO mission:

  1. Click Settings.
  2. Add the phone number from which you will receive SMSes to Incoming Number(s) field. If adding more than one number, separate the numbers with a comma.
  3. Make sure the Default Outgoing Provider: is set to Twilio.
  4. Scroll down to Twilio Settings section, set the Outgoing Number which is the phone number registered with Twilio. SMS replies and Outgoing SMS broadcasts won’t work unless this number is owned by your Twilio account. This number must include the country code. Example: +25680344523.
  5. Set the Account SID for your twilio account.
  6. Click Change Auth Token to change the auth token for the Twilio account.
  7. Click Save.

Generic SMS Adapter Settings

If you are using a provider other than Twilio and FrontlineSMS you will need to set up a Generic SMS Adapter.

  1. Click Settings on your NEMO/ELMO mission.
  2. Make sure the Default Outgoing Provider: is set to none.
  3. In Generic SMS Adapter Settings set a JSON formatted configuration string for the generic adapter. Example :
{
  "params": {
    "from": "num",
    "body": "msg"
  },
  "response": "<message>%{reply}</message>"
}