Skip to content

Latest commit

 

History

History
62 lines (56 loc) · 1.93 KB

README.md

File metadata and controls

62 lines (56 loc) · 1.93 KB
Raw

AT-USSD

AT-USSD background

Setup

1. AT Developers account

  1. Create your AT developer account
  2. Login to AT developer account
  3. Go to Sandbox App

2. Running apps locally

Clone the repo and navigate into it

git clone git@github.com:DanNduati/AT-USSD.git
cd at-ussd/

Install dependecies

pip install -r requirements.txt

Run the application

I've implemented the application logic with 2 web frameworks Flask and FastAPI you can select either.

  1. Flask
Navigate to app directory
cd flask_app/
Start server
python app .py
  1. FastAPI
Navigate to app directory
cd fastapi_app/
Start server
uvicorn main:app --reload

3. Port forwading with ngrok

ngrok http <port number>

4. Create a USSD service code

  1. Create a new USSD channel The following information is needed to create the channel:
    • Service code this is shared by default : *384#
    • Channel this is a unique number appended to the service code to differentiate your app from other apps eg: 069
    • Callback URL this is a public address that is invoked by the AT API when a subscriber dails the ussd code use the exposed ngrok public url In my case the service code is: *384*069#

Outcome

Todo

  • Improve menu logic and navigation
  • Add mpesa STK-Push
  • Improve exception handling