platform-api-ussd-service's Introduction

description
Ushahidi Platform USSD Service Summary.

Introduction

USSD, which stands for Unstructured Supplementary Services Data, is a protocol that allows for the transmission of information via a GSM network.

Users enter a USSD string and press call to send the message. A typical USSD message starts with a * followed by digits which indicate an action to be performed or are parameters. Each group of numbers is separated by a *, and the message is terminated with a #.

For example, in Kenya, to find out what your airtime balance is on Safaricom, a user will dial *144#. Unlike SMS, USSD messages create a real-time connection during a session, that remains open, allowing a two-way exchange of a sequence of data.

This documentation explains details about a service that allows for users to send in reports to ushahidi deployments via USSD on Ushahidi v3.

{% embed url="https://drive.google.com/open?id=1-3LGJRNMH1Qi9ZAdconb3raRmPR4UzNE" caption="Ushahidi Platform USSD Service Demo" %}

Source codes for the Ushahidi Platform API USSD Service is available here on GitHub.__

You can read about My Google Summer of Code Experience (GSoC) with Ushahidi****

platform-api-ussd-service's Issues

Add USSD Field Response Validators

Add USSD Field Response Validations - and return messages to users on invalid responses.

Implement and Fix Ushahidi Deployment Credentials

Ensure that after deploying the USSD Microservice.
Users can pass their Ushahidi's deployment PLATFORM_API, PLATFORM_EMAIL & PLATFORM_PASSWORD
This enables the service to fetch all surveys, display fields and post responses to that deployment.

Add Validation checks for inputs based on types

Add Validation check if user input matches the input type.

Input types: 'text', 'textarea', 'location', 'number', 'date', 'datetime', 'select', 'radio', 'checkbox'

https://pypi.org/project/validation/

Implement Location Geocoding for Location Fields

Implement Location Geocoding to get coordinates off user typed location.

Resolve Request Issue

@Timtech4u It looks like CloudFront is configured not to accept the request ... but I can't really say the reason for that. I am guessing you are not using CloudFront directly but heroku?

Originally posted by @tuxpiper in #1 (comment)