Platform User Manual
[Mzima] User Manual
[Mzima] User Manual
  • [Mzima] Ushahidi Platform User Manual
  • Navigating the Ushahidi Platform User Manual
  • Downloading the User Manual
  • Translating the User Manual
  • About Ushahidi
  • Overview of Ushahidi Platform [Mzima]
    • Technical Specifications
  • 1. Installing Ushahidi Platform
  • 2. Setting up a deployment
  • 3. Configuring your deployment
    • 3.1 Accessing your deployment
    • 3.2 General Settings
    • 3.3 Surveys
    • 3.4 Data Sources
      • 3.4.1 Email
      • 3.4.2 Gmail
      • 3.4.3 Vonage(formerly NextMo)
      • 3.4.4 SMSSync
      • 3.4.5 Twilio
      • 3.4.6 Twitter
      • 3.4.7 Africa's Talking
    • 3.5 Categories
  • 4. Managing People on your deployment
    • 4.1 Roles
    • 4.2 Users
  • 5. Modes for visualizing and managing data on your deployment
    • 5.1 Map View
    • 5.2 Data view
    • 5.3 Activity view
    • 5.4 Data managing functionalities shared among views
  • 6. Managing Data in your deployment
    • 6.1 Viewing Posts
    • 6.2 Filtering and Sorting Posts
    • 6.3 Adding Posts
    • 6.4 Editing Posts
    • 6.5 Translating Posts
    • 6.6 Publishing Posts
    • 6.7 Deleting Posts
    • Page
    • 6.8 Importing Data
    • 6.9 Exporting and Tagging Data
      • 6.9.1 Exporting Data
      • 6.9.2 Tagging Data - HDX integration
  • 7. Analysing Data on your deployment
    • Untitled
    • 7.1 Saved Searches
    • 7.2 Collections
  • 8. Additional Links
Powered by GitBook
On this page
Export as PDF
  1. 3. Configuring your deployment
  2. 3.4 Data Sources

3.4.3 Vonage(formerly NextMo)

Previous3.4.2 GmailNext3.4.4 SMSSync

Last updated 7 months ago

Vonage is a cloud-based SMS API that lets you send and receive a high volume of messages to mobile phones in any country at wholesale rates.

NB: You need a nexmo account to be able to configure this as a data source. To sign up, go to ()

To get started with Nexmo set up,

  • Log into your Vonage Dashboard

  • If you haven’t already, you’ll need to buy a number that you will use to receive SMS messages from.

    • Click on Numbers on the top menu bar on your Vonage dashboard

    • Click on Buy Numbers

    • Set the desired criteria of the phone number you’re looking to use

      • Select the country in which the SMS Number will likely be operating in

      • Select the features of this phone number(SMS only, Voice only or SMS & Voice)

      • Select the type of phone number it will be (Mobile, Landline, Toll free)

    • Click on search. A list of available numbers based on the criteria set above will appear.

  • Click Buy on the number you’d like to use.

  • Once you have a phone number, note it down as you’ll need it to configure your data source later on.

  • You’ll need to grab your API credentials from your nexmo settings page.

  • Pick your API KEY and API SECRET from the API Settings section.

  • Go back to your Data source settings page on your deployment

  • Click on the drop down icon on the right to get to your Nexmo configuration page

  • Enter the following details, which you got earlier from your Nexmo Dashboard

    • From: Enter the phone number you will use to receive SMS messages from your nexmo account

    • API KEY: Enter the API key retrieved from your nexmo settings page.

    • API SECRET: Enter the API secret retrieved from your nexmo settings page.

  • Click on Save **and this data source’s settings will be saved. Unstructured posts from SMS will now be pulled into the platform from Nexmo.

  • To enable/disable the Nexmo data source, simply click on the green toggle.

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

Nexmo setup for Ushahidi Platform SMS connectivity

Go to where you can set up the webhook. This is where we can make Nexmo aware of the existence of your Ushahidi deployment and help them connect with each other. Enter the sync URL i.e “ on the inbound SMS webhook field as shown below and save changes.

https://dashboard.nexmo.com/settings
https://yourdeploymentname.api.ushahidi.io/sms/nexmo”
https://dashboard.nexmo.com/sign-up
https://dashboard.nexmo.com
Click on numbers
Buy Number
Set desired criteria
Search for an available number to purchase
Click on your Profile
Click on settings
API settings
Data sources : Nexmo SMS provider.
Highlighted: Nexmo configuration in the Ushahidi datasource configuration page.
Toggle enabled to accept survey submissions from Nexmo.
Enter the URL to sync the two platforms
Data sources : Nexmo SMS provider.
Highlighted: Nexmo configuration in the Ushahidi datasource configuration page.
Toggle enabled to accept survey submissions from Nexmo.
Buy Number
Set desired criteria
Enter the URL to sync the two platforms
API settings