DiterionLabs.USSD 1.0.3

Diterion Labs USSD Library

Usage

1. Have a redis connection string in your appsettings.json with name Redis

2. Register the USSD dependences in your Startup.cs

builder.Services.AddUSSDMenus();

3. In your controller, inject the USSDService and call the ProccessRequest<InitialMenu>() function in your controller action

[Route("api/ussd")]
[ApiController]
public class USSDController : ControllerBase
{
    private readonly USSDService _ussdService;
    public USSDController(USSDService ussdService) =>
        _ussdService = ussdService;    

    [HttpGet]
    public async Task Index([FromQuery] USSDRequest request) => 
        await _ussdService.ProcessRequest<InitialMenu>(request);
}

Creating Menus

Menus should have a [USSDMenu] attribute and implement the IUSSDMenu interface.

[USSDMenu]
public class InitialMenu : IUSSDMenu
{
    public async Task DisplayAsync(USSDRequest request)
    {
        // Implement logic
    }

    public async Task ProcessInputAsync(USSDRequest request)
    {
        // Implement logic
    }
}

To implement the DisplayAsync and the ProcessInputAsync, you can make use of the IUSSDMenuBuilder which can be injected in the menu class

[USSDMenu]
public class InitialMenu : IUSSDMenu
{
    private readonly IUSSDMenuBuilder _builder;
    public InitialMenu(IUSSDMenuBuilder builder) => 
        _builder = builder;

    public async Task DisplayAsync(USSDRequest request)
    {
        // Implement logic
    }

    public async Task ProcessInputAsync(USSDRequest request)
    {
        // Implement logic
    }
}